@superdoc-dev/sdk 1.8.0 → 1.9.0

package/dist/generated/contract.js

@@ -52576,6 +52576,221 @@ export 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",
@@ -81487,6 +81702,41 @@ export 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": {
@@ -83902,7 +84152,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.sort": {
+                            "tables.setCellText": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -83937,7 +84187,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setAltText": {
+                            "tables.sort": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -83972,7 +84222,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setStyle": {
+                            "tables.setAltText": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -84007,7 +84257,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.clearStyle": {
+                            "tables.setStyle": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -84042,7 +84292,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setStyleOption": {
+                            "tables.clearStyle": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -84077,7 +84327,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.setBorder": {
+                            "tables.setStyleOption": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -84112,7 +84362,7 @@ export const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
-                            "tables.clearBorder": {
+                            "tables.setBorder": {
                                 "type": "object",
                                 "properties": {
                                     "available": {
@@ -84147,7 +84397,42 @@ export 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": {
@@ -84497,6 +84782,41 @@ export 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": {
@@ -91251,6 +91571,181 @@ export 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,
@@ -91365,6 +91860,7 @@ export const CONTRACT = {
                             "lists.create",
                             "lists.attach",
                             "lists.detach",
+                            "lists.delete",
                             "lists.indent",
                             "lists.outdent",
                             "lists.join",
@@ -91434,6 +91930,7 @@ export const CONTRACT = {
                             "tables.unmergeCells",
                             "tables.splitCell",
                             "tables.setCellProperties",
+                            "tables.setCellText",
                             "tables.sort",
                             "tables.setAltText",
                             "tables.setStyle",
@@ -91451,6 +91948,7 @@ export const CONTRACT = {
                             "tables.applyStyle",
                             "tables.setBorders",
                             "tables.setTableOptions",
+                            "tables.applyPreset",
                             "tables.get",
                             "tables.getCells",
                             "tables.getProperties",
@@ -91643,7 +92141,12 @@ export 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": {
@@ -92784,7 +93287,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "delete"
         },
         "doc.tables.clearContents": {
             "operationId": "doc.tables.clearContents",
@@ -94410,7 +94915,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_layout"
         },
         "doc.tables.insertRow": {
             "operationId": "doc.tables.insertRow",
@@ -94421,7 +94928,7 @@ export 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",
@@ -94530,7 +95037,6 @@ export const CONTRACT = {
                     "name": "position",
                     "kind": "flag",
                     "type": "string",
-                    "required": true,
                     "schema": {
                         "oneOf": [
                             {
@@ -94645,6 +95151,48 @@ export 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"
+                                    ]
+                                }
+                            ]
+                        }
                     }
                 ]
             },
@@ -94763,7 +95311,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "insert_row"
         },
         "doc.tables.deleteRow": {
             "operationId": "doc.tables.deleteRow",
@@ -95062,7 +95612,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "delete_row"
         },
         "doc.tables.setRowHeight": {
             "operationId": "doc.tables.setRowHeight",
@@ -95426,7 +95978,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_row"
         },
         "doc.tables.distributeRows": {
             "operationId": "doc.tables.distributeRows",
@@ -95999,7 +96553,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_row_options"
         },
         "doc.tables.insertColumn": {
             "operationId": "doc.tables.insertColumn",
@@ -96010,7 +96566,7 @@ export 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",
@@ -96102,8 +96658,7 @@ export const CONTRACT = {
                     "name": "columnIndex",
                     "kind": "flag",
                     "type": "number",
-                    "flag": "column-index",
-                    "required": true
+                    "flag": "column-index"
                 },
                 {
                     "name": "position",
@@ -96117,6 +96672,12 @@ export const CONTRACT = {
                             },
                             {
                                 "const": "right"
+                            },
+                            {
+                                "const": "first"
+                            },
+                            {
+                                "const": "last"
                             }
                         ]
                     }
@@ -96148,7 +96709,9 @@ export const CONTRACT = {
                     "position": {
                         "enum": [
                             "left",
-                            "right"
+                            "right",
+                            "first",
+                            "last"
                         ]
                     },
                     "count": {
@@ -96158,7 +96721,6 @@ export const CONTRACT = {
                 },
                 "additionalProperties": false,
                 "required": [
-                    "columnIndex",
                     "position"
                 ],
                 "oneOf": [
@@ -96289,7 +96851,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "insert_column"
         },
         "doc.tables.deleteColumn": {
             "operationId": "doc.tables.deleteColumn",
@@ -96547,7 +97111,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "delete_column"
         },
         "doc.tables.setColumnWidth": {
             "operationId": "doc.tables.setColumnWidth",
@@ -96817,7 +97383,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_column"
         },
         "doc.tables.distributeColumns": {
             "operationId": "doc.tables.distributeColumns",
@@ -97966,7 +98534,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "merge_cells"
         },
         "doc.tables.unmergeCells": {
             "operationId": "doc.tables.unmergeCells",
@@ -98293,7 +98863,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "unmerge_cells"
         },
         "doc.tables.splitCell": {
             "operationId": "doc.tables.splitCell",
@@ -98572,7 +99144,7 @@ export 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",
@@ -98858,21 +99430,23 @@ export 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",
@@ -98932,25 +99506,54 @@ export 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",
@@ -98958,111 +99561,107 @@ export 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"
                         ]
                     }
                 ]
@@ -99182,18 +99781,20 @@ export 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",
@@ -99282,19 +99883,55 @@ export 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": {
@@ -99306,14 +99943,42 @@ export 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": [
@@ -99444,16 +100109,16 @@ export 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",
@@ -99542,11 +100207,14 @@ export 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,
@@ -99563,14 +100231,14 @@ export const CONTRACT = {
                     "nodeId": {
                         "type": "string"
                     },
-                    "styleId": {
+                    "title": {
+                        "type": "string"
+                    },
+                    "description": {
                         "type": "string"
                     }
                 },
                 "additionalProperties": false,
-                "required": [
-                    "styleId"
-                ],
                 "oneOf": [
                     {
                         "required": [
@@ -99701,16 +100369,16 @@ export 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",
@@ -99797,11 +100465,18 @@ export 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": {
@@ -99812,9 +100487,15 @@ export const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
+                    },
+                    "styleId": {
+                        "type": "string"
                     }
                 },
                 "additionalProperties": false,
+                "required": [
+                    "styleId"
+                ],
                 "oneOf": [
                     {
                         "required": [
@@ -99945,16 +100626,16 @@ export 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",
@@ -100041,48 +100722,11 @@ export 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": {
@@ -100093,27 +100737,9 @@ export const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
-                    },
-                    "flag": {
-                        "enum": [
-                            "headerRow",
-                            "lastRow",
-                            "totalRow",
-                            "firstColumn",
-                            "lastColumn",
-                            "bandedRows",
-                            "bandedColumns"
-                        ]
-                    },
-                    "enabled": {
-                        "type": "boolean"
                     }
                 },
                 "additionalProperties": false,
-                "required": [
-                    "flag",
-                    "enabled"
-                ],
                 "oneOf": [
                     {
                         "required": [
@@ -100244,16 +100870,16 @@ export 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",
@@ -100322,14 +100948,7 @@ export const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "oneOf": [
-                                    {
-                                        "const": "table"
-                                    },
-                                    {
-                                        "const": "tableCell"
-                                    }
-                                ]
+                                "const": "table"
                             },
                             "nodeId": {
                                 "type": "string"
@@ -100349,57 +100968,40 @@ export 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
                 }
             ],
@@ -100412,41 +101014,30 @@ export 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": [
                     {
@@ -100578,16 +101169,16 @@ export 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",
@@ -100715,11 +101306,31 @@ export 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": {
@@ -100742,11 +101353,25 @@ export 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": [
                     {
@@ -100878,16 +101503,16 @@ export 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",
@@ -100956,7 +101581,14 @@ export const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "const": "table"
+                                "oneOf": [
+                                    {
+                                        "const": "table"
+                                    },
+                                    {
+                                        "const": "tableCell"
+                                    }
+                                ]
                             },
                             "nodeId": {
                                 "type": "string"
@@ -100976,26 +101608,35 @@ export 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"
                             }
                         ]
                     }
@@ -101003,31 +101644,34 @@ export 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": [
                     {
@@ -101159,16 +101803,16 @@ export 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",
@@ -101237,14 +101881,7 @@ export const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "oneOf": [
-                                    {
-                                        "const": "table"
-                                    },
-                                    {
-                                        "const": "tableCell"
-                                    }
-                                ]
+                                "const": "table"
                             },
                             "nodeId": {
                                 "type": "string"
@@ -101264,10 +101901,29 @@ export 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,
@@ -101279,19 +101935,24 @@ export 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": [
                     {
@@ -101423,16 +102084,16 @@ export 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",
@@ -101526,11 +102187,28 @@ export 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": {
@@ -101541,9 +102219,23 @@ export 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": [
@@ -101672,18 +102364,20 @@ export 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",
@@ -101752,7 +102446,14 @@ export const CONTRACT = {
                                 "const": "block"
                             },
                             "nodeType": {
-                                "const": "table"
+                                "oneOf": [
+                                    {
+                                        "const": "table"
+                                    },
+                                    {
+                                        "const": "tableCell"
+                                    }
+                                ]
                             },
                             "nodeId": {
                                 "type": "string"
@@ -101770,74 +102471,318 @@ export 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": [
@@ -102773,7 +103718,7 @@ export 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,
@@ -103102,7 +104047,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_style_options"
         },
         "doc.tables.setBorders": {
             "operationId": "doc.tables.setBorders",
@@ -103528,7 +104475,7 @@ export 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,
@@ -103592,7 +104539,7 @@ export 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,
@@ -103621,7 +104568,7 @@ export 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,
@@ -103650,7 +104597,7 @@ export 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,
@@ -103679,7 +104626,7 @@ export 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,
@@ -103708,7 +104655,7 @@ export 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,
@@ -103737,7 +104684,7 @@ export 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,
@@ -103891,7 +104838,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "table",
+            "intentAction": "set_borders"
         },
         "doc.tables.setTableOptions": {
             "operationId": "doc.tables.setTableOptions",
@@ -104247,21 +105196,23 @@ export 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",
@@ -104276,6 +105227,45 @@ export 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",
@@ -104306,13 +105296,41 @@ export 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": {
@@ -104321,9 +105339,24 @@ export 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": [
@@ -104338,42 +105371,132 @@ export 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",
@@ -104421,18 +105544,6 @@ export 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,
@@ -104448,14 +105559,6 @@ export const CONTRACT = {
                     },
                     "nodeId": {
                         "type": "string"
-                    },
-                    "rowIndex": {
-                        "type": "integer",
-                        "minimum": 0
-                    },
-                    "columnIndex": {
-                        "type": "integer",
-                        "minimum": 0
                     }
                 },
                 "additionalProperties": false,
@@ -104481,64 +105584,199 @@ export 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",
@@ -104693,7 +105931,7 @@ export 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,
@@ -104722,7 +105960,7 @@ export 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,
@@ -104751,7 +105989,7 @@ export 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,
@@ -104780,7 +106018,7 @@ export 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,
@@ -104809,7 +106047,7 @@ export 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,
@@ -104838,7 +106076,7 @@ export 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,
@@ -151808,6 +153046,1075 @@ export 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",