@superdoc-dev/sdk 1.6.0-next.5 → 1.6.0-next.50

package/dist/generated/contract.cjs

@@ -2056,7 +2056,7 @@ const CONTRACT = {
                                 },
                                 "type": {
                                     "type": "string",
-                                    "description": "Block type: paragraph, heading, listItem, table, image, etc."
+                                    "description": "Block type: paragraph, heading, listItem, image, tableOfContents."
                                 },
                                 "text": {
                                     "type": "string",
@@ -2065,6 +2065,51 @@ const CONTRACT = {
                                 "headingLevel": {
                                     "type": "integer",
                                     "description": "Heading level (1–6). Only present for headings."
+                                },
+                                "tableContext": {
+                                    "type": "object",
+                                    "properties": {
+                                        "tableOrdinal": {
+                                            "type": "integer",
+                                            "description": "0-based table ordinal, unique within one extract() result."
+                                        },
+                                        "parentTableOrdinal": {
+                                            "type": "integer",
+                                            "description": "Ordinal of the parent table when the containing table is nested."
+                                        },
+                                        "parentRowIndex": {
+                                            "type": "integer",
+                                            "description": "Row index in the parent table. Set with parentTableOrdinal."
+                                        },
+                                        "parentColumnIndex": {
+                                            "type": "integer",
+                                            "description": "Column index in the parent table. Set with parentTableOrdinal."
+                                        },
+                                        "rowIndex": {
+                                            "type": "integer",
+                                            "description": "0-based row index of the containing cell."
+                                        },
+                                        "columnIndex": {
+                                            "type": "integer",
+                                            "description": "0-based logical grid column, not the row child order."
+                                        },
+                                        "rowspan": {
+                                            "type": "integer",
+                                            "description": "Number of rows the cell spans."
+                                        },
+                                        "colspan": {
+                                            "type": "integer",
+                                            "description": "Number of columns the cell spans."
+                                        }
+                                    },
+                                    "additionalProperties": false,
+                                    "required": [
+                                        "tableOrdinal",
+                                        "rowIndex",
+                                        "columnIndex",
+                                        "rowspan",
+                                        "colspan"
+                                    ]
                                 }
                             },
                             "additionalProperties": false,
@@ -5142,7 +5187,7 @@ const CONTRACT = {
                 "list"
             ],
             "category": "core",
-            "description": "List top-level blocks in document order with IDs, types, and text previews. Supports pagination via offset/limit and optional nodeType filtering.",
+            "description": "List top-level blocks in document order with IDs, types, text previews, and optional full text when includeText:true. Supports pagination via offset/limit and optional nodeType filtering.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -5213,6 +5258,13 @@ const CONTRACT = {
                         "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
                     },
                     "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
+                },
+                {
+                    "name": "includeText",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "include-text",
+                    "description": "When true, includes the full flattened block text in each block entry."
                 }
             ],
             "constraints": null,
@@ -5249,6 +5301,10 @@ const CONTRACT = {
                             ]
                         },
                         "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
+                    },
+                    "includeText": {
+                        "type": "boolean",
+                        "description": "When true, includes the full flattened block text in each block entry."
                     }
                 },
                 "additionalProperties": false
@@ -5294,6 +5350,17 @@ const CONTRACT = {
                                         }
                                     ]
                                 },
+                                "text": {
+                                    "oneOf": [
+                                        {
+                                            "type": "string"
+                                        },
+                                        {
+                                            "type": "null"
+                                        }
+                                    ],
+                                    "description": "Full flattened block text when requested with includeText."
+                                },
                                 "isEmpty": {
                                     "type": "boolean"
                                 },
@@ -60049,6 +60116,178 @@ const CONTRACT = {
                         "description": "Filter by change type: 'insert', 'delete', or 'format'."
                     },
                     "description": "Filter by change type: 'insert', 'delete', or 'format'."
+                },
+                {
+                    "name": "in",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "in-json",
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "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."
+                            },
+                            {
+                                "const": "all"
+                            }
+                        ],
+                        "description": "Story scope. Omit for body only, pass a StoryLocator for a single story, or 'all' for body + every revision-capable non-body story."
+                    },
+                    "description": "Story scope. Omit for body only, pass a StoryLocator for a single story, or 'all' for body + every revision-capable non-body story.",
+                    "agentVisible": false
                 }
             ],
             "constraints": null,
@@ -60074,6 +60313,17 @@ const CONTRACT = {
                             "format"
                         ],
                         "description": "Filter by change type: 'insert', 'delete', or 'format'."
+                    },
+                    "in": {
+                        "oneOf": [
+                            {
+                                "$ref": "#/$defs/StoryLocator"
+                            },
+                            {
+                                "const": "all"
+                            }
+                        ],
+                        "description": "Story scope. Omit for body only, pass a StoryLocator for a single story, or 'all' for body + every revision-capable non-body story."
                     }
                 },
                 "additionalProperties": false
@@ -60200,6 +60450,169 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "required": true
+                },
+                {
+                    "name": "story",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "story-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."
                 }
             ],
             "constraints": null,
@@ -60212,6 +60625,9 @@ const CONTRACT = {
                 "properties": {
                     "id": {
                         "type": "string"
+                    },
+                    "story": {
+                        "$ref": "#/$defs/StoryLocator"
                     }
                 },
                 "additionalProperties": false,
@@ -60366,6 +60782,162 @@ const CONTRACT = {
                                 "properties": {
                                     "id": {
                                         "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": [
@@ -60412,6 +60984,9 @@ const CONTRACT = {
                                 "properties": {
                                     "id": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -62506,6 +63081,53 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block"
+                                                        },
+                                                        "nodeType": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "paragraph"
+                                                                },
+                                                                {
+                                                                    "const": "heading"
+                                                                },
+                                                                {
+                                                                    "const": "listItem"
+                                                                },
+                                                                {
+                                                                    "const": "table"
+                                                                },
+                                                                {
+                                                                    "const": "tableRow"
+                                                                },
+                                                                {
+                                                                    "const": "tableCell"
+                                                                },
+                                                                {
+                                                                    "const": "tableOfContents"
+                                                                },
+                                                                {
+                                                                    "const": "image"
+                                                                },
+                                                                {
+                                                                    "const": "sdt"
+                                                                }
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -62701,51 +63323,148 @@ const CONTRACT = {
                                             "const": "text.insert"
                                         },
                                         "where": {
-                                            "type": "object",
-                                            "properties": {
-                                                "by": {
-                                                    "const": "select"
-                                                },
-                                                "select": {
-                                                    "oneOf": [
-                                                        {
-                                                            "type": "object",
-                                                            "properties": {
-                                                                "type": {
-                                                                    "const": "text",
-                                                                    "description": "Must be 'text' for text pattern search."
-                                                                },
-                                                                "pattern": {
-                                                                    "type": "string",
-                                                                    "description": "Text or regex pattern to match."
-                                                                },
-                                                                "mode": {
-                                                                    "oneOf": [
-                                                                        {
-                                                                            "const": "contains"
+                                            "oneOf": [
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "select"
+                                                        },
+                                                        "select": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "text",
+                                                                            "description": "Must be 'text' for text pattern search."
                                                                         },
-                                                                        {
-                                                                            "const": "regex"
+                                                                        "pattern": {
+                                                                            "type": "string",
+                                                                            "description": "Text or regex pattern to match."
+                                                                        },
+                                                                        "mode": {
+                                                                            "oneOf": [
+                                                                                {
+                                                                                    "const": "contains"
+                                                                                },
+                                                                                {
+                                                                                    "const": "regex"
+                                                                                }
+                                                                            ],
+                                                                            "description": "Match mode: 'contains' (substring) or 'regex'."
+                                                                        },
+                                                                        "caseSensitive": {
+                                                                            "type": "boolean",
+                                                                            "description": "Case-sensitive matching. Default: false."
                                                                         }
-                                                                    ],
-                                                                    "description": "Match mode: 'contains' (substring) or 'regex'."
+                                                                    },
+                                                                    "required": [
+                                                                        "type",
+                                                                        "pattern"
+                                                                    ]
                                                                 },
-                                                                "caseSensitive": {
-                                                                    "type": "boolean",
-                                                                    "description": "Case-sensitive matching. Default: false."
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "node",
+                                                                            "description": "Must be 'node' for node type search."
+                                                                        },
+                                                                        "nodeType": {
+                                                                            "oneOf": [
+                                                                                {
+                                                                                    "const": "paragraph"
+                                                                                },
+                                                                                {
+                                                                                    "const": "heading"
+                                                                                },
+                                                                                {
+                                                                                    "const": "listItem"
+                                                                                },
+                                                                                {
+                                                                                    "const": "table"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tableRow"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tableCell"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tableOfContents"
+                                                                                },
+                                                                                {
+                                                                                    "const": "image"
+                                                                                },
+                                                                                {
+                                                                                    "const": "sdt"
+                                                                                },
+                                                                                {
+                                                                                    "const": "run"
+                                                                                },
+                                                                                {
+                                                                                    "const": "bookmark"
+                                                                                },
+                                                                                {
+                                                                                    "const": "comment"
+                                                                                },
+                                                                                {
+                                                                                    "const": "hyperlink"
+                                                                                },
+                                                                                {
+                                                                                    "const": "footnoteRef"
+                                                                                },
+                                                                                {
+                                                                                    "const": "endnoteRef"
+                                                                                },
+                                                                                {
+                                                                                    "const": "crossRef"
+                                                                                },
+                                                                                {
+                                                                                    "const": "indexEntry"
+                                                                                },
+                                                                                {
+                                                                                    "const": "citation"
+                                                                                },
+                                                                                {
+                                                                                    "const": "authorityEntry"
+                                                                                },
+                                                                                {
+                                                                                    "const": "sequenceField"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tab"
+                                                                                },
+                                                                                {
+                                                                                    "const": "lineBreak"
+                                                                                }
+                                                                            ],
+                                                                            "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
+                                                                        },
+                                                                        "kind": {
+                                                                            "oneOf": [
+                                                                                {
+                                                                                    "const": "block"
+                                                                                },
+                                                                                {
+                                                                                    "const": "inline"
+                                                                                }
+                                                                            ],
+                                                                            "description": "Filter: 'block' or 'inline'."
+                                                                        }
+                                                                    },
+                                                                    "required": [
+                                                                        "type"
+                                                                    ]
                                                                 }
-                                                            },
-                                                            "required": [
-                                                                "type",
-                                                                "pattern"
                                                             ]
                                                         },
-                                                        {
+                                                        "within": {
                                                             "type": "object",
                                                             "properties": {
-                                                                "type": {
-                                                                    "const": "node",
-                                                                    "description": "Must be 'node' for node type search."
+                                                                "kind": {
+                                                                    "const": "block"
                                                                 },
                                                                 "nodeType": {
                                                                     "oneOf": [
@@ -62775,71 +63494,297 @@ const CONTRACT = {
                                                                         },
                                                                         {
                                                                             "const": "sdt"
-                                                                        },
-                                                                        {
-                                                                            "const": "run"
-                                                                        },
-                                                                        {
-                                                                            "const": "bookmark"
-                                                                        },
+                                                                        }
+                                                                    ]
+                                                                },
+                                                                "nodeId": {
+                                                                    "type": "string"
+                                                                }
+                                                            },
+                                                            "required": [
+                                                                "kind",
+                                                                "nodeType",
+                                                                "nodeId"
+                                                            ]
+                                                        },
+                                                        "require": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "first"
+                                                                },
+                                                                {
+                                                                    "const": "exactlyOne"
+                                                                }
+                                                            ]
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "select",
+                                                        "require"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "ref"
+                                                        },
+                                                        "ref": {
+                                                            "type": "string"
+                                                        },
+                                                        "within": {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "kind": {
+                                                                    "const": "block"
+                                                                },
+                                                                "nodeType": {
+                                                                    "oneOf": [
                                                                         {
-                                                                            "const": "comment"
+                                                                            "const": "paragraph"
                                                                         },
                                                                         {
-                                                                            "const": "hyperlink"
+                                                                            "const": "heading"
                                                                         },
                                                                         {
-                                                                            "const": "footnoteRef"
+                                                                            "const": "listItem"
                                                                         },
                                                                         {
-                                                                            "const": "endnoteRef"
+                                                                            "const": "table"
                                                                         },
                                                                         {
-                                                                            "const": "crossRef"
+                                                                            "const": "tableRow"
                                                                         },
                                                                         {
-                                                                            "const": "indexEntry"
+                                                                            "const": "tableCell"
                                                                         },
                                                                         {
-                                                                            "const": "citation"
+                                                                            "const": "tableOfContents"
                                                                         },
                                                                         {
-                                                                            "const": "authorityEntry"
+                                                                            "const": "image"
                                                                         },
                                                                         {
-                                                                            "const": "sequenceField"
-                                                                        },
+                                                                            "const": "sdt"
+                                                                        }
+                                                                    ]
+                                                                },
+                                                                "nodeId": {
+                                                                    "type": "string"
+                                                                }
+                                                            },
+                                                            "required": [
+                                                                "kind",
+                                                                "nodeType",
+                                                                "nodeId"
+                                                            ]
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "ref"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "target"
+                                                        },
+                                                        "target": {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "kind": {
+                                                                    "const": "selection"
+                                                                },
+                                                                "start": {
+                                                                    "oneOf": [
                                                                         {
-                                                                            "const": "tab"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "text"
+                                                                                },
+                                                                                "blockId": {
+                                                                                    "type": "string"
+                                                                                },
+                                                                                "offset": {
+                                                                                    "type": "number"
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "blockId",
+                                                                                "offset"
+                                                                            ]
                                                                         },
                                                                         {
-                                                                            "const": "lineBreak"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "nodeEdge"
+                                                                                },
+                                                                                "node": {
+                                                                                    "type": "object",
+                                                                                    "properties": {
+                                                                                        "kind": {
+                                                                                            "const": "block"
+                                                                                        },
+                                                                                        "nodeType": {
+                                                                                            "oneOf": [
+                                                                                                {
+                                                                                                    "const": "paragraph"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "heading"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "table"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "tableOfContents"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "sdt"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "image"
+                                                                                                }
+                                                                                            ]
+                                                                                        },
+                                                                                        "nodeId": {
+                                                                                            "type": "string"
+                                                                                        }
+                                                                                    },
+                                                                                    "required": [
+                                                                                        "kind",
+                                                                                        "nodeType",
+                                                                                        "nodeId"
+                                                                                    ]
+                                                                                },
+                                                                                "edge": {
+                                                                                    "oneOf": [
+                                                                                        {
+                                                                                            "const": "before"
+                                                                                        },
+                                                                                        {
+                                                                                            "const": "after"
+                                                                                        }
+                                                                                    ]
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "node",
+                                                                                "edge"
+                                                                            ]
                                                                         }
                                                                     ],
-                                                                    "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
+                                                                    "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
                                                                 },
-                                                                "kind": {
+                                                                "end": {
                                                                     "oneOf": [
                                                                         {
-                                                                            "const": "block"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "text"
+                                                                                },
+                                                                                "blockId": {
+                                                                                    "type": "string"
+                                                                                },
+                                                                                "offset": {
+                                                                                    "type": "number"
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "blockId",
+                                                                                "offset"
+                                                                            ]
                                                                         },
                                                                         {
-                                                                            "const": "inline"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "nodeEdge"
+                                                                                },
+                                                                                "node": {
+                                                                                    "type": "object",
+                                                                                    "properties": {
+                                                                                        "kind": {
+                                                                                            "const": "block"
+                                                                                        },
+                                                                                        "nodeType": {
+                                                                                            "oneOf": [
+                                                                                                {
+                                                                                                    "const": "paragraph"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "heading"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "table"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "tableOfContents"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "sdt"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "image"
+                                                                                                }
+                                                                                            ]
+                                                                                        },
+                                                                                        "nodeId": {
+                                                                                            "type": "string"
+                                                                                        }
+                                                                                    },
+                                                                                    "required": [
+                                                                                        "kind",
+                                                                                        "nodeType",
+                                                                                        "nodeId"
+                                                                                    ]
+                                                                                },
+                                                                                "edge": {
+                                                                                    "oneOf": [
+                                                                                        {
+                                                                                            "const": "before"
+                                                                                        },
+                                                                                        {
+                                                                                            "const": "after"
+                                                                                        }
+                                                                                    ]
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "node",
+                                                                                "edge"
+                                                                            ]
                                                                         }
                                                                     ],
-                                                                    "description": "Filter: 'block' or 'inline'."
+                                                                    "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
                                                                 }
                                                             },
                                                             "required": [
-                                                                "type"
+                                                                "kind",
+                                                                "start",
+                                                                "end"
                                                             ]
                                                         }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "target"
                                                     ]
                                                 },
-                                                "within": {
+                                                {
                                                     "type": "object",
                                                     "properties": {
-                                                        "kind": {
+                                                        "by": {
                                                             "const": "block"
                                                         },
                                                         "nodeType": {
@@ -62878,26 +63823,11 @@ const CONTRACT = {
                                                         }
                                                     },
                                                     "required": [
-                                                        "kind",
+                                                        "by",
                                                         "nodeType",
                                                         "nodeId"
                                                     ]
-                                                },
-                                                "require": {
-                                                    "oneOf": [
-                                                        {
-                                                            "const": "first"
-                                                        },
-                                                        {
-                                                            "const": "exactlyOne"
-                                                        }
-                                                    ]
                                                 }
-                                            },
-                                            "required": [
-                                                "by",
-                                                "select",
-                                                "require"
                                             ]
                                         },
                                         "args": {
@@ -63494,6 +64424,53 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block"
+                                                        },
+                                                        "nodeType": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "paragraph"
+                                                                },
+                                                                {
+                                                                    "const": "heading"
+                                                                },
+                                                                {
+                                                                    "const": "listItem"
+                                                                },
+                                                                {
+                                                                    "const": "table"
+                                                                },
+                                                                {
+                                                                    "const": "tableRow"
+                                                                },
+                                                                {
+                                                                    "const": "tableCell"
+                                                                },
+                                                                {
+                                                                    "const": "tableOfContents"
+                                                                },
+                                                                {
+                                                                    "const": "image"
+                                                                },
+                                                                {
+                                                                    "const": "sdt"
+                                                                }
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -63990,6 +64967,53 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block"
+                                                        },
+                                                        "nodeType": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "paragraph"
+                                                                },
+                                                                {
+                                                                    "const": "heading"
+                                                                },
+                                                                {
+                                                                    "const": "listItem"
+                                                                },
+                                                                {
+                                                                    "const": "table"
+                                                                },
+                                                                {
+                                                                    "const": "tableRow"
+                                                                },
+                                                                {
+                                                                    "const": "tableCell"
+                                                                },
+                                                                {
+                                                                    "const": "tableOfContents"
+                                                                },
+                                                                {
+                                                                    "const": "image"
+                                                                },
+                                                                {
+                                                                    "const": "sdt"
+                                                                }
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -64761,11 +65785,36 @@ const CONTRACT = {
                                                             ]
                                                         }
                                                     }
+                                                },
+                                                "alignment": {
+                                                    "oneOf": [
+                                                        {
+                                                            "const": "left"
+                                                        },
+                                                        {
+                                                            "const": "center"
+                                                        },
+                                                        {
+                                                            "const": "right"
+                                                        },
+                                                        {
+                                                            "const": "justify"
+                                                        }
+                                                    ],
+                                                    "description": "Set paragraph alignment on the target block(s). Can be combined with inline formatting in the same step."
+                                                },
+                                                "scope": {
+                                                    "oneOf": [
+                                                        {
+                                                            "const": "match"
+                                                        },
+                                                        {
+                                                            "const": "block"
+                                                        }
+                                                    ],
+                                                    "description": "When \"block\", inline formatting expands to cover the entire parent paragraph(s), not just the matched text. Use \"block\" after markdown inserts to format whole paragraphs with a short identifying pattern. Default: \"match\"."
                                                 }
-                                            },
-                                            "required": [
-                                                "inline"
-                                            ]
+                                            }
                                         }
                                     },
                                     "required": [
@@ -65183,6 +66232,37 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -65343,217 +66423,289 @@ const CONTRACT = {
                                             "const": "text.insert",
                                             "type": "string"
                                         },
-                                        "where": {
-                                            "type": "object",
-                                            "properties": {
-                                                "by": {
-                                                    "const": "select",
-                                                    "type": "string"
-                                                },
-                                                "select": {
-                                                    "oneOf": [
-                                                        {
-                                                            "type": "object",
-                                                            "properties": {
-                                                                "type": {
-                                                                    "const": "text",
-                                                                    "description": "Must be 'text' for text pattern search."
-                                                                },
-                                                                "pattern": {
-                                                                    "type": "string",
-                                                                    "description": "Text or regex pattern to match."
-                                                                },
-                                                                "mode": {
-                                                                    "enum": [
-                                                                        "contains",
-                                                                        "regex"
-                                                                    ],
-                                                                    "description": "Match mode: 'contains' (substring) or 'regex'."
-                                                                },
-                                                                "caseSensitive": {
-                                                                    "type": "boolean",
-                                                                    "description": "Case-sensitive matching. Default: false."
-                                                                }
-                                                            },
-                                                            "additionalProperties": false,
-                                                            "required": [
-                                                                "type",
-                                                                "pattern"
-                                                            ]
-                                                        },
-                                                        {
-                                                            "type": "object",
-                                                            "properties": {
-                                                                "type": {
-                                                                    "const": "node",
-                                                                    "description": "Must be 'node' for node type search."
-                                                                },
-                                                                "nodeType": {
-                                                                    "enum": [
-                                                                        "paragraph",
-                                                                        "heading",
-                                                                        "listItem",
-                                                                        "table",
-                                                                        "tableRow",
-                                                                        "tableCell",
-                                                                        "tableOfContents",
-                                                                        "image",
-                                                                        "sdt",
-                                                                        "run",
-                                                                        "bookmark",
-                                                                        "comment",
-                                                                        "hyperlink",
-                                                                        "footnoteRef",
-                                                                        "endnoteRef",
-                                                                        "crossRef",
-                                                                        "indexEntry",
-                                                                        "citation",
-                                                                        "authorityEntry",
-                                                                        "sequenceField",
-                                                                        "tab",
-                                                                        "lineBreak"
-                                                                    ],
-                                                                    "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
-                                                                },
-                                                                "kind": {
-                                                                    "enum": [
-                                                                        "block",
-                                                                        "inline"
-                                                                    ],
-                                                                    "description": "Filter: 'block' or 'inline'."
-                                                                }
-                                                            },
-                                                            "additionalProperties": false,
-                                                            "required": [
-                                                                "type"
-                                                            ]
-                                                        }
-                                                    ]
-                                                },
-                                                "within": {
-                                                    "$ref": "#/$defs/BlockNodeAddress"
-                                                },
-                                                "require": {
-                                                    "enum": [
-                                                        "first",
-                                                        "exactlyOne"
-                                                    ]
-                                                }
-                                            },
-                                            "additionalProperties": false,
-                                            "required": [
-                                                "by",
-                                                "select",
-                                                "require"
-                                            ]
-                                        },
-                                        "args": {
-                                            "type": "object",
-                                            "properties": {
-                                                "position": {
-                                                    "enum": [
-                                                        "before",
-                                                        "after"
-                                                    ]
-                                                },
-                                                "content": {
-                                                    "type": "object",
-                                                    "properties": {
-                                                        "text": {
-                                                            "type": "string"
-                                                        }
-                                                    },
-                                                    "additionalProperties": false,
-                                                    "required": [
-                                                        "text"
-                                                    ]
-                                                },
-                                                "style": {
-                                                    "type": "object",
-                                                    "properties": {
-                                                        "inline": {
-                                                            "type": "object",
-                                                            "properties": {
-                                                                "mode": {
-                                                                    "enum": [
-                                                                        "inherit",
-                                                                        "set",
-                                                                        "clear"
-                                                                    ],
-                                                                    "type": "string"
-                                                                },
-                                                                "setMarks": {
-                                                                    "type": "object",
-                                                                    "properties": {
-                                                                        "bold": {
-                                                                            "enum": [
-                                                                                "on",
-                                                                                "off",
-                                                                                "clear"
-                                                                            ]
-                                                                        },
-                                                                        "italic": {
-                                                                            "enum": [
-                                                                                "on",
-                                                                                "off",
-                                                                                "clear"
-                                                                            ]
-                                                                        },
-                                                                        "underline": {
-                                                                            "enum": [
-                                                                                "on",
-                                                                                "off",
-                                                                                "clear"
-                                                                            ]
-                                                                        },
-                                                                        "strike": {
-                                                                            "enum": [
-                                                                                "on",
-                                                                                "off",
-                                                                                "clear"
-                                                                            ]
-                                                                        }
-                                                                    },
-                                                                    "additionalProperties": false
-                                                                }
-                                                            },
-                                                            "additionalProperties": false,
-                                                            "required": [
-                                                                "mode"
-                                                            ]
-                                                        }
-                                                    },
-                                                    "additionalProperties": false,
-                                                    "required": [
-                                                        "inline"
-                                                    ]
-                                                }
-                                            },
-                                            "additionalProperties": false,
-                                            "required": [
-                                                "position",
-                                                "content"
-                                            ]
-                                        }
-                                    },
-                                    "additionalProperties": false,
-                                    "required": [
-                                        "id",
-                                        "op",
-                                        "where",
-                                        "args"
-                                    ]
-                                },
-                                {
-                                    "type": "object",
-                                    "properties": {
-                                        "id": {
-                                            "type": "string"
-                                        },
-                                        "op": {
-                                            "const": "text.delete",
-                                            "type": "string"
-                                        },
+                                        "where": {
+                                            "oneOf": [
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "select",
+                                                            "type": "string"
+                                                        },
+                                                        "select": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "text",
+                                                                            "description": "Must be 'text' for text pattern search."
+                                                                        },
+                                                                        "pattern": {
+                                                                            "type": "string",
+                                                                            "description": "Text or regex pattern to match."
+                                                                        },
+                                                                        "mode": {
+                                                                            "enum": [
+                                                                                "contains",
+                                                                                "regex"
+                                                                            ],
+                                                                            "description": "Match mode: 'contains' (substring) or 'regex'."
+                                                                        },
+                                                                        "caseSensitive": {
+                                                                            "type": "boolean",
+                                                                            "description": "Case-sensitive matching. Default: false."
+                                                                        }
+                                                                    },
+                                                                    "additionalProperties": false,
+                                                                    "required": [
+                                                                        "type",
+                                                                        "pattern"
+                                                                    ]
+                                                                },
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "node",
+                                                                            "description": "Must be 'node' for node type search."
+                                                                        },
+                                                                        "nodeType": {
+                                                                            "enum": [
+                                                                                "paragraph",
+                                                                                "heading",
+                                                                                "listItem",
+                                                                                "table",
+                                                                                "tableRow",
+                                                                                "tableCell",
+                                                                                "tableOfContents",
+                                                                                "image",
+                                                                                "sdt",
+                                                                                "run",
+                                                                                "bookmark",
+                                                                                "comment",
+                                                                                "hyperlink",
+                                                                                "footnoteRef",
+                                                                                "endnoteRef",
+                                                                                "crossRef",
+                                                                                "indexEntry",
+                                                                                "citation",
+                                                                                "authorityEntry",
+                                                                                "sequenceField",
+                                                                                "tab",
+                                                                                "lineBreak"
+                                                                            ],
+                                                                            "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
+                                                                        },
+                                                                        "kind": {
+                                                                            "enum": [
+                                                                                "block",
+                                                                                "inline"
+                                                                            ],
+                                                                            "description": "Filter: 'block' or 'inline'."
+                                                                        }
+                                                                    },
+                                                                    "additionalProperties": false,
+                                                                    "required": [
+                                                                        "type"
+                                                                    ]
+                                                                }
+                                                            ]
+                                                        },
+                                                        "within": {
+                                                            "$ref": "#/$defs/BlockNodeAddress"
+                                                        },
+                                                        "require": {
+                                                            "enum": [
+                                                                "first",
+                                                                "exactlyOne"
+                                                            ]
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "select",
+                                                        "require"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "ref",
+                                                            "type": "string"
+                                                        },
+                                                        "ref": {
+                                                            "type": "string"
+                                                        },
+                                                        "within": {
+                                                            "$ref": "#/$defs/BlockNodeAddress"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "ref"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "target",
+                                                            "type": "string"
+                                                        },
+                                                        "target": {
+                                                            "$ref": "#/$defs/SelectionTarget"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "target"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
+                                                }
+                                            ]
+                                        },
+                                        "args": {
+                                            "type": "object",
+                                            "properties": {
+                                                "position": {
+                                                    "enum": [
+                                                        "before",
+                                                        "after"
+                                                    ]
+                                                },
+                                                "content": {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "text": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "text"
+                                                    ]
+                                                },
+                                                "style": {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "inline": {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "mode": {
+                                                                    "enum": [
+                                                                        "inherit",
+                                                                        "set",
+                                                                        "clear"
+                                                                    ],
+                                                                    "type": "string"
+                                                                },
+                                                                "setMarks": {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "bold": {
+                                                                            "enum": [
+                                                                                "on",
+                                                                                "off",
+                                                                                "clear"
+                                                                            ]
+                                                                        },
+                                                                        "italic": {
+                                                                            "enum": [
+                                                                                "on",
+                                                                                "off",
+                                                                                "clear"
+                                                                            ]
+                                                                        },
+                                                                        "underline": {
+                                                                            "enum": [
+                                                                                "on",
+                                                                                "off",
+                                                                                "clear"
+                                                                            ]
+                                                                        },
+                                                                        "strike": {
+                                                                            "enum": [
+                                                                                "on",
+                                                                                "off",
+                                                                                "clear"
+                                                                            ]
+                                                                        }
+                                                                    },
+                                                                    "additionalProperties": false
+                                                                }
+                                                            },
+                                                            "additionalProperties": false,
+                                                            "required": [
+                                                                "mode"
+                                                            ]
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "inline"
+                                                    ]
+                                                }
+                                            },
+                                            "additionalProperties": false,
+                                            "required": [
+                                                "position",
+                                                "content"
+                                            ]
+                                        }
+                                    },
+                                    "additionalProperties": false,
+                                    "required": [
+                                        "id",
+                                        "op",
+                                        "where",
+                                        "args"
+                                    ]
+                                },
+                                {
+                                    "type": "object",
+                                    "properties": {
+                                        "id": {
+                                            "type": "string"
+                                        },
+                                        "op": {
+                                            "const": "text.delete",
+                                            "type": "string"
+                                        },
                                         "where": {
                                             "oneOf": [
                                                 {
@@ -65697,6 +66849,37 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -65871,6 +67054,37 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -66685,12 +67899,28 @@ const CONTRACT = {
                                                     },
                                                     "additionalProperties": false,
                                                     "minProperties": 1
+                                                },
+                                                "alignment": {
+                                                    "type": "string",
+                                                    "enum": [
+                                                        "left",
+                                                        "center",
+                                                        "right",
+                                                        "justify"
+                                                    ],
+                                                    "description": "Set paragraph alignment on the target block(s). Can be combined with inline formatting in the same step."
+                                                },
+                                                "scope": {
+                                                    "type": "string",
+                                                    "enum": [
+                                                        "match",
+                                                        "block"
+                                                    ],
+                                                    "description": "When \"block\", inline formatting expands to cover the entire parent paragraph(s), not just the matched text. Use \"block\" after markdown inserts to format whole paragraphs with a short identifying pattern. Default: \"match\"."
                                                 }
                                             },
                                             "additionalProperties": false,
-                                            "required": [
-                                                "inline"
-                                            ]
+                                            "minProperties": 1
                                         }
                                     },
                                     "additionalProperties": false,
@@ -67583,6 +68813,53 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block"
+                                                        },
+                                                        "nodeType": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "paragraph"
+                                                                },
+                                                                {
+                                                                    "const": "heading"
+                                                                },
+                                                                {
+                                                                    "const": "listItem"
+                                                                },
+                                                                {
+                                                                    "const": "table"
+                                                                },
+                                                                {
+                                                                    "const": "tableRow"
+                                                                },
+                                                                {
+                                                                    "const": "tableCell"
+                                                                },
+                                                                {
+                                                                    "const": "tableOfContents"
+                                                                },
+                                                                {
+                                                                    "const": "image"
+                                                                },
+                                                                {
+                                                                    "const": "sdt"
+                                                                }
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -67778,51 +69055,221 @@ const CONTRACT = {
                                             "const": "text.insert"
                                         },
                                         "where": {
-                                            "type": "object",
-                                            "properties": {
-                                                "by": {
-                                                    "const": "select"
-                                                },
-                                                "select": {
-                                                    "oneOf": [
-                                                        {
+                                            "oneOf": [
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "select"
+                                                        },
+                                                        "select": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "text",
+                                                                            "description": "Must be 'text' for text pattern search."
+                                                                        },
+                                                                        "pattern": {
+                                                                            "type": "string",
+                                                                            "description": "Text or regex pattern to match."
+                                                                        },
+                                                                        "mode": {
+                                                                            "oneOf": [
+                                                                                {
+                                                                                    "const": "contains"
+                                                                                },
+                                                                                {
+                                                                                    "const": "regex"
+                                                                                }
+                                                                            ],
+                                                                            "description": "Match mode: 'contains' (substring) or 'regex'."
+                                                                        },
+                                                                        "caseSensitive": {
+                                                                            "type": "boolean",
+                                                                            "description": "Case-sensitive matching. Default: false."
+                                                                        }
+                                                                    },
+                                                                    "required": [
+                                                                        "type",
+                                                                        "pattern"
+                                                                    ]
+                                                                },
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "node",
+                                                                            "description": "Must be 'node' for node type search."
+                                                                        },
+                                                                        "nodeType": {
+                                                                            "oneOf": [
+                                                                                {
+                                                                                    "const": "paragraph"
+                                                                                },
+                                                                                {
+                                                                                    "const": "heading"
+                                                                                },
+                                                                                {
+                                                                                    "const": "listItem"
+                                                                                },
+                                                                                {
+                                                                                    "const": "table"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tableRow"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tableCell"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tableOfContents"
+                                                                                },
+                                                                                {
+                                                                                    "const": "image"
+                                                                                },
+                                                                                {
+                                                                                    "const": "sdt"
+                                                                                },
+                                                                                {
+                                                                                    "const": "run"
+                                                                                },
+                                                                                {
+                                                                                    "const": "bookmark"
+                                                                                },
+                                                                                {
+                                                                                    "const": "comment"
+                                                                                },
+                                                                                {
+                                                                                    "const": "hyperlink"
+                                                                                },
+                                                                                {
+                                                                                    "const": "footnoteRef"
+                                                                                },
+                                                                                {
+                                                                                    "const": "endnoteRef"
+                                                                                },
+                                                                                {
+                                                                                    "const": "crossRef"
+                                                                                },
+                                                                                {
+                                                                                    "const": "indexEntry"
+                                                                                },
+                                                                                {
+                                                                                    "const": "citation"
+                                                                                },
+                                                                                {
+                                                                                    "const": "authorityEntry"
+                                                                                },
+                                                                                {
+                                                                                    "const": "sequenceField"
+                                                                                },
+                                                                                {
+                                                                                    "const": "tab"
+                                                                                },
+                                                                                {
+                                                                                    "const": "lineBreak"
+                                                                                }
+                                                                            ],
+                                                                            "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
+                                                                        },
+                                                                        "kind": {
+                                                                            "oneOf": [
+                                                                                {
+                                                                                    "const": "block"
+                                                                                },
+                                                                                {
+                                                                                    "const": "inline"
+                                                                                }
+                                                                            ],
+                                                                            "description": "Filter: 'block' or 'inline'."
+                                                                        }
+                                                                    },
+                                                                    "required": [
+                                                                        "type"
+                                                                    ]
+                                                                }
+                                                            ]
+                                                        },
+                                                        "within": {
                                                             "type": "object",
                                                             "properties": {
-                                                                "type": {
-                                                                    "const": "text",
-                                                                    "description": "Must be 'text' for text pattern search."
-                                                                },
-                                                                "pattern": {
-                                                                    "type": "string",
-                                                                    "description": "Text or regex pattern to match."
+                                                                "kind": {
+                                                                    "const": "block"
                                                                 },
-                                                                "mode": {
+                                                                "nodeType": {
                                                                     "oneOf": [
                                                                         {
-                                                                            "const": "contains"
+                                                                            "const": "paragraph"
                                                                         },
                                                                         {
-                                                                            "const": "regex"
+                                                                            "const": "heading"
+                                                                        },
+                                                                        {
+                                                                            "const": "listItem"
+                                                                        },
+                                                                        {
+                                                                            "const": "table"
+                                                                        },
+                                                                        {
+                                                                            "const": "tableRow"
+                                                                        },
+                                                                        {
+                                                                            "const": "tableCell"
+                                                                        },
+                                                                        {
+                                                                            "const": "tableOfContents"
+                                                                        },
+                                                                        {
+                                                                            "const": "image"
+                                                                        },
+                                                                        {
+                                                                            "const": "sdt"
                                                                         }
-                                                                    ],
-                                                                    "description": "Match mode: 'contains' (substring) or 'regex'."
+                                                                    ]
                                                                 },
-                                                                "caseSensitive": {
-                                                                    "type": "boolean",
-                                                                    "description": "Case-sensitive matching. Default: false."
+                                                                "nodeId": {
+                                                                    "type": "string"
                                                                 }
                                                             },
                                                             "required": [
-                                                                "type",
-                                                                "pattern"
+                                                                "kind",
+                                                                "nodeType",
+                                                                "nodeId"
                                                             ]
                                                         },
-                                                        {
+                                                        "require": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "first"
+                                                                },
+                                                                {
+                                                                    "const": "exactlyOne"
+                                                                }
+                                                            ]
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "select",
+                                                        "require"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "ref"
+                                                        },
+                                                        "ref": {
+                                                            "type": "string"
+                                                        },
+                                                        "within": {
                                                             "type": "object",
                                                             "properties": {
-                                                                "type": {
-                                                                    "const": "node",
-                                                                    "description": "Must be 'node' for node type search."
+                                                                "kind": {
+                                                                    "const": "block"
                                                                 },
                                                                 "nodeType": {
                                                                     "oneOf": [
@@ -67852,71 +69299,224 @@ const CONTRACT = {
                                                                         },
                                                                         {
                                                                             "const": "sdt"
-                                                                        },
-                                                                        {
-                                                                            "const": "run"
-                                                                        },
-                                                                        {
-                                                                            "const": "bookmark"
-                                                                        },
-                                                                        {
-                                                                            "const": "comment"
-                                                                        },
-                                                                        {
-                                                                            "const": "hyperlink"
-                                                                        },
-                                                                        {
-                                                                            "const": "footnoteRef"
-                                                                        },
-                                                                        {
-                                                                            "const": "endnoteRef"
-                                                                        },
-                                                                        {
-                                                                            "const": "crossRef"
-                                                                        },
-                                                                        {
-                                                                            "const": "indexEntry"
-                                                                        },
-                                                                        {
-                                                                            "const": "citation"
-                                                                        },
-                                                                        {
-                                                                            "const": "authorityEntry"
-                                                                        },
-                                                                        {
-                                                                            "const": "sequenceField"
-                                                                        },
+                                                                        }
+                                                                    ]
+                                                                },
+                                                                "nodeId": {
+                                                                    "type": "string"
+                                                                }
+                                                            },
+                                                            "required": [
+                                                                "kind",
+                                                                "nodeType",
+                                                                "nodeId"
+                                                            ]
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "ref"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "target"
+                                                        },
+                                                        "target": {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "kind": {
+                                                                    "const": "selection"
+                                                                },
+                                                                "start": {
+                                                                    "oneOf": [
                                                                         {
-                                                                            "const": "tab"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "text"
+                                                                                },
+                                                                                "blockId": {
+                                                                                    "type": "string"
+                                                                                },
+                                                                                "offset": {
+                                                                                    "type": "number"
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "blockId",
+                                                                                "offset"
+                                                                            ]
                                                                         },
                                                                         {
-                                                                            "const": "lineBreak"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "nodeEdge"
+                                                                                },
+                                                                                "node": {
+                                                                                    "type": "object",
+                                                                                    "properties": {
+                                                                                        "kind": {
+                                                                                            "const": "block"
+                                                                                        },
+                                                                                        "nodeType": {
+                                                                                            "oneOf": [
+                                                                                                {
+                                                                                                    "const": "paragraph"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "heading"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "table"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "tableOfContents"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "sdt"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "image"
+                                                                                                }
+                                                                                            ]
+                                                                                        },
+                                                                                        "nodeId": {
+                                                                                            "type": "string"
+                                                                                        }
+                                                                                    },
+                                                                                    "required": [
+                                                                                        "kind",
+                                                                                        "nodeType",
+                                                                                        "nodeId"
+                                                                                    ]
+                                                                                },
+                                                                                "edge": {
+                                                                                    "oneOf": [
+                                                                                        {
+                                                                                            "const": "before"
+                                                                                        },
+                                                                                        {
+                                                                                            "const": "after"
+                                                                                        }
+                                                                                    ]
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "node",
+                                                                                "edge"
+                                                                            ]
                                                                         }
                                                                     ],
-                                                                    "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
+                                                                    "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
                                                                 },
-                                                                "kind": {
+                                                                "end": {
                                                                     "oneOf": [
                                                                         {
-                                                                            "const": "block"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "text"
+                                                                                },
+                                                                                "blockId": {
+                                                                                    "type": "string"
+                                                                                },
+                                                                                "offset": {
+                                                                                    "type": "number"
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "blockId",
+                                                                                "offset"
+                                                                            ]
                                                                         },
                                                                         {
-                                                                            "const": "inline"
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "kind": {
+                                                                                    "const": "nodeEdge"
+                                                                                },
+                                                                                "node": {
+                                                                                    "type": "object",
+                                                                                    "properties": {
+                                                                                        "kind": {
+                                                                                            "const": "block"
+                                                                                        },
+                                                                                        "nodeType": {
+                                                                                            "oneOf": [
+                                                                                                {
+                                                                                                    "const": "paragraph"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "heading"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "table"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "tableOfContents"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "sdt"
+                                                                                                },
+                                                                                                {
+                                                                                                    "const": "image"
+                                                                                                }
+                                                                                            ]
+                                                                                        },
+                                                                                        "nodeId": {
+                                                                                            "type": "string"
+                                                                                        }
+                                                                                    },
+                                                                                    "required": [
+                                                                                        "kind",
+                                                                                        "nodeType",
+                                                                                        "nodeId"
+                                                                                    ]
+                                                                                },
+                                                                                "edge": {
+                                                                                    "oneOf": [
+                                                                                        {
+                                                                                            "const": "before"
+                                                                                        },
+                                                                                        {
+                                                                                            "const": "after"
+                                                                                        }
+                                                                                    ]
+                                                                                }
+                                                                            },
+                                                                            "required": [
+                                                                                "kind",
+                                                                                "node",
+                                                                                "edge"
+                                                                            ]
                                                                         }
                                                                     ],
-                                                                    "description": "Filter: 'block' or 'inline'."
+                                                                    "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
                                                                 }
                                                             },
                                                             "required": [
-                                                                "type"
+                                                                "kind",
+                                                                "start",
+                                                                "end"
                                                             ]
                                                         }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "target"
                                                     ]
                                                 },
-                                                "within": {
+                                                {
                                                     "type": "object",
                                                     "properties": {
-                                                        "kind": {
+                                                        "by": {
                                                             "const": "block"
                                                         },
                                                         "nodeType": {
@@ -67955,26 +69555,11 @@ const CONTRACT = {
                                                         }
                                                     },
                                                     "required": [
-                                                        "kind",
+                                                        "by",
                                                         "nodeType",
                                                         "nodeId"
                                                     ]
-                                                },
-                                                "require": {
-                                                    "oneOf": [
-                                                        {
-                                                            "const": "first"
-                                                        },
-                                                        {
-                                                            "const": "exactlyOne"
-                                                        }
-                                                    ]
                                                 }
-                                            },
-                                            "required": [
-                                                "by",
-                                                "select",
-                                                "require"
                                             ]
                                         },
                                         "args": {
@@ -68571,6 +70156,53 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block"
+                                                        },
+                                                        "nodeType": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "paragraph"
+                                                                },
+                                                                {
+                                                                    "const": "heading"
+                                                                },
+                                                                {
+                                                                    "const": "listItem"
+                                                                },
+                                                                {
+                                                                    "const": "table"
+                                                                },
+                                                                {
+                                                                    "const": "tableRow"
+                                                                },
+                                                                {
+                                                                    "const": "tableCell"
+                                                                },
+                                                                {
+                                                                    "const": "tableOfContents"
+                                                                },
+                                                                {
+                                                                    "const": "image"
+                                                                },
+                                                                {
+                                                                    "const": "sdt"
+                                                                }
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -69067,6 +70699,53 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block"
+                                                        },
+                                                        "nodeType": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "const": "paragraph"
+                                                                },
+                                                                {
+                                                                    "const": "heading"
+                                                                },
+                                                                {
+                                                                    "const": "listItem"
+                                                                },
+                                                                {
+                                                                    "const": "table"
+                                                                },
+                                                                {
+                                                                    "const": "tableRow"
+                                                                },
+                                                                {
+                                                                    "const": "tableCell"
+                                                                },
+                                                                {
+                                                                    "const": "tableOfContents"
+                                                                },
+                                                                {
+                                                                    "const": "image"
+                                                                },
+                                                                {
+                                                                    "const": "sdt"
+                                                                }
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -69838,11 +71517,36 @@ const CONTRACT = {
                                                             ]
                                                         }
                                                     }
+                                                },
+                                                "alignment": {
+                                                    "oneOf": [
+                                                        {
+                                                            "const": "left"
+                                                        },
+                                                        {
+                                                            "const": "center"
+                                                        },
+                                                        {
+                                                            "const": "right"
+                                                        },
+                                                        {
+                                                            "const": "justify"
+                                                        }
+                                                    ],
+                                                    "description": "Set paragraph alignment on the target block(s). Can be combined with inline formatting in the same step."
+                                                },
+                                                "scope": {
+                                                    "oneOf": [
+                                                        {
+                                                            "const": "match"
+                                                        },
+                                                        {
+                                                            "const": "block"
+                                                        }
+                                                    ],
+                                                    "description": "When \"block\", inline formatting expands to cover the entire parent paragraph(s), not just the matched text. Use \"block\" after markdown inserts to format whole paragraphs with a short identifying pattern. Default: \"match\"."
                                                 }
-                                            },
-                                            "required": [
-                                                "inline"
-                                            ]
+                                            }
                                         }
                                     },
                                     "required": [
@@ -70260,6 +71964,37 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -70421,107 +72156,179 @@ const CONTRACT = {
                                             "type": "string"
                                         },
                                         "where": {
-                                            "type": "object",
-                                            "properties": {
-                                                "by": {
-                                                    "const": "select",
-                                                    "type": "string"
-                                                },
-                                                "select": {
-                                                    "oneOf": [
-                                                        {
-                                                            "type": "object",
-                                                            "properties": {
-                                                                "type": {
-                                                                    "const": "text",
-                                                                    "description": "Must be 'text' for text pattern search."
-                                                                },
-                                                                "pattern": {
-                                                                    "type": "string",
-                                                                    "description": "Text or regex pattern to match."
-                                                                },
-                                                                "mode": {
-                                                                    "enum": [
-                                                                        "contains",
-                                                                        "regex"
-                                                                    ],
-                                                                    "description": "Match mode: 'contains' (substring) or 'regex'."
+                                            "oneOf": [
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "select",
+                                                            "type": "string"
+                                                        },
+                                                        "select": {
+                                                            "oneOf": [
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "text",
+                                                                            "description": "Must be 'text' for text pattern search."
+                                                                        },
+                                                                        "pattern": {
+                                                                            "type": "string",
+                                                                            "description": "Text or regex pattern to match."
+                                                                        },
+                                                                        "mode": {
+                                                                            "enum": [
+                                                                                "contains",
+                                                                                "regex"
+                                                                            ],
+                                                                            "description": "Match mode: 'contains' (substring) or 'regex'."
+                                                                        },
+                                                                        "caseSensitive": {
+                                                                            "type": "boolean",
+                                                                            "description": "Case-sensitive matching. Default: false."
+                                                                        }
+                                                                    },
+                                                                    "additionalProperties": false,
+                                                                    "required": [
+                                                                        "type",
+                                                                        "pattern"
+                                                                    ]
                                                                 },
-                                                                "caseSensitive": {
-                                                                    "type": "boolean",
-                                                                    "description": "Case-sensitive matching. Default: false."
+                                                                {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "type": {
+                                                                            "const": "node",
+                                                                            "description": "Must be 'node' for node type search."
+                                                                        },
+                                                                        "nodeType": {
+                                                                            "enum": [
+                                                                                "paragraph",
+                                                                                "heading",
+                                                                                "listItem",
+                                                                                "table",
+                                                                                "tableRow",
+                                                                                "tableCell",
+                                                                                "tableOfContents",
+                                                                                "image",
+                                                                                "sdt",
+                                                                                "run",
+                                                                                "bookmark",
+                                                                                "comment",
+                                                                                "hyperlink",
+                                                                                "footnoteRef",
+                                                                                "endnoteRef",
+                                                                                "crossRef",
+                                                                                "indexEntry",
+                                                                                "citation",
+                                                                                "authorityEntry",
+                                                                                "sequenceField",
+                                                                                "tab",
+                                                                                "lineBreak"
+                                                                            ],
+                                                                            "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
+                                                                        },
+                                                                        "kind": {
+                                                                            "enum": [
+                                                                                "block",
+                                                                                "inline"
+                                                                            ],
+                                                                            "description": "Filter: 'block' or 'inline'."
+                                                                        }
+                                                                    },
+                                                                    "additionalProperties": false,
+                                                                    "required": [
+                                                                        "type"
+                                                                    ]
                                                                 }
-                                                            },
-                                                            "additionalProperties": false,
-                                                            "required": [
-                                                                "type",
-                                                                "pattern"
                                                             ]
                                                         },
-                                                        {
-                                                            "type": "object",
-                                                            "properties": {
-                                                                "type": {
-                                                                    "const": "node",
-                                                                    "description": "Must be 'node' for node type search."
-                                                                },
-                                                                "nodeType": {
-                                                                    "enum": [
-                                                                        "paragraph",
-                                                                        "heading",
-                                                                        "listItem",
-                                                                        "table",
-                                                                        "tableRow",
-                                                                        "tableCell",
-                                                                        "tableOfContents",
-                                                                        "image",
-                                                                        "sdt",
-                                                                        "run",
-                                                                        "bookmark",
-                                                                        "comment",
-                                                                        "hyperlink",
-                                                                        "footnoteRef",
-                                                                        "endnoteRef",
-                                                                        "crossRef",
-                                                                        "indexEntry",
-                                                                        "citation",
-                                                                        "authorityEntry",
-                                                                        "sequenceField",
-                                                                        "tab",
-                                                                        "lineBreak"
-                                                                    ],
-                                                                    "description": "Block type to match (paragraph, heading, table, listItem, etc.)."
-                                                                },
-                                                                "kind": {
-                                                                    "enum": [
-                                                                        "block",
-                                                                        "inline"
-                                                                    ],
-                                                                    "description": "Filter: 'block' or 'inline'."
-                                                                }
-                                                            },
-                                                            "additionalProperties": false,
-                                                            "required": [
-                                                                "type"
+                                                        "within": {
+                                                            "$ref": "#/$defs/BlockNodeAddress"
+                                                        },
+                                                        "require": {
+                                                            "enum": [
+                                                                "first",
+                                                                "exactlyOne"
                                                             ]
                                                         }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "select",
+                                                        "require"
                                                     ]
                                                 },
-                                                "within": {
-                                                    "$ref": "#/$defs/BlockNodeAddress"
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "ref",
+                                                            "type": "string"
+                                                        },
+                                                        "ref": {
+                                                            "type": "string"
+                                                        },
+                                                        "within": {
+                                                            "$ref": "#/$defs/BlockNodeAddress"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "ref"
+                                                    ]
                                                 },
-                                                "require": {
-                                                    "enum": [
-                                                        "first",
-                                                        "exactlyOne"
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "target",
+                                                            "type": "string"
+                                                        },
+                                                        "target": {
+                                                            "$ref": "#/$defs/SelectionTarget"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "target"
+                                                    ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
                                                     ]
                                                 }
-                                            },
-                                            "additionalProperties": false,
-                                            "required": [
-                                                "by",
-                                                "select",
-                                                "require"
                                             ]
                                         },
                                         "args": {
@@ -70774,6 +72581,37 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -70948,6 +72786,37 @@ const CONTRACT = {
                                                         "by",
                                                         "target"
                                                     ]
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "by": {
+                                                            "const": "block",
+                                                            "type": "string"
+                                                        },
+                                                        "nodeType": {
+                                                            "enum": [
+                                                                "paragraph",
+                                                                "heading",
+                                                                "listItem",
+                                                                "table",
+                                                                "tableRow",
+                                                                "tableCell",
+                                                                "tableOfContents",
+                                                                "image",
+                                                                "sdt"
+                                                            ]
+                                                        },
+                                                        "nodeId": {
+                                                            "type": "string"
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "by",
+                                                        "nodeType",
+                                                        "nodeId"
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -71762,12 +73631,28 @@ const CONTRACT = {
                                                     },
                                                     "additionalProperties": false,
                                                     "minProperties": 1
+                                                },
+                                                "alignment": {
+                                                    "type": "string",
+                                                    "enum": [
+                                                        "left",
+                                                        "center",
+                                                        "right",
+                                                        "justify"
+                                                    ],
+                                                    "description": "Set paragraph alignment on the target block(s). Can be combined with inline formatting in the same step."
+                                                },
+                                                "scope": {
+                                                    "type": "string",
+                                                    "enum": [
+                                                        "match",
+                                                        "block"
+                                                    ],
+                                                    "description": "When \"block\", inline formatting expands to cover the entire parent paragraph(s), not just the matched text. Use \"block\" after markdown inserts to format whole paragraphs with a short identifying pattern. Default: \"match\"."
                                                 }
                                             },
                                             "additionalProperties": false,
-                                            "required": [
-                                                "inline"
-                                            ]
+                                            "minProperties": 1
                                         }
                                     },
                                     "additionalProperties": false,
@@ -114286,6 +116171,195 @@ const CONTRACT = {
                         ]
                     }
                 },
+                {
+                    "name": "at",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "at-json",
+                    "schema": {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "const": "selection"
+                            },
+                            "start": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "text"
+                                            },
+                                            "blockId": {
+                                                "type": "string"
+                                            },
+                                            "offset": {
+                                                "type": "number"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "blockId",
+                                            "offset"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "nodeEdge"
+                                            },
+                                            "node": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "block"
+                                                    },
+                                                    "nodeType": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "paragraph"
+                                                            },
+                                                            {
+                                                                "const": "heading"
+                                                            },
+                                                            {
+                                                                "const": "table"
+                                                            },
+                                                            {
+                                                                "const": "tableOfContents"
+                                                            },
+                                                            {
+                                                                "const": "sdt"
+                                                            },
+                                                            {
+                                                                "const": "image"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "nodeId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "nodeType",
+                                                    "nodeId"
+                                                ]
+                                            },
+                                            "edge": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "before"
+                                                    },
+                                                    {
+                                                        "const": "after"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "node",
+                                            "edge"
+                                        ]
+                                    }
+                                ],
+                                "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
+                            },
+                            "end": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "text"
+                                            },
+                                            "blockId": {
+                                                "type": "string"
+                                            },
+                                            "offset": {
+                                                "type": "number"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "blockId",
+                                            "offset"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "nodeEdge"
+                                            },
+                                            "node": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "block"
+                                                    },
+                                                    "nodeType": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "paragraph"
+                                                            },
+                                                            {
+                                                                "const": "heading"
+                                                            },
+                                                            {
+                                                                "const": "table"
+                                                            },
+                                                            {
+                                                                "const": "tableOfContents"
+                                                            },
+                                                            {
+                                                                "const": "sdt"
+                                                            },
+                                                            {
+                                                                "const": "image"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "nodeId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "nodeType",
+                                                    "nodeId"
+                                                ]
+                                            },
+                                            "edge": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "before"
+                                                    },
+                                                    {
+                                                        "const": "after"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "node",
+                                            "edge"
+                                        ]
+                                    }
+                                ],
+                                "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "start",
+                            "end"
+                        ]
+                    }
+                },
                 {
                     "name": "tag",
                     "kind": "flag",
@@ -114364,6 +116438,9 @@ const CONTRACT = {
                             "nodeId"
                         ]
                     },
+                    "at": {
+                        "$ref": "#/$defs/SelectionTarget"
+                    },
                     "tag": {
                         "type": "string"
                     },
@@ -145917,6 +147994,13 @@ const CONTRACT = {
                                         "type": "string",
                                         "description": "Environment variable name containing the auth token."
                                     },
+                                    "params": {
+                                        "type": "object",
+                                        "description": "Custom query parameters appended to the WebSocket URL. Values must be strings. Reserved keys: token.",
+                                        "additionalProperties": {
+                                            "type": "string"
+                                        }
+                                    },
                                     "syncTimeoutMs": {
                                         "type": "number",
                                         "description": "Max time (ms) to wait for initial sync."
@@ -146126,6 +148210,13 @@ const CONTRACT = {
                                         "type": "string",
                                         "description": "Environment variable name containing the auth token."
                                     },
+                                    "params": {
+                                        "type": "object",
+                                        "description": "Custom query parameters appended to the WebSocket URL. Values must be strings. Reserved keys: token.",
+                                        "additionalProperties": {
+                                            "type": "string"
+                                        }
+                                    },
                                     "syncTimeoutMs": {
                                         "type": "number",
                                         "description": "Max time (ms) to wait for initial sync."