@superdoc-dev/sdk 1.8.0-next.6 → 1.8.0-next.60

package/dist/generated/contract.cjs

@@ -102,7 +102,7 @@ const CONTRACT = {
                 "find"
             ],
             "category": "core",
-            "description": "Search the document for text or node matches using SDM/1 selectors. Returns discovery-grade results — for mutation targeting, use query.match instead.",
+            "description": "Search the document for text or node matches using SDM/1 selectors. Returns discovery-grade results: for mutation targeting, use query.match instead.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -2013,7 +2013,7 @@ const CONTRACT = {
                 "extract"
             ],
             "category": "core",
-            "description": "Extract all document content with stable IDs for RAG pipelines. Returns blocks with full text, comments, and tracked changes — each with an ID compatible with scrollToElement().",
+            "description": "Extract all document content with stable IDs for RAG pipelines. Returns blocks with full text, comments, and tracked changes: each with an ID compatible with scrollToElement().",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": null,
@@ -2052,7 +2052,7 @@ const CONTRACT = {
                             "properties": {
                                 "nodeId": {
                                     "type": "string",
-                                    "description": "Stable block ID — pass to scrollToElement() for navigation."
+                                    "description": "Stable block ID: pass to scrollToElement() for navigation."
                                 },
                                 "type": {
                                     "type": "string",
@@ -2062,9 +2062,52 @@ const CONTRACT = {
                                     "type": "string",
                                     "description": "Full plain text content of the block."
                                 },
+                                "textSpans": {
+                                    "type": "array",
+                                    "description": "Block text broken into runs with tracked-change marks preserved per run. Present only when the block contains at least one tracked change. Concatenating span text yields `text`.",
+                                    "items": {
+                                        "type": "object",
+                                        "properties": {
+                                            "text": {
+                                                "type": "string",
+                                                "description": "Raw text of the run."
+                                            },
+                                            "trackedChanges": {
+                                                "type": "array",
+                                                "description": "Tracked-change marks applied to this run.",
+                                                "items": {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "entityId": {
+                                                            "type": "string",
+                                                            "description": "Tracked change entity ID matching an entry in trackedChanges[]."
+                                                        },
+                                                        "type": {
+                                                            "type": "string",
+                                                            "enum": [
+                                                                "insert",
+                                                                "delete",
+                                                                "format"
+                                                            ]
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "entityId",
+                                                        "type"
+                                                    ]
+                                                }
+                                            }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                            "text"
+                                        ]
+                                    }
+                                },
                                 "headingLevel": {
                                     "type": "integer",
-                                    "description": "Heading level (1–6). Only present for headings."
+                                    "description": "Heading level (1-6). Only present for headings."
                                 },
                                 "tableContext": {
                                     "type": "object",
@@ -2127,7 +2170,7 @@ const CONTRACT = {
                             "properties": {
                                 "entityId": {
                                     "type": "string",
-                                    "description": "Comment entity ID — pass to scrollToElement() for navigation."
+                                    "description": "Comment entity ID: pass to scrollToElement() for navigation."
                                 },
                                 "text": {
                                     "type": "string",
@@ -2167,7 +2210,7 @@ const CONTRACT = {
                             "properties": {
                                 "entityId": {
                                     "type": "string",
-                                    "description": "Tracked change entity ID — pass to scrollToElement() for navigation."
+                                    "description": "Tracked change entity ID. Pass to scrollToElement() for navigation."
                                 },
                                 "type": {
                                     "type": "string",
@@ -2175,11 +2218,37 @@ const CONTRACT = {
                                         "insert",
                                         "delete",
                                         "format"
-                                    ]
+                                    ],
+                                    "description": "Aggregate type at the entity level. In paired replacement mode, a delete+insert pair shares one entity and this collapses to 'insert'; per-half type lives on block.textSpans[].trackedChanges[]."
+                                },
+                                "blockIds": {
+                                    "type": "array",
+                                    "description": "Block IDs whose textSpans carry this change.",
+                                    "items": {
+                                        "type": "string"
+                                    }
+                                },
+                                "wordRevisionIds": {
+                                    "type": "object",
+                                    "properties": {
+                                        "insert": {
+                                            "type": "string",
+                                            "description": "Original OOXML w:id from a w:ins mark."
+                                        },
+                                        "delete": {
+                                            "type": "string",
+                                            "description": "Original OOXML w:id from a w:del mark."
+                                        },
+                                        "format": {
+                                            "type": "string",
+                                            "description": "Original OOXML w:id from a w:rPrChange mark."
+                                        }
+                                    },
+                                    "additionalProperties": false
                                 },
                                 "excerpt": {
                                     "type": "string",
-                                    "description": "Short text excerpt of the changed content."
+                                    "description": "Short text excerpt of the changed content. Omitted for paired replacements; read block.textSpans for the per-half text."
                                 },
                                 "author": {
                                     "type": "string",
@@ -33708,7 +33777,7 @@ const CONTRACT = {
                     "name": "text",
                     "kind": "flag",
                     "type": "string",
-                    "description": "Paragraph text content. Each call creates ONE paragraph. For multiple items (e.g. list items), call superdoc_create separately for each item — do NOT use newlines to put multiple items in one paragraph."
+                    "description": "Paragraph text content. Each call creates ONE paragraph. For multiple items (e.g. list items), call superdoc_create separately for each item: do NOT use newlines to put multiple items in one paragraph."
                 },
                 {
                     "name": "input",
@@ -33792,7 +33861,7 @@ const CONTRACT = {
                     },
                     "text": {
                         "type": "string",
-                        "description": "Paragraph text content. Each call creates ONE paragraph. For multiple items (e.g. list items), call superdoc_create separately for each item — do NOT use newlines to put multiple items in one paragraph."
+                        "description": "Paragraph text content. Each call creates ONE paragraph. For multiple items (e.g. list items), call superdoc_create separately for each item: do NOT use newlines to put multiple items in one paragraph."
                     }
                 },
                 "additionalProperties": false
@@ -50131,7 +50200,7 @@ const CONTRACT = {
                 "create"
             ],
             "category": "lists",
-            "description": "Create a new list from one or more paragraphs. Supports optional preset or style for new sequences. When sequence.mode is \"continuePrevious\", preset and style are not allowed — the new items inherit formatting from the previous sequence.",
+            "description": "Create a new list from one or more paragraphs. Supports optional preset or style for new sequences. When sequence.mode is \"continuePrevious\", preset and style are not allowed: the new items inherit formatting from the previous sequence.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -50201,9 +50270,9 @@ const CONTRACT = {
                                 "const": "fromParagraphs"
                             }
                         ],
-                        "description": "Required. 'fromParagraphs' converts existing paragraphs into list items — each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
+                        "description": "Required. 'fromParagraphs' converts existing paragraphs into list items: each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
                     },
-                    "description": "Required. 'fromParagraphs' converts existing paragraphs into list items — each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
+                    "description": "Required. 'fromParagraphs' converts existing paragraphs into list items: each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
                 },
                 {
                     "name": "at",
@@ -50518,7 +50587,7 @@ const CONTRACT = {
                             "empty",
                             "fromParagraphs"
                         ],
-                        "description": "Required. 'fromParagraphs' converts existing paragraphs into list items — each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
+                        "description": "Required. 'fromParagraphs' converts existing paragraphs into list items: each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
                     },
                     "at": {
                         "$ref": "#/$defs/BlockAddress",
@@ -52465,7 +52534,7 @@ const CONTRACT = {
                 "merge"
             ],
             "category": "lists",
-            "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.",
+            "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": null,
@@ -58620,7 +58689,7 @@ const CONTRACT = {
                 "set-level-number-style"
             ],
             "category": "lists",
-            "description": "Set the numbering style (e.g. decimal, lowerLetter, upperRoman) for a specific list level. Rejects \"bullet\" — use setLevelBullet instead. Sequence-local: clones shared definitions.",
+            "description": "Set the numbering style (e.g. decimal, lowerLetter, upperRoman) for a specific list level. Rejects \"bullet\": use setLevelBullet instead. Sequence-local: clones shared definitions.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": null,
@@ -59346,7 +59415,7 @@ const CONTRACT = {
                 "set-level-layout"
             ],
             "category": "lists",
-            "description": "Set the layout properties (alignment, indentation, trailing character, tab stop) for a specific list level. Accepts partial updates — omitted fields are left unchanged. Sequence-local: clones shared definitions.",
+            "description": "Set the layout properties (alignment, indentation, trailing character, tab stop) for a specific list level. Accepts partial updates: omitted fields are left unchanged. Sequence-local: clones shared definitions.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": null,
@@ -59786,6 +59855,162 @@ const CONTRACT = {
                                                 "range"
                                             ]
                                         }
+                                    },
+                                    "story": {
+                                        "oneOf": [
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "body"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "headerFooterSlot"
+                                                    },
+                                                    "section": {
+                                                        "type": "object",
+                                                        "properties": {
+                                                            "kind": {
+                                                                "const": "section"
+                                                            },
+                                                            "sectionId": {
+                                                                "type": "string"
+                                                            }
+                                                        },
+                                                        "required": [
+                                                            "kind",
+                                                            "sectionId"
+                                                        ]
+                                                    },
+                                                    "headerFooterKind": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "header"
+                                                            },
+                                                            {
+                                                                "const": "footer"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "variant": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "default"
+                                                            },
+                                                            {
+                                                                "const": "first"
+                                                            },
+                                                            {
+                                                                "const": "even"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "resolution": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "effective"
+                                                            },
+                                                            {
+                                                                "const": "explicit"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "onWrite": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "materializeIfInherited"
+                                                            },
+                                                            {
+                                                                "const": "editResolvedPart"
+                                                            },
+                                                            {
+                                                                "const": "error"
+                                                            }
+                                                        ]
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "section",
+                                                    "headerFooterKind",
+                                                    "variant"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "headerFooterPart"
+                                                    },
+                                                    "refId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "refId"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "footnote"
+                                                    },
+                                                    "noteId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "noteId"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "endnote"
+                                                    },
+                                                    "noteId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "noteId"
+                                                ]
+                                            }
+                                        ],
+                                        "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                                     }
                                 },
                                 "required": [
@@ -60055,11 +60280,14 @@ const CONTRACT = {
                         "oneOf": [
                             {
                                 "const": "resolved"
+                            },
+                            {
+                                "const": "active"
                             }
                         ],
-                        "description": "Set comment status. Use 'resolved' to mark as resolved."
+                        "description": "Set comment status. Use 'resolved' to resolve a comment, or 'active' to reopen a previously resolved comment (lifecycle inverse)."
                     },
-                    "description": "Set comment status. Use 'resolved' to mark as resolved."
+                    "description": "Set comment status. Use 'resolved' to resolve a comment, or 'active' to reopen a previously resolved comment (lifecycle inverse)."
                 },
                 {
                     "name": "isInternal",
@@ -60111,9 +60339,10 @@ const CONTRACT = {
                     },
                     "status": {
                         "enum": [
-                            "resolved"
+                            "resolved",
+                            "active"
                         ],
-                        "description": "Set comment status. Use 'resolved' to mark as resolved."
+                        "description": "Set comment status. Use 'resolved' to resolve a comment, or 'active' to reopen a previously resolved comment (lifecycle inverse)."
                     },
                     "isInternal": {
                         "type": "boolean",
@@ -63009,6 +63238,18 @@ const CONTRACT = {
                             "type": "string"
                         }
                     },
+                    "activeCommentIds": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "activeChangeIds": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
                     "text": {
                         "type": "string"
                     }
@@ -63017,7 +63258,9 @@ const CONTRACT = {
                 "required": [
                     "empty",
                     "target",
-                    "activeMarks"
+                    "activeMarks",
+                    "activeCommentIds",
+                    "activeChangeIds"
                 ]
             }
         },
@@ -131351,6 +131594,170 @@ const CONTRACT = {
                     "name": "offset",
                     "kind": "flag",
                     "type": "number"
+                },
+                {
+                    "name": "in",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "in-json",
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "body"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "headerFooterSlot"
+                                    },
+                                    "section": {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "section"
+                                            },
+                                            "sectionId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "sectionId"
+                                        ]
+                                    },
+                                    "headerFooterKind": {
+                                        "oneOf": [
+                                            {
+                                                "const": "header"
+                                            },
+                                            {
+                                                "const": "footer"
+                                            }
+                                        ]
+                                    },
+                                    "variant": {
+                                        "oneOf": [
+                                            {
+                                                "const": "default"
+                                            },
+                                            {
+                                                "const": "first"
+                                            },
+                                            {
+                                                "const": "even"
+                                            }
+                                        ]
+                                    },
+                                    "resolution": {
+                                        "oneOf": [
+                                            {
+                                                "const": "effective"
+                                            },
+                                            {
+                                                "const": "explicit"
+                                            }
+                                        ]
+                                    },
+                                    "onWrite": {
+                                        "oneOf": [
+                                            {
+                                                "const": "materializeIfInherited"
+                                            },
+                                            {
+                                                "const": "editResolvedPart"
+                                            },
+                                            {
+                                                "const": "error"
+                                            }
+                                        ]
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "section",
+                                    "headerFooterKind",
+                                    "variant"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "headerFooterPart"
+                                    },
+                                    "refId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "refId"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "footnote"
+                                    },
+                                    "noteId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "noteId"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "endnote"
+                                    },
+                                    "noteId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "noteId"
+                                ]
+                            }
+                        ],
+                        "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
+                    },
+                    "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes.",
+                    "agentVisible": false
                 }
             ],
             "constraints": null,
@@ -131368,6 +131775,9 @@ const CONTRACT = {
                     "offset": {
                         "type": "integer",
                         "minimum": 0
+                    },
+                    "in": {
+                        "$ref": "#/$defs/StoryLocator"
                     }
                 },
                 "additionalProperties": false
@@ -131420,6 +131830,162 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -131449,6 +132015,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131581,6 +132150,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -131667,6 +132392,9 @@ const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -131732,6 +132460,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131862,6 +132593,162 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -131898,6 +132785,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131936,6 +132826,9 @@ const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -132001,6 +132894,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132131,6 +133027,162 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -132160,6 +133212,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132194,6 +133249,9 @@ const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -132259,6 +133317,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132585,6 +133646,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -133973,6 +135190,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -136849,6 +138222,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -139252,6 +140781,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -140279,6 +141964,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [
@@ -145574,6 +147415,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
                             }
                         },
                         "required": [