@superdoc-dev/sdk 1.8.0 → 1.9.0

package/dist/generated/contract.cjs

@@ -51455,6 +51455,221 @@ const CONTRACT = {
             "intentGroup": "list",
             "intentAction": "detach"
         },
+        "doc.lists.delete": {
+            "operationId": "doc.lists.delete",
+            "sdkSurface": "document",
+            "command": "lists delete",
+            "commandTokens": [
+                "lists",
+                "delete"
+            ],
+            "category": "lists",
+            "description": "Delete the entire list that contains the targeted list item. Removes ALL items in the same numbered sequence (the contiguous run of list items sharing the target's numbering) AND their text content from the document. Pass any single list item from the list as `target`; the op walks adjacent siblings to find the full list. Use this for \"remove the list\" / \"delete this list\" intents and for the cleanup step of a list-to-table conversion.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "required": true,
+                    "schema": {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "const": "block"
+                            },
+                            "nodeType": {
+                                "const": "listItem"
+                            },
+                            "nodeId": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "nodeType",
+                            "nodeId"
+                        ]
+                    }
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "conditional",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "$ref": "#/$defs/ListItemAddress"
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "target"
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "deletedCount": {
+                                "type": "integer",
+                                "minimum": 0
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "deletedCount"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "enum": [
+                                            "INVALID_TARGET"
+                                        ]
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "deletedCount": {
+                        "type": "integer",
+                        "minimum": 0
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "deletedCount"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "enum": [
+                                    "INVALID_TARGET"
+                                ]
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            },
+            "intentGroup": "list",
+            "intentAction": "delete"
+        },
         "doc.lists.indent": {
             "operationId": "doc.lists.indent",
             "sdkSurface": "document",
@@ -80366,6 +80581,41 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
+                            "lists.delete": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
                             "lists.indent": {
                                 "type": "object",
                                 "properties": {
@@ -82781,7 +83031,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.sort": {
+                            "tables.setCellText": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -82816,7 +83066,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setAltText": {
+                            "tables.sort": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -82851,7 +83101,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setStyle": {
+                            "tables.setAltText": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -82886,7 +83136,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.clearStyle": {
+                            "tables.setStyle": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -82921,7 +83171,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setStyleOption": {
+                            "tables.clearStyle": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -82956,7 +83206,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setBorder": {
+                            "tables.setStyleOption": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -82991,7 +83241,7 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.clearBorder": {
+                            "tables.setBorder": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -83026,7 +83276,42 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.applyBorderPreset": {
+                            "tables.clearBorder": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
+                            "tables.applyBorderPreset": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -83376,6 +83661,41 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
+                            "tables.applyPreset": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
                             "tables.get": {
                                 "type": "object",
                                 "properties": {
@@ -90130,6 +90450,181 @@ const CONTRACT = {
                                     "tracked",
                                     "dryRun"
                                 ]
+                            },
+                            "customXml.parts.list": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
+                            "customXml.parts.get": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
+                            "customXml.parts.create": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
+                            "customXml.parts.patch": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
+                            "customXml.parts.remove": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
                             }
                         },
                         "additionalProperties": false,
@@ -90244,6 +90739,7 @@ const CONTRACT = {
                             "lists.create",
                             "lists.attach",
                             "lists.detach",
+                            "lists.delete",
                             "lists.indent",
                             "lists.outdent",
                             "lists.join",
@@ -90313,6 +90809,7 @@ const CONTRACT = {
                             "tables.unmergeCells",
                             "tables.splitCell",
                             "tables.setCellProperties",
+                            "tables.setCellText",
                             "tables.sort",
                             "tables.setAltText",
                             "tables.setStyle",
@@ -90330,6 +90827,7 @@ const CONTRACT = {
                             "tables.applyStyle",
                             "tables.setBorders",
                             "tables.setTableOptions",
+                            "tables.applyPreset",
                             "tables.get",
                             "tables.getCells",
                             "tables.getProperties",
@@ -90522,7 +91020,12 @@ const CONTRACT = {
                             "permissionRanges.get",
                             "permissionRanges.create",
                             "permissionRanges.remove",
-                            "permissionRanges.updatePrincipal"
+                            "permissionRanges.updatePrincipal",
+                            "customXml.parts.list",
+                            "customXml.parts.get",
+                            "customXml.parts.create",
+                            "customXml.parts.patch",
+                            "customXml.parts.remove"
                         ]
                     },
                     "planEngine": {
@@ -91663,7 +92166,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "delete"
         },
         "doc.tables.clearContents": {
             "operationId": "doc.tables.clearContents",
@@ -93289,7 +93794,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_layout"
         },
         "doc.tables.insertRow": {
             "operationId": "doc.tables.insertRow",
@@ -93300,7 +93807,7 @@ const CONTRACT = {
                 "insert-row"
             ],
             "category": "tables",
-            "description": "Insert a new row into the target table.",
+            "description": "Insert a new row into the target table. The new row is cloned from an adjacent row, so it inherits the existing cell shading, borders, alignment, and padding. No follow-up styling call is needed unless the new row should look different from the rest of the table.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -93409,7 +93916,6 @@ const CONTRACT = {
                     "name": "position",
                     "kind": "flag",
                     "type": "string",
-                    "required": true,
                     "schema": {
                         "oneOf": [
                             {
@@ -93524,6 +94030,48 @@ const CONTRACT = {
                             "rowIndex",
                             "position"
                         ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "target": {
+                                "$ref": "#/$defs/TableAddress"
+                            },
+                            "nodeId": {
+                                "type": "string"
+                            },
+                            "count": {
+                                "type": "integer",
+                                "minimum": 1
+                            }
+                        },
+                        "additionalProperties": false,
+                        "oneOf": [
+                            {
+                                "required": [
+                                    "target"
+                                ]
+                            },
+                            {
+                                "required": [
+                                    "nodeId"
+                                ]
+                            }
+                        ],
+                        "not": {
+                            "anyOf": [
+                                {
+                                    "required": [
+                                        "rowIndex"
+                                    ]
+                                },
+                                {
+                                    "required": [
+                                        "position"
+                                    ]
+                                }
+                            ]
+                        }
                     }
                 ]
             },
@@ -93642,7 +94190,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "insert_row"
         },
         "doc.tables.deleteRow": {
             "operationId": "doc.tables.deleteRow",
@@ -93941,7 +94491,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "delete_row"
         },
         "doc.tables.setRowHeight": {
             "operationId": "doc.tables.setRowHeight",
@@ -94305,7 +94857,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_row"
         },
         "doc.tables.distributeRows": {
             "operationId": "doc.tables.distributeRows",
@@ -94878,7 +95432,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_row_options"
         },
         "doc.tables.insertColumn": {
             "operationId": "doc.tables.insertColumn",
@@ -94889,7 +95445,7 @@ const CONTRACT = {
                 "insert-column"
             ],
             "category": "tables",
-            "description": "Insert a new column into the target table.",
+            "description": "Insert a new column into the target table. The new column is cloned from an adjacent column, so it inherits the existing cell shading, borders, alignment, and width. No follow-up styling call is needed unless the new column should look different from the rest of the table.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -94981,8 +95537,7 @@ const CONTRACT = {
                     "name": "columnIndex",
                     "kind": "flag",
                     "type": "number",
-                    "flag": "column-index",
-                    "required": true
+                    "flag": "column-index"
                 },
                 {
                     "name": "position",
@@ -94996,6 +95551,12 @@ const CONTRACT = {
                             },
                             {
                                 "const": "right"
+                            },
+                            {
+                                "const": "first"
+                            },
+                            {
+                                "const": "last"
                             }
                         ]
                     }
@@ -95027,7 +95588,9 @@ const CONTRACT = {
                     "position": {
                         "enum": [
                             "left",
-                            "right"
+                            "right",
+                            "first",
+                            "last"
                         ]
                     },
                     "count": {
@@ -95037,7 +95600,6 @@ const CONTRACT = {
                 },
                 "additionalProperties": false,
                 "required": [
-                    "columnIndex",
                     "position"
                 ],
                 "oneOf": [
@@ -95168,7 +95730,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "insert_column"
         },
         "doc.tables.deleteColumn": {
             "operationId": "doc.tables.deleteColumn",
@@ -95426,7 +95990,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "delete_column"
         },
         "doc.tables.setColumnWidth": {
             "operationId": "doc.tables.setColumnWidth",
@@ -95696,7 +96262,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_column"
         },
         "doc.tables.distributeColumns": {
             "operationId": "doc.tables.distributeColumns",
@@ -96845,7 +97413,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "merge_cells"
         },
         "doc.tables.unmergeCells": {
             "operationId": "doc.tables.unmergeCells",
@@ -97172,7 +97742,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "unmerge_cells"
         },
         "doc.tables.splitCell": {
             "operationId": "doc.tables.splitCell",
@@ -97451,7 +98023,7 @@ const CONTRACT = {
                 "set-cell-properties"
             ],
             "category": "tables",
-            "description": "Set properties on a table cell such as vertical alignment or text direction.",
+            "description": "Set non-text properties on a single table cell: vertical alignment, text wrapping, fit-text, or preferred width. Requires a cell-level target (a tableCell block address with kind, nodeType, nodeId). Does NOT accept a table target with rowIndex/columnIndex. To set the text content of a cell, use action \"set_cell_text\" instead.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -97737,21 +98309,23 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_cell"
         },
-        "doc.tables.sort": {
-            "operationId": "doc.tables.sort",
+        "doc.tables.setCellText": {
+            "operationId": "doc.tables.setCellText",
             "sdkSurface": "document",
-            "command": "tables sort",
+            "command": "tables set-cell-text",
             "commandTokens": [
                 "tables",
-                "sort"
+                "set-cell-text"
             ],
             "category": "tables",
-            "description": "Sort table rows by a column value.",
+            "description": "Replace the text content of a single table cell with plain text (one paragraph). Accepts either a direct cell locator (a tableCell block address with kind, nodeType, nodeId) OR a table target with rowIndex + columnIndex. Cell properties (vertical alignment, shading, borders, colspan/rowspan) are preserved. Use this for filling cells with values, replacing cell text, or populating empty tables. Much simpler than walking paragraphs and runs through superdoc_edit.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
-            "responseEnvelopeKey": "result",
+            "responseEnvelopeKey": null,
             "params": [
                 {
                     "name": "doc",
@@ -97811,25 +98385,54 @@ const CONTRACT = {
                     "type": "json",
                     "flag": "target-json",
                     "schema": {
-                        "type": "object",
-                        "properties": {
-                            "kind": {
-                                "const": "block"
-                            },
-                            "nodeType": {
-                                "const": "table"
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "block"
+                                    },
+                                    "nodeType": {
+                                        "const": "tableCell"
+                                    },
+                                    "nodeId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "nodeType",
+                                    "nodeId"
+                                ]
                             },
-                            "nodeId": {
-                                "type": "string"
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "block"
+                                    },
+                                    "nodeType": {
+                                        "const": "table"
+                                    },
+                                    "nodeId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "nodeType",
+                                    "nodeId"
+                                ]
                             }
-                        },
-                        "required": [
-                            "kind",
-                            "nodeType",
-                            "nodeId"
                         ]
                     }
                 },
+                {
+                    "name": "text",
+                    "kind": "flag",
+                    "type": "string",
+                    "required": true
+                },
                 {
                     "name": "nodeId",
                     "kind": "flag",
@@ -97837,111 +98440,107 @@ const CONTRACT = {
                     "flag": "node-id"
                 },
                 {
-                    "name": "keys",
-                    "kind": "jsonFlag",
-                    "type": "json",
-                    "flag": "keys-json",
-                    "required": true,
-                    "schema": {
-                        "type": "array",
-                        "items": {
-                            "type": "object",
-                            "properties": {
-                                "columnIndex": {
-                                    "type": "number"
-                                },
-                                "direction": {
-                                    "oneOf": [
-                                        {
-                                            "const": "ascending"
-                                        },
-                                        {
-                                            "const": "descending"
-                                        }
-                                    ]
-                                },
-                                "type": {
-                                    "oneOf": [
-                                        {
-                                            "const": "text"
-                                        },
-                                        {
-                                            "const": "number"
-                                        },
-                                        {
-                                            "const": "date"
-                                        }
-                                    ]
-                                }
-                            },
-                            "required": [
-                                "columnIndex",
-                                "direction",
-                                "type"
-                            ]
-                        }
-                    }
+                    "name": "rowIndex",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "row-index"
+                },
+                {
+                    "name": "columnIndex",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "column-index"
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "non-idempotent",
+            "idempotency": "idempotent",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
-                "type": "object",
-                "properties": {
-                    "target": {
-                        "$ref": "#/$defs/TableAddress"
-                    },
-                    "nodeId": {
-                        "type": "string"
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "target": {
+                                "$ref": "#/$defs/TableCellAddress"
+                            },
+                            "text": {
+                                "type": "string"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "target",
+                            "text"
+                        ]
                     },
-                    "keys": {
-                        "type": "array",
-                        "items": {
-                            "type": "object",
-                            "properties": {
-                                "columnIndex": {
-                                    "type": "integer",
-                                    "minimum": 0
-                                },
-                                "direction": {
-                                    "enum": [
-                                        "ascending",
-                                        "descending"
-                                    ]
-                                },
-                                "type": {
-                                    "enum": [
-                                        "text",
-                                        "number",
-                                        "date"
-                                    ]
-                                }
+                    {
+                        "type": "object",
+                        "properties": {
+                            "nodeId": {
+                                "type": "string"
                             },
-                            "additionalProperties": false,
-                            "required": [
-                                "columnIndex",
-                                "direction",
-                                "type"
-                            ]
-                        }
-                    }
-                },
-                "additionalProperties": false,
-                "required": [
-                    "keys"
-                ],
-                "oneOf": [
+                            "text": {
+                                "type": "string"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "nodeId",
+                            "text"
+                        ]
+                    },
                     {
+                        "type": "object",
+                        "properties": {
+                            "target": {
+                                "$ref": "#/$defs/TableAddress"
+                            },
+                            "rowIndex": {
+                                "type": "integer",
+                                "minimum": 0
+                            },
+                            "columnIndex": {
+                                "type": "integer",
+                                "minimum": 0
+                            },
+                            "text": {
+                                "type": "string"
+                            }
+                        },
+                        "additionalProperties": false,
                         "required": [
-                            "target"
+                            "target",
+                            "rowIndex",
+                            "columnIndex",
+                            "text"
                         ]
                     },
                     {
+                        "type": "object",
+                        "properties": {
+                            "nodeId": {
+                                "type": "string"
+                            },
+                            "rowIndex": {
+                                "type": "integer",
+                                "minimum": 0
+                            },
+                            "columnIndex": {
+                                "type": "integer",
+                                "minimum": 0
+                            },
+                            "text": {
+                                "type": "string"
+                            }
+                        },
+                        "additionalProperties": false,
                         "required": [
-                            "nodeId"
+                            "nodeId",
+                            "rowIndex",
+                            "columnIndex",
+                            "text"
                         ]
                     }
                 ]
@@ -98061,18 +98660,20 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_cell_text"
         },
-        "doc.tables.setAltText": {
-            "operationId": "doc.tables.setAltText",
+        "doc.tables.sort": {
+            "operationId": "doc.tables.sort",
             "sdkSurface": "document",
-            "command": "tables set-alt-text",
+            "command": "tables sort",
             "commandTokens": [
                 "tables",
-                "set-alt-text"
+                "sort"
             ],
             "category": "tables",
-            "description": "Set the alternative text description for a table.",
+            "description": "Sort table rows by a column value.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -98161,19 +98762,55 @@ const CONTRACT = {
                     "flag": "node-id"
                 },
                 {
-                    "name": "title",
-                    "kind": "flag",
-                    "type": "string"
-                },
-                {
-                    "name": "description",
-                    "kind": "flag",
-                    "type": "string"
+                    "name": "keys",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "keys-json",
+                    "required": true,
+                    "schema": {
+                        "type": "array",
+                        "items": {
+                            "type": "object",
+                            "properties": {
+                                "columnIndex": {
+                                    "type": "number"
+                                },
+                                "direction": {
+                                    "oneOf": [
+                                        {
+                                            "const": "ascending"
+                                        },
+                                        {
+                                            "const": "descending"
+                                        }
+                                    ]
+                                },
+                                "type": {
+                                    "oneOf": [
+                                        {
+                                            "const": "text"
+                                        },
+                                        {
+                                            "const": "number"
+                                        },
+                                        {
+                                            "const": "date"
+                                        }
+                                    ]
+                                }
+                            },
+                            "required": [
+                                "columnIndex",
+                                "direction",
+                                "type"
+                            ]
+                        }
+                    }
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "idempotent",
+            "idempotency": "non-idempotent",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
@@ -98185,14 +98822,42 @@ const CONTRACT = {
                     "nodeId": {
                         "type": "string"
                     },
-                    "title": {
-                        "type": "string"
-                    },
-                    "description": {
-                        "type": "string"
+                    "keys": {
+                        "type": "array",
+                        "items": {
+                            "type": "object",
+                            "properties": {
+                                "columnIndex": {
+                                    "type": "integer",
+                                    "minimum": 0
+                                },
+                                "direction": {
+                                    "enum": [
+                                        "ascending",
+                                        "descending"
+                                    ]
+                                },
+                                "type": {
+                                    "enum": [
+                                        "text",
+                                        "number",
+                                        "date"
+                                    ]
+                                }
+                            },
+                            "additionalProperties": false,
+                            "required": [
+                                "columnIndex",
+                                "direction",
+                                "type"
+                            ]
+                        }
                     }
                 },
                 "additionalProperties": false,
+                "required": [
+                    "keys"
+                ],
                 "oneOf": [
                     {
                         "required": [
@@ -98323,16 +98988,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.setStyle": {
-            "operationId": "doc.tables.setStyle",
+        "doc.tables.setAltText": {
+            "operationId": "doc.tables.setAltText",
             "sdkSurface": "document",
-            "command": "tables set-style",
+            "command": "tables set-alt-text",
             "commandTokens": [
                 "tables",
-                "set-style"
+                "set-alt-text"
             ],
             "category": "tables",
-            "description": "Apply a named table style to the target table.",
+            "description": "Set the alternative text description for a table.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -98421,11 +99086,14 @@ const CONTRACT = {
                     "flag": "node-id"
                 },
                 {
-                    "name": "styleId",
+                    "name": "title",
                     "kind": "flag",
-                    "type": "string",
-                    "flag": "style-id",
-                    "required": true
+                    "type": "string"
+                },
+                {
+                    "name": "description",
+                    "kind": "flag",
+                    "type": "string"
                 }
             ],
             "constraints": null,
@@ -98442,14 +99110,14 @@ const CONTRACT = {
                     "nodeId": {
                         "type": "string"
                     },
-                    "styleId": {
+                    "title": {
+                        "type": "string"
+                    },
+                    "description": {
                         "type": "string"
                     }
                 },
                 "additionalProperties": false,
-                "required": [
-                    "styleId"
-                ],
                 "oneOf": [
                     {
                         "required": [
@@ -98580,16 +99248,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.clearStyle": {
-            "operationId": "doc.tables.clearStyle",
+        "doc.tables.setStyle": {
+            "operationId": "doc.tables.setStyle",
             "sdkSurface": "document",
-            "command": "tables clear-style",
+            "command": "tables set-style",
             "commandTokens": [
                 "tables",
-                "clear-style"
+                "set-style"
             ],
             "category": "tables",
-            "description": "Remove the applied table style, reverting to defaults.",
+            "description": "Apply a named table style to the target table.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -98676,11 +99344,18 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "flag": "node-id"
+                },
+                {
+                    "name": "styleId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "style-id",
+                    "required": true
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "conditional",
+            "idempotency": "idempotent",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
@@ -98691,9 +99366,15 @@ const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
+                    },
+                    "styleId": {
+                        "type": "string"
                     }
                 },
                 "additionalProperties": false,
+                "required": [
+                    "styleId"
+                ],
                 "oneOf": [
                     {
                         "required": [
@@ -98824,16 +99505,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.setStyleOption": {
-            "operationId": "doc.tables.setStyleOption",
+        "doc.tables.clearStyle": {
+            "operationId": "doc.tables.clearStyle",
             "sdkSurface": "document",
-            "command": "tables set-style-option",
+            "command": "tables clear-style",
             "commandTokens": [
                 "tables",
-                "set-style-option"
+                "clear-style"
             ],
             "category": "tables",
-            "description": "Toggle a conditional style option such as banded rows or first column.",
+            "description": "Remove the applied table style, reverting to defaults.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -98920,48 +99601,11 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "flag": "node-id"
-                },
-                {
-                    "name": "flag",
-                    "kind": "flag",
-                    "type": "string",
-                    "required": true,
-                    "schema": {
-                        "oneOf": [
-                            {
-                                "const": "headerRow"
-                            },
-                            {
-                                "const": "lastRow"
-                            },
-                            {
-                                "const": "totalRow"
-                            },
-                            {
-                                "const": "firstColumn"
-                            },
-                            {
-                                "const": "lastColumn"
-                            },
-                            {
-                                "const": "bandedRows"
-                            },
-                            {
-                                "const": "bandedColumns"
-                            }
-                        ]
-                    }
-                },
-                {
-                    "name": "enabled",
-                    "kind": "flag",
-                    "type": "boolean",
-                    "required": true
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "idempotent",
+            "idempotency": "conditional",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
@@ -98972,27 +99616,9 @@ const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
-                    },
-                    "flag": {
-                        "enum": [
-                            "headerRow",
-                            "lastRow",
-                            "totalRow",
-                            "firstColumn",
-                            "lastColumn",
-                            "bandedRows",
-                            "bandedColumns"
-                        ]
-                    },
-                    "enabled": {
-                        "type": "boolean"
                     }
                 },
                 "additionalProperties": false,
-                "required": [
-                    "flag",
-                    "enabled"
-                ],
                 "oneOf": [
                     {
                         "required": [
@@ -99123,16 +99749,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.setBorder": {
-            "operationId": "doc.tables.setBorder",
+        "doc.tables.setStyleOption": {
+            "operationId": "doc.tables.setStyleOption",
             "sdkSurface": "document",
-            "command": "tables set-border",
+            "command": "tables set-style-option",
             "commandTokens": [
                 "tables",
-                "set-border"
+                "set-style-option"
             ],
             "category": "tables",
-            "description": "Set border properties on a table or cell range.",
+            "description": "Toggle a conditional style option such as banded rows or first column.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -99201,14 +99827,7 @@ const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "oneOf": [
-                                    {
-                                        "const": "table"
-                                    },
-                                    {
-                                        "const": "tableCell"
-                                    }
-                                ]
+                                "const": "table"
                             },
                             "nodeId": {
                                 "type": "string"
@@ -99228,57 +99847,40 @@ const CONTRACT = {
                     "flag": "node-id"
                 },
                 {
-                    "name": "edge",
+                    "name": "flag",
                     "kind": "flag",
                     "type": "string",
                     "required": true,
                     "schema": {
                         "oneOf": [
                             {
-                                "const": "top"
-                            },
-                            {
-                                "const": "bottom"
+                                "const": "headerRow"
                             },
                             {
-                                "const": "left"
+                                "const": "lastRow"
                             },
                             {
-                                "const": "right"
+                                "const": "totalRow"
                             },
                             {
-                                "const": "insideH"
+                                "const": "firstColumn"
                             },
                             {
-                                "const": "insideV"
+                                "const": "lastColumn"
                             },
                             {
-                                "const": "diagonalDown"
+                                "const": "bandedRows"
                             },
                             {
-                                "const": "diagonalUp"
+                                "const": "bandedColumns"
                             }
                         ]
                     }
                 },
                 {
-                    "name": "lineStyle",
-                    "kind": "flag",
-                    "type": "string",
-                    "flag": "line-style",
-                    "required": true
-                },
-                {
-                    "name": "lineWeightPt",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "line-weight-pt",
-                    "required": true
-                },
-                {
-                    "name": "color",
+                    "name": "enabled",
                     "kind": "flag",
-                    "type": "string",
+                    "type": "boolean",
                     "required": true
                 }
             ],
@@ -99291,41 +99893,30 @@ const CONTRACT = {
                 "type": "object",
                 "properties": {
                     "target": {
-                        "$ref": "#/$defs/TableOrCellAddress"
+                        "$ref": "#/$defs/TableAddress"
                     },
                     "nodeId": {
                         "type": "string"
                     },
-                    "edge": {
+                    "flag": {
                         "enum": [
-                            "top",
-                            "bottom",
-                            "left",
-                            "right",
-                            "insideH",
-                            "insideV",
-                            "diagonalDown",
-                            "diagonalUp"
+                            "headerRow",
+                            "lastRow",
+                            "totalRow",
+                            "firstColumn",
+                            "lastColumn",
+                            "bandedRows",
+                            "bandedColumns"
                         ]
                     },
-                    "lineStyle": {
-                        "type": "string"
-                    },
-                    "lineWeightPt": {
-                        "type": "number",
-                        "exclusiveMinimum": 0
-                    },
-                    "color": {
-                        "type": "string",
-                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                    "enabled": {
+                        "type": "boolean"
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "edge",
-                    "lineStyle",
-                    "lineWeightPt",
-                    "color"
+                    "flag",
+                    "enabled"
                 ],
                 "oneOf": [
                     {
@@ -99457,16 +100048,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.clearBorder": {
-            "operationId": "doc.tables.clearBorder",
+        "doc.tables.setBorder": {
+            "operationId": "doc.tables.setBorder",
             "sdkSurface": "document",
-            "command": "tables clear-border",
+            "command": "tables set-border",
             "commandTokens": [
                 "tables",
-                "clear-border"
+                "set-border"
             ],
             "category": "tables",
-            "description": "Remove border formatting from a table or cell range.",
+            "description": "Set border properties on a table or cell range.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -99594,11 +100185,31 @@ const CONTRACT = {
                             }
                         ]
                     }
+                },
+                {
+                    "name": "lineStyle",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "line-style",
+                    "required": true
+                },
+                {
+                    "name": "lineWeightPt",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "line-weight-pt",
+                    "required": true
+                },
+                {
+                    "name": "color",
+                    "kind": "flag",
+                    "type": "string",
+                    "required": true
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "conditional",
+            "idempotency": "idempotent",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
@@ -99621,11 +100232,25 @@ const CONTRACT = {
                             "diagonalDown",
                             "diagonalUp"
                         ]
+                    },
+                    "lineStyle": {
+                        "type": "string"
+                    },
+                    "lineWeightPt": {
+                        "type": "number",
+                        "exclusiveMinimum": 0
+                    },
+                    "color": {
+                        "type": "string",
+                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "edge"
+                    "edge",
+                    "lineStyle",
+                    "lineWeightPt",
+                    "color"
                 ],
                 "oneOf": [
                     {
@@ -99757,16 +100382,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.applyBorderPreset": {
-            "operationId": "doc.tables.applyBorderPreset",
+        "doc.tables.clearBorder": {
+            "operationId": "doc.tables.clearBorder",
             "sdkSurface": "document",
-            "command": "tables apply-border-preset",
+            "command": "tables clear-border",
             "commandTokens": [
                 "tables",
-                "apply-border-preset"
+                "clear-border"
             ],
             "category": "tables",
-            "description": "Apply a border preset (e.g. all borders, outside only) to a table.",
+            "description": "Remove border formatting from a table or cell range.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -99835,7 +100460,14 @@ const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "const": "table"
+                                "oneOf": [
+                                    {
+                                        "const": "table"
+                                    },
+                                    {
+                                        "const": "tableCell"
+                                    }
+                                ]
                             },
                             "nodeId": {
                                 "type": "string"
@@ -99855,26 +100487,35 @@ const CONTRACT = {
                     "flag": "node-id"
                 },
                 {
-                    "name": "preset",
+                    "name": "edge",
                     "kind": "flag",
                     "type": "string",
                     "required": true,
                     "schema": {
                         "oneOf": [
                             {
-                                "const": "box"
+                                "const": "top"
                             },
                             {
-                                "const": "all"
+                                "const": "bottom"
                             },
                             {
-                                "const": "none"
+                                "const": "left"
                             },
                             {
-                                "const": "grid"
+                                "const": "right"
                             },
                             {
-                                "const": "custom"
+                                "const": "insideH"
+                            },
+                            {
+                                "const": "insideV"
+                            },
+                            {
+                                "const": "diagonalDown"
+                            },
+                            {
+                                "const": "diagonalUp"
                             }
                         ]
                     }
@@ -99882,31 +100523,34 @@ const CONTRACT = {
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "idempotent",
+            "idempotency": "conditional",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
                 "type": "object",
                 "properties": {
                     "target": {
-                        "$ref": "#/$defs/TableAddress"
+                        "$ref": "#/$defs/TableOrCellAddress"
                     },
                     "nodeId": {
                         "type": "string"
                     },
-                    "preset": {
+                    "edge": {
                         "enum": [
-                            "box",
-                            "all",
-                            "none",
-                            "grid",
-                            "custom"
+                            "top",
+                            "bottom",
+                            "left",
+                            "right",
+                            "insideH",
+                            "insideV",
+                            "diagonalDown",
+                            "diagonalUp"
                         ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "preset"
+                    "edge"
                 ],
                 "oneOf": [
                     {
@@ -100038,16 +100682,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.setShading": {
-            "operationId": "doc.tables.setShading",
+        "doc.tables.applyBorderPreset": {
+            "operationId": "doc.tables.applyBorderPreset",
             "sdkSurface": "document",
-            "command": "tables set-shading",
+            "command": "tables apply-border-preset",
             "commandTokens": [
                 "tables",
-                "set-shading"
+                "apply-border-preset"
             ],
             "category": "tables",
-            "description": "Set the background shading color on a table or cell range.",
+            "description": "Apply a border preset (e.g. all borders, outside only) to a table.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -100116,14 +100760,7 @@ const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "oneOf": [
-                                    {
-                                        "const": "table"
-                                    },
-                                    {
-                                        "const": "tableCell"
-                                    }
-                                ]
+                                "const": "table"
                             },
                             "nodeId": {
                                 "type": "string"
@@ -100143,10 +100780,29 @@ const CONTRACT = {
                     "flag": "node-id"
                 },
                 {
-                    "name": "color",
+                    "name": "preset",
                     "kind": "flag",
                     "type": "string",
-                    "required": true
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "const": "box"
+                            },
+                            {
+                                "const": "all"
+                            },
+                            {
+                                "const": "none"
+                            },
+                            {
+                                "const": "grid"
+                            },
+                            {
+                                "const": "custom"
+                            }
+                        ]
+                    }
                 }
             ],
             "constraints": null,
@@ -100158,19 +100814,24 @@ const CONTRACT = {
                 "type": "object",
                 "properties": {
                     "target": {
-                        "$ref": "#/$defs/TableOrCellAddress"
+                        "$ref": "#/$defs/TableAddress"
                     },
                     "nodeId": {
                         "type": "string"
                     },
-                    "color": {
-                        "type": "string",
-                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                    "preset": {
+                        "enum": [
+                            "box",
+                            "all",
+                            "none",
+                            "grid",
+                            "custom"
+                        ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "color"
+                    "preset"
                 ],
                 "oneOf": [
                     {
@@ -100302,16 +100963,16 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.tables.clearShading": {
-            "operationId": "doc.tables.clearShading",
+        "doc.tables.setShading": {
+            "operationId": "doc.tables.setShading",
             "sdkSurface": "document",
-            "command": "tables clear-shading",
+            "command": "tables set-shading",
             "commandTokens": [
                 "tables",
-                "clear-shading"
+                "set-shading"
             ],
             "category": "tables",
-            "description": "Remove shading from a table or cell range.",
+            "description": "Set the background shading color on a table or cell range.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -100405,11 +101066,28 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "flag": "node-id"
+                },
+                {
+                    "name": "color",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "color-json",
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "type": "string"
+                            },
+                            {
+                                "type": "json"
+                            }
+                        ]
+                    }
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "conditional",
+            "idempotency": "idempotent",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
@@ -100420,9 +101098,23 @@ const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
+                    },
+                    "color": {
+                        "oneOf": [
+                            {
+                                "type": "string",
+                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
                     }
                 },
                 "additionalProperties": false,
+                "required": [
+                    "color"
+                ],
                 "oneOf": [
                     {
                         "required": [
@@ -100551,18 +101243,20 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_shading"
         },
-        "doc.tables.setTablePadding": {
-            "operationId": "doc.tables.setTablePadding",
+        "doc.tables.clearShading": {
+            "operationId": "doc.tables.clearShading",
             "sdkSurface": "document",
-            "command": "tables set-table-padding",
+            "command": "tables clear-shading",
             "commandTokens": [
                 "tables",
-                "set-table-padding"
+                "clear-shading"
             ],
             "category": "tables",
-            "description": "Set default cell padding for the entire table.",
+            "description": "Remove shading from a table or cell range.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -100631,7 +101325,14 @@ const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "const": "table"
+                                "oneOf": [
+                                    {
+                                        "const": "table"
+                                    },
+                                    {
+                                        "const": "tableCell"
+                                    }
+                                ]
                             },
                             "nodeId": {
                                 "type": "string"
@@ -100649,74 +101350,318 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "flag": "node-id"
-                },
-                {
-                    "name": "topPt",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "top-pt",
-                    "required": true
-                },
-                {
-                    "name": "rightPt",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "right-pt",
-                    "required": true
-                },
-                {
-                    "name": "bottomPt",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "bottom-pt",
-                    "required": true
-                },
-                {
-                    "name": "leftPt",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "left-pt",
-                    "required": true
                 }
             ],
             "constraints": null,
             "mutates": true,
-            "idempotency": "idempotent",
+            "idempotency": "conditional",
             "supportsTrackedMode": false,
             "supportsDryRun": true,
             "inputSchema": {
                 "type": "object",
                 "properties": {
                     "target": {
-                        "$ref": "#/$defs/TableAddress"
+                        "$ref": "#/$defs/TableOrCellAddress"
                     },
                     "nodeId": {
                         "type": "string"
-                    },
-                    "topPt": {
-                        "type": "number",
-                        "minimum": 0
-                    },
-                    "rightPt": {
-                        "type": "number",
-                        "minimum": 0
-                    },
-                    "bottomPt": {
-                        "type": "number",
-                        "minimum": 0
-                    },
-                    "leftPt": {
-                        "type": "number",
-                        "minimum": 0
                     }
                 },
                 "additionalProperties": false,
-                "required": [
-                    "topPt",
-                    "rightPt",
-                    "bottomPt",
-                    "leftPt"
-                ],
+                "oneOf": [
+                    {
+                        "required": [
+                            "target"
+                        ]
+                    },
+                    {
+                        "required": [
+                            "nodeId"
+                        ]
+                    }
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "table": {
+                                "$ref": "#/$defs/TableAddress"
+                            },
+                            "trackedChangeRefs": {
+                                "type": "array",
+                                "items": {
+                                    "$ref": "#/$defs/EntityAddress"
+                                }
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "enum": [
+                                            "NO_OP",
+                                            "INVALID_TARGET",
+                                            "TARGET_NOT_FOUND",
+                                            "CAPABILITY_UNAVAILABLE"
+                                        ]
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "table": {
+                        "$ref": "#/$defs/TableAddress"
+                    },
+                    "trackedChangeRefs": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/$defs/EntityAddress"
+                        }
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "enum": [
+                                    "NO_OP",
+                                    "INVALID_TARGET",
+                                    "TARGET_NOT_FOUND",
+                                    "CAPABILITY_UNAVAILABLE"
+                                ]
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            }
+        },
+        "doc.tables.setTablePadding": {
+            "operationId": "doc.tables.setTablePadding",
+            "sdkSurface": "document",
+            "command": "tables set-table-padding",
+            "commandTokens": [
+                "tables",
+                "set-table-padding"
+            ],
+            "category": "tables",
+            "description": "Set default cell padding for the entire table.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": "result",
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "schema": {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "const": "block"
+                            },
+                            "nodeType": {
+                                "const": "table"
+                            },
+                            "nodeId": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "nodeType",
+                            "nodeId"
+                        ]
+                    }
+                },
+                {
+                    "name": "nodeId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "node-id"
+                },
+                {
+                    "name": "topPt",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "top-pt",
+                    "required": true
+                },
+                {
+                    "name": "rightPt",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "right-pt",
+                    "required": true
+                },
+                {
+                    "name": "bottomPt",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "bottom-pt",
+                    "required": true
+                },
+                {
+                    "name": "leftPt",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "left-pt",
+                    "required": true
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "$ref": "#/$defs/TableAddress"
+                    },
+                    "nodeId": {
+                        "type": "string"
+                    },
+                    "topPt": {
+                        "type": "number",
+                        "minimum": 0
+                    },
+                    "rightPt": {
+                        "type": "number",
+                        "minimum": 0
+                    },
+                    "bottomPt": {
+                        "type": "number",
+                        "minimum": 0
+                    },
+                    "leftPt": {
+                        "type": "number",
+                        "minimum": 0
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "topPt",
+                    "rightPt",
+                    "bottomPt",
+                    "leftPt"
+                ],
                 "oneOf": [
                     {
                         "required": [
@@ -101652,7 +102597,7 @@ const CONTRACT = {
                 "apply-style"
             ],
             "category": "tables",
-            "description": "Apply a table style and/or style options in one call.",
+            "description": "Toggle conditional-format flags (header row, banded rows/columns, first/last column, last row) on a table. Pass `styleOptions` with the flags you want to set or clear (omitted flags stay unchanged). For \"format the first row as a header\" use `styleOptions: { headerRow: true }`. Optional `styleId` applies a named table style. Leave it unset unless you have a styleId from `superdoc_get_content` (no need to invent one).",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": null,
@@ -101981,7 +102926,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_style_options"
         },
         "doc.tables.setBorders": {
             "operationId": "doc.tables.setBorders",
@@ -102407,7 +103354,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -102471,7 +103418,7 @@ const CONTRACT = {
                                                     },
                                                     "color": {
                                                         "type": "string",
-                                                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                                     }
                                                 },
                                                 "additionalProperties": false,
@@ -102500,7 +103447,7 @@ const CONTRACT = {
                                                     },
                                                     "color": {
                                                         "type": "string",
-                                                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                                     }
                                                 },
                                                 "additionalProperties": false,
@@ -102529,7 +103476,7 @@ const CONTRACT = {
                                                     },
                                                     "color": {
                                                         "type": "string",
-                                                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                                     }
                                                 },
                                                 "additionalProperties": false,
@@ -102558,7 +103505,7 @@ const CONTRACT = {
                                                     },
                                                     "color": {
                                                         "type": "string",
-                                                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                                     }
                                                 },
                                                 "additionalProperties": false,
@@ -102587,7 +103534,7 @@ const CONTRACT = {
                                                     },
                                                     "color": {
                                                         "type": "string",
-                                                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                                     }
                                                 },
                                                 "additionalProperties": false,
@@ -102616,7 +103563,7 @@ const CONTRACT = {
                                                     },
                                                     "color": {
                                                         "type": "string",
-                                                        "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                                     }
                                                 },
                                                 "additionalProperties": false,
@@ -102770,7 +103717,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_borders"
         },
         "doc.tables.setTableOptions": {
             "operationId": "doc.tables.setTableOptions",
@@ -103126,21 +104075,23 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_options"
         },
-        "doc.tables.get": {
-            "operationId": "doc.tables.get",
+        "doc.tables.applyPreset": {
+            "operationId": "doc.tables.applyPreset",
             "sdkSurface": "document",
-            "command": "tables get",
+            "command": "tables apply-preset",
             "commandTokens": [
                 "tables",
-                "get"
+                "apply-preset"
             ],
             "category": "tables",
-            "description": "Retrieve table structure and dimensions by locator.",
+            "description": "Apply a named visual preset to a table. Presets: \"grid\" (1pt black borders all around), \"minimal\" (no outer borders, hairline grey row separators + thicker bottom), \"striped\" (banded rows on, 0.5pt grey borders), \"accent\" (filled header row + thick accent top/bottom; defaults to dark blue, override with `accentColor`). Composes set_borders + set_style_options + header-row shading in one call. Available via the document API and `superdoc_mutations` (intentionally NOT exposed as a top-level action on `superdoc_table`. Agents should compose explicit set_borders / set_shading / set_style_options calls so they always pick concrete colors that match the document context).",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
-            "responseEnvelopeKey": "result",
+            "responseEnvelopeKey": null,
             "params": [
                 {
                     "name": "doc",
@@ -103155,6 +104106,45 @@ const CONTRACT = {
                     "flag": "session",
                     "description": "Session ID for multi-session workflows. Optional when only one session is open."
                 },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
                 {
                     "name": "target",
                     "kind": "jsonFlag",
@@ -103185,13 +104175,41 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "flag": "node-id"
+                },
+                {
+                    "name": "preset",
+                    "kind": "flag",
+                    "type": "string",
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "const": "grid"
+                            },
+                            {
+                                "const": "minimal"
+                            },
+                            {
+                                "const": "striped"
+                            },
+                            {
+                                "const": "accent"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "accentColor",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "accent-color"
                 }
             ],
             "constraints": null,
-            "mutates": false,
+            "mutates": true,
             "idempotency": "idempotent",
             "supportsTrackedMode": false,
-            "supportsDryRun": false,
+            "supportsDryRun": true,
             "inputSchema": {
                 "type": "object",
                 "properties": {
@@ -103200,9 +104218,24 @@ const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
+                    },
+                    "preset": {
+                        "enum": [
+                            "grid",
+                            "minimal",
+                            "striped",
+                            "accent"
+                        ]
+                    },
+                    "accentColor": {
+                        "type": "string",
+                        "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                     }
                 },
                 "additionalProperties": false,
+                "required": [
+                    "preset"
+                ],
                 "oneOf": [
                     {
                         "required": [
@@ -103217,42 +104250,132 @@ const CONTRACT = {
                 ]
             },
             "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "table": {
+                                "$ref": "#/$defs/TableAddress"
+                            },
+                            "trackedChangeRefs": {
+                                "type": "array",
+                                "items": {
+                                    "$ref": "#/$defs/EntityAddress"
+                                }
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "enum": [
+                                            "NO_OP",
+                                            "INVALID_TARGET",
+                                            "TARGET_NOT_FOUND",
+                                            "CAPABILITY_UNAVAILABLE"
+                                        ]
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
                 "type": "object",
                 "properties": {
-                    "nodeId": {
-                        "type": "string"
+                    "success": {
+                        "const": true
                     },
-                    "address": {
+                    "table": {
                         "$ref": "#/$defs/TableAddress"
                     },
-                    "rows": {
-                        "type": "integer",
-                        "minimum": 0
+                    "trackedChangeRefs": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/$defs/EntityAddress"
+                        }
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
                     },
-                    "columns": {
-                        "type": "integer",
-                        "minimum": 0
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "enum": [
+                                    "NO_OP",
+                                    "INVALID_TARGET",
+                                    "TARGET_NOT_FOUND",
+                                    "CAPABILITY_UNAVAILABLE"
+                                ]
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "nodeId",
-                    "address",
-                    "rows",
-                    "columns"
+                    "success",
+                    "failure"
                 ]
             }
         },
-        "doc.tables.getCells": {
-            "operationId": "doc.tables.getCells",
+        "doc.tables.get": {
+            "operationId": "doc.tables.get",
             "sdkSurface": "document",
-            "command": "tables get-cells",
+            "command": "tables get",
             "commandTokens": [
                 "tables",
-                "get-cells"
+                "get"
             ],
             "category": "tables",
-            "description": "Retrieve cell information for a table, optionally filtered by row or column.",
+            "description": "Retrieve table structure and dimensions by locator.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -103300,18 +104423,6 @@ const CONTRACT = {
                     "kind": "flag",
                     "type": "string",
                     "flag": "node-id"
-                },
-                {
-                    "name": "rowIndex",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "row-index"
-                },
-                {
-                    "name": "columnIndex",
-                    "kind": "flag",
-                    "type": "number",
-                    "flag": "column-index"
                 }
             ],
             "constraints": null,
@@ -103327,14 +104438,6 @@ const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
-                    },
-                    "rowIndex": {
-                        "type": "integer",
-                        "minimum": 0
-                    },
-                    "columnIndex": {
-                        "type": "integer",
-                        "minimum": 0
                     }
                 },
                 "additionalProperties": false,
@@ -103360,64 +104463,199 @@ const CONTRACT = {
                     "address": {
                         "$ref": "#/$defs/TableAddress"
                     },
-                    "cells": {
-                        "type": "array",
-                        "items": {
-                            "type": "object",
-                            "properties": {
-                                "nodeId": {
-                                    "type": "string"
-                                },
-                                "address": {
-                                    "$ref": "#/$defs/TableCellAddress"
-                                },
-                                "rowIndex": {
-                                    "type": "integer",
-                                    "minimum": 0
-                                },
-                                "columnIndex": {
-                                    "type": "integer",
-                                    "minimum": 0
-                                },
-                                "colspan": {
-                                    "type": "integer",
-                                    "minimum": 1
-                                },
-                                "rowspan": {
-                                    "type": "integer",
-                                    "minimum": 1
-                                }
-                            },
-                            "additionalProperties": false,
-                            "required": [
-                                "nodeId",
-                                "address",
-                                "rowIndex",
-                                "columnIndex",
-                                "colspan",
-                                "rowspan"
-                            ]
-                        }
+                    "rows": {
+                        "type": "integer",
+                        "minimum": 0
+                    },
+                    "columns": {
+                        "type": "integer",
+                        "minimum": 0
                     }
                 },
                 "additionalProperties": false,
                 "required": [
                     "nodeId",
                     "address",
-                    "cells"
+                    "rows",
+                    "columns"
                 ]
             }
         },
-        "doc.tables.getProperties": {
-            "operationId": "doc.tables.getProperties",
+        "doc.tables.getCells": {
+            "operationId": "doc.tables.getCells",
             "sdkSurface": "document",
-            "command": "tables get-properties",
+            "command": "tables get-cells",
             "commandTokens": [
                 "tables",
-                "get-properties"
+                "get-cells"
             ],
             "category": "tables",
-            "description": "Retrieve layout and style properties of a table.",
+            "description": "Retrieve cell information for a table, optionally filtered by row or column.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": "result",
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "schema": {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "const": "block"
+                            },
+                            "nodeType": {
+                                "const": "table"
+                            },
+                            "nodeId": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "nodeType",
+                            "nodeId"
+                        ]
+                    }
+                },
+                {
+                    "name": "nodeId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "node-id"
+                },
+                {
+                    "name": "rowIndex",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "row-index"
+                },
+                {
+                    "name": "columnIndex",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "column-index"
+                }
+            ],
+            "constraints": null,
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "$ref": "#/$defs/TableAddress"
+                    },
+                    "nodeId": {
+                        "type": "string"
+                    },
+                    "rowIndex": {
+                        "type": "integer",
+                        "minimum": 0
+                    },
+                    "columnIndex": {
+                        "type": "integer",
+                        "minimum": 0
+                    }
+                },
+                "additionalProperties": false,
+                "oneOf": [
+                    {
+                        "required": [
+                            "target"
+                        ]
+                    },
+                    {
+                        "required": [
+                            "nodeId"
+                        ]
+                    }
+                ]
+            },
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "nodeId": {
+                        "type": "string"
+                    },
+                    "address": {
+                        "$ref": "#/$defs/TableAddress"
+                    },
+                    "cells": {
+                        "type": "array",
+                        "items": {
+                            "type": "object",
+                            "properties": {
+                                "nodeId": {
+                                    "type": "string"
+                                },
+                                "address": {
+                                    "$ref": "#/$defs/TableCellAddress"
+                                },
+                                "rowIndex": {
+                                    "type": "integer",
+                                    "minimum": 0
+                                },
+                                "columnIndex": {
+                                    "type": "integer",
+                                    "minimum": 0
+                                },
+                                "colspan": {
+                                    "type": "integer",
+                                    "minimum": 1
+                                },
+                                "rowspan": {
+                                    "type": "integer",
+                                    "minimum": 1
+                                }
+                            },
+                            "additionalProperties": false,
+                            "required": [
+                                "nodeId",
+                                "address",
+                                "rowIndex",
+                                "columnIndex",
+                                "colspan",
+                                "rowspan"
+                            ]
+                        }
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "nodeId",
+                    "address",
+                    "cells"
+                ]
+            }
+        },
+        "doc.tables.getProperties": {
+            "operationId": "doc.tables.getProperties",
+            "sdkSurface": "document",
+            "command": "tables get-properties",
+            "commandTokens": [
+                "tables",
+                "get-properties"
+            ],
+            "category": "tables",
+            "description": "Retrieve layout and style properties of a table.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -103572,7 +104810,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -103601,7 +104839,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -103630,7 +104868,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -103659,7 +104897,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -103688,7 +104926,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -103717,7 +104955,7 @@ const CONTRACT = {
                                             },
                                             "color": {
                                                 "type": "string",
-                                                "pattern": "^([0-9A-Fa-f]{6}|auto)$"
+                                                "pattern": "^(#?([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})|auto)$"
                                             }
                                         },
                                         "additionalProperties": false,
@@ -150687,6 +151925,1075 @@ const CONTRACT = {
             },
             "skipAsATool": true
         },
+        "doc.customXml.parts.list": {
+            "operationId": "doc.customXml.parts.list",
+            "sdkSurface": "document",
+            "command": "custom-xml parts list",
+            "commandTokens": [
+                "custom-xml",
+                "parts",
+                "list"
+            ],
+            "category": "core",
+            "description": "List Custom XML Data Storage Parts in the document, optionally filtered by root namespace or schema reference.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "limit",
+                    "kind": "flag",
+                    "type": "number"
+                },
+                {
+                    "name": "offset",
+                    "kind": "flag",
+                    "type": "number"
+                },
+                {
+                    "name": "rootNamespace",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "root-namespace"
+                },
+                {
+                    "name": "schemaRef",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "schema-ref"
+                }
+            ],
+            "constraints": null,
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "limit": {
+                        "type": "integer",
+                        "minimum": 1
+                    },
+                    "offset": {
+                        "type": "integer",
+                        "minimum": 0
+                    },
+                    "rootNamespace": {
+                        "type": "string"
+                    },
+                    "schemaRef": {
+                        "type": "string"
+                    }
+                },
+                "additionalProperties": false
+            },
+            "outputSchema": {
+                "type": "object"
+            }
+        },
+        "doc.customXml.parts.get": {
+            "operationId": "doc.customXml.parts.get",
+            "sdkSurface": "document",
+            "command": "custom-xml parts get",
+            "commandTokens": [
+                "custom-xml",
+                "parts",
+                "get"
+            ],
+            "category": "core",
+            "description": "Get a single Custom XML Data Storage Part by itemID or package part name, including its full content. v1 partName targeting is limited to Word-style customXml/itemN.xml paths.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    }
+                }
+            ],
+            "constraints": null,
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "target"
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object"
+                    },
+                    {
+                        "type": "null"
+                    }
+                ]
+            }
+        },
+        "doc.customXml.parts.create": {
+            "operationId": "doc.customXml.parts.create",
+            "sdkSurface": "document",
+            "command": "custom-xml parts create",
+            "commandTokens": [
+                "custom-xml",
+                "parts",
+                "create"
+            ],
+            "category": "core",
+            "description": "Add a new Custom XML Data Storage Part to the document. Generates a fresh itemID GUID and emits the Properties Part.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "content",
+                    "kind": "flag",
+                    "type": "string",
+                    "required": true
+                },
+                {
+                    "name": "schemaRefs",
+                    "kind": "flag",
+                    "type": "string[]",
+                    "flag": "schema-refs",
+                    "schema": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "non-idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "content": {
+                        "type": "string",
+                        "minLength": 1
+                    },
+                    "schemaRefs": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "minLength": 1
+                        }
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "content"
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "id": {
+                                "type": "string"
+                            },
+                            "partName": {
+                                "type": "string"
+                            },
+                            "propsPartName": {
+                                "type": "string"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "id",
+                            "partName",
+                            "propsPartName"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "type": "string"
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "id": {
+                        "type": "string"
+                    },
+                    "partName": {
+                        "type": "string"
+                    },
+                    "propsPartName": {
+                        "type": "string"
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "id",
+                    "partName",
+                    "propsPartName"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "type": "string"
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            }
+        },
+        "doc.customXml.parts.patch": {
+            "operationId": "doc.customXml.parts.patch",
+            "sdkSurface": "document",
+            "command": "custom-xml parts patch",
+            "commandTokens": [
+                "custom-xml",
+                "parts",
+                "patch"
+            ],
+            "category": "core",
+            "description": "Replace the content and/or schemaRefs of an existing Custom XML Data Storage Part. At least one of content or schemaRefs is required. v1 partName targeting is limited to Word-style customXml/itemN.xml paths.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "content",
+                    "kind": "flag",
+                    "type": "string"
+                },
+                {
+                    "name": "schemaRefs",
+                    "kind": "flag",
+                    "type": "string[]",
+                    "flag": "schema-refs",
+                    "schema": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    },
+                    "content": {
+                        "type": "string",
+                        "minLength": 1
+                    },
+                    "schemaRefs": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "minLength": 1
+                        }
+                    }
+                },
+                "required": [
+                    "target"
+                ],
+                "anyOf": [
+                    {
+                        "required": [
+                            "content"
+                        ]
+                    },
+                    {
+                        "required": [
+                            "schemaRefs"
+                        ]
+                    }
+                ],
+                "additionalProperties": false
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "target": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "id": {
+                                                "type": "string",
+                                                "minLength": 1
+                                            }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                            "id"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "partName": {
+                                                "type": "string",
+                                                "minLength": 1
+                                            }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                            "partName"
+                                        ]
+                                    }
+                                ]
+                            },
+                            "id": {
+                                "type": "string",
+                                "minLength": 1
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "target"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "type": "string"
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "target": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    },
+                    "id": {
+                        "type": "string",
+                        "minLength": 1
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "target"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "type": "string"
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            }
+        },
+        "doc.customXml.parts.remove": {
+            "operationId": "doc.customXml.parts.remove",
+            "sdkSurface": "document",
+            "command": "custom-xml parts remove",
+            "commandTokens": [
+                "custom-xml",
+                "parts",
+                "remove"
+            ],
+            "category": "core",
+            "description": "Remove a Custom XML Data Storage Part and clean up all linked package files (item, props, rels, content-types entry). v1 partName targeting is limited to Word-style customXml/itemN.xml paths.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    }
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "non-idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "target"
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "target": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "id": {
+                                                "type": "string",
+                                                "minLength": 1
+                                            }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                            "id"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "partName": {
+                                                "type": "string",
+                                                "minLength": 1
+                                            }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                            "partName"
+                                        ]
+                                    }
+                                ]
+                            },
+                            "id": {
+                                "type": "string",
+                                "minLength": 1
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "target"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "type": "string"
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "target": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "id": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "id"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "partName": {
+                                        "type": "string",
+                                        "minLength": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "partName"
+                                ]
+                            }
+                        ]
+                    },
+                    "id": {
+                        "type": "string",
+                        "minLength": 1
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "target"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "type": "string"
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            }
+        },
         "doc.open": {
             "operationId": "doc.open",
             "sdkSurface": "client",