@superdoc-dev/sdk 1.19.1 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.19.1",
+  "version": "1.20.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,17 +26,18 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc-dev/sdk-darwin-arm64": "1.19.1",
-    "@superdoc-dev/sdk-linux-x64": "1.19.1",
-    "@superdoc-dev/sdk-linux-arm64": "1.19.1",
-    "@superdoc-dev/sdk-darwin-x64": "1.19.1",
-    "@superdoc-dev/sdk-windows-x64": "1.19.1"
+    "@superdoc-dev/sdk-darwin-arm64": "1.20.0",
+    "@superdoc-dev/sdk-darwin-x64": "1.20.0",
+    "@superdoc-dev/sdk-linux-x64": "1.20.0",
+    "@superdoc-dev/sdk-windows-x64": "1.20.0",
+    "@superdoc-dev/sdk-linux-arm64": "1.20.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsc && rollup -c rollup.cjs.config.mjs",
-    "typecheck": "tsc --noEmit"
+    "build": "node scripts/embed-prompts.mjs && tsc && rollup -c rollup.cjs.config.mjs && rm -rf dist/prompts && mkdir -p dist/prompts && cp src/prompts/*.md dist/prompts/",
+    "typecheck": "tsc --noEmit",
+    "smoke:product-action": "node scripts/product-action-smoke.mjs"
   }
 }

package/tools/catalog.json

@@ -4600,7 +4600,7 @@
     },
     {
       "toolName": "superdoc_comment",
-      "description": "Manage document comment threads: create, read, update, and delete. To create a comment, first use superdoc_search to find the target text, then pass action \"create\" with the comment text and a target built from items[0].blocks. For a single-block match use {kind:\"text\", blockId: items[0].blocks[0].blockId, range: items[0].blocks[0].range}. For a cross-block match use {kind:\"text\", segments: items[0].blocks.map(b => ({blockId: b.blockId, range: b.range}))}. Do NOT use items[0].highlightRange (snippet-relative, not block-relative) or items[0].target (a SelectionTarget, not accepted by comments.create). For threaded replies, pass \"parentId\" with the parent comment ID. Action \"list\" returns all comments with optional pagination (limit, offset) and filtering (includeResolved:true to include resolved). Action \"get\" retrieves a single comment by ID. Action \"update\" changes comment text, re-anchors the thread, or changes status to \"resolved\". The legacy `isInternal` field remains in schema for v1 compatibility but the v2 surface rejects it with `CAPABILITY_UNAVAILABLE`. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; only \"action\", \"text\", and \"target\" are needed.\n\nEXAMPLES:\n  1. {\"action\":\"create\",\"text\":\"Please review this section.\",\"target\":{\"kind\":\"text\",\"blockId\":\"<blockId>\",\"range\":{\"start\":5,\"end\":25}}}\n  2. {\"action\":\"list\",\"limit\":20,\"offset\":0}\n  3. {\"action\":\"update\",\"id\":\"<commentId>\",\"status\":\"resolved\"}\n  4. {\"action\":\"delete\",\"id\":\"<commentId>\"}",
+      "description": "Manage document comment threads: create, read, update, and delete. To create a comment, first use superdoc_search to find the target text, then pass action \"create\" with the comment text and a target built from items[0].blocks. For a single-block match use {kind:\"text\", blockId: items[0].blocks[0].blockId, range: items[0].blocks[0].range}. For a cross-block match use {kind:\"text\", segments: items[0].blocks.map(b => ({blockId: b.blockId, range: b.range}))}. Do NOT use items[0].highlightRange (snippet-relative, not block-relative) or items[0].target (a SelectionTarget, not accepted by comments.create). For threaded replies, pass \"parentId\" with the parent comment ID. Action \"list\" returns all comments with optional pagination (limit, offset) and filtering (includeResolved:true to include resolved). Action \"get\" retrieves a single comment by ID. Action \"update\" changes comment text, re-anchors the thread, or changes status to \"resolved\". The legacy `isInternal` field remains in schema for v1 compatibility but is not supported for new comment patch behavior. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; only \"action\", \"text\", and \"target\" are needed.\n\nEXAMPLES:\n  1. {\"action\":\"create\",\"text\":\"Please review this section.\",\"target\":{\"kind\":\"text\",\"blockId\":\"<blockId>\",\"range\":{\"start\":5,\"end\":25}}}\n  2. {\"action\":\"list\",\"limit\":20,\"offset\":0}\n  3. {\"action\":\"update\",\"id\":\"<commentId>\",\"status\":\"resolved\"}\n  4. {\"action\":\"delete\",\"id\":\"<commentId>\"}",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -4742,7 +4742,7 @@
           },
           "isInternal": {
             "type": "boolean",
-            "description": "Legacy v1/document-api compatibility field. Not a supported v2 behavior. V2 adapters MUST reject a `comments.patch` request containing `isInternal` with `CAPABILITY_UNAVAILABLE` (kernel reason `internal-comments-unsupported`). The field is preserved in the schema only so v1 callers keep their input shape (`comments-spec.md` §7, §14.6). Only for action 'update'. Omit for other actions."
+            "description": "Legacy v1/document-api compatibility field. Not supported for new comment patch behavior. A `comments.patch` request containing `isInternal` fails with `CAPABILITY_UNAVAILABLE` (kernel reason `internal-comments-unsupported`). The field is preserved in the schema only so v1 callers keep their input shape (`comments-spec.md` §7, §14.6). Only for action 'update'. Omit for other actions."
           },
           "includeResolved": {
             "type": "boolean",
@@ -4889,6 +4889,13 @@
                       "destination"
                     ],
                     "description": "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
+                  },
+                  "side": {
+                    "enum": [
+                      "inserted",
+                      "deleted"
+                    ],
+                    "description": "Optional replacement side. When the id resolves to a paired replacement, decides only the 'inserted' or 'deleted' half, leaving the other half as a standalone pending change."
                   }
                 },
                 "additionalProperties": false,
@@ -5087,6 +5094,13 @@
                       "destination"
                     ],
                     "description": "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
+                  },
+                  "side": {
+                    "enum": [
+                      "inserted",
+                      "deleted"
+                    ],
+                    "description": "Optional replacement side. When the id resolves to a paired replacement, decides only the 'inserted' or 'deleted' half."
                   }
                 },
                 "additionalProperties": false,
@@ -7433,7 +7447,6 @@
               "insert_column",
               "insert_row",
               "merge_cells",
-              "move_row",
               "set_borders",
               "set_cell",
               "set_cell_text",
@@ -7446,7 +7459,7 @@
               "set_style_options",
               "unmerge_cells"
             ],
-            "description": "The action to perform. One of: delete, delete_column, delete_row, insert_column, insert_row, merge_cells, move_row, set_borders, set_cell, set_cell_text, set_column, set_layout, set_options, set_row, set_row_options, set_shading, set_style_options, unmerge_cells."
+            "description": "The action to perform. One of: delete, delete_column, delete_row, insert_column, insert_row, merge_cells, set_borders, set_cell, set_cell_text, set_column, set_layout, set_options, set_row, set_row_options, set_shading, set_style_options, unmerge_cells."
           },
           "force": {
             "type": "boolean",
@@ -7494,34 +7507,20 @@
                                                                 "oneOf": [
                                                                   {
                                                                     "oneOf": [
+                                                                      {
+                                                                        "$ref": "#/$defs/TableAddress"
+                                                                      },
                                                                       {
                                                                         "oneOf": [
-                                                                          {
-                                                                            "$ref": "#/$defs/TableAddress"
-                                                                          },
                                                                           {
                                                                             "oneOf": [
                                                                               {
-                                                                                "oneOf": [
-                                                                                  {
-                                                                                    "$ref": "#/$defs/TableRowAddress"
-                                                                                  },
-                                                                                  {
-                                                                                    "$ref": "#/$defs/TableAddress"
-                                                                                  }
-                                                                                ]
+                                                                                "$ref": "#/$defs/TableRowAddress"
                                                                               },
                                                                               {
                                                                                 "$ref": "#/$defs/TableAddress"
                                                                               }
                                                                             ]
-                                                                          }
-                                                                        ]
-                                                                      },
-                                                                      {
-                                                                        "oneOf": [
-                                                                          {
-                                                                            "$ref": "#/$defs/TableRowAddress"
                                                                           },
                                                                           {
                                                                             "$ref": "#/$defs/TableAddress"
@@ -7697,142 +7696,7 @@
           "rowIndex": {
             "type": "integer",
             "minimum": 0,
-            "description": "Only for actions 'insert_row', 'delete_row', 'move_row', 'set_row', 'set_row_options', 'unmerge_cells', 'set_cell_text'. Omit for other actions."
-          },
-          "destination": {
-            "oneOf": [
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "first",
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "last",
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "before",
-                    "type": "string"
-                  },
-                  "rowIndex": {
-                    "type": "integer",
-                    "minimum": 0
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "rowIndex"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "after",
-                    "type": "string"
-                  },
-                  "rowIndex": {
-                    "type": "integer",
-                    "minimum": 0
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "rowIndex"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "before",
-                    "type": "string"
-                  },
-                  "target": {
-                    "$ref": "#/$defs/TableRowAddress"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "target"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "after",
-                    "type": "string"
-                  },
-                  "target": {
-                    "$ref": "#/$defs/TableRowAddress"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "target"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "before",
-                    "type": "string"
-                  },
-                  "nodeId": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "nodeId"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "after",
-                    "type": "string"
-                  },
-                  "nodeId": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "nodeId"
-                ]
-              }
-            ],
-            "description": "Required for action 'move_row'."
+            "description": "Only for actions 'insert_row', 'delete_row', 'set_row', 'set_row_options', 'unmerge_cells', 'set_cell_text'. Omit for other actions."
           },
           "heightPt": {
             "type": "number",
@@ -8375,26 +8239,6 @@
             ]
           ]
         },
-        {
-          "operationId": "doc.tables.moveRow",
-          "intentAction": "move_row",
-          "requiredOneOf": [
-            [
-              "target",
-              "destination"
-            ],
-            [
-              "target",
-              "rowIndex",
-              "destination"
-            ],
-            [
-              "nodeId",
-              "rowIndex",
-              "destination"
-            ]
-          ]
-        },
         {
           "operationId": "doc.tables.setRowHeight",
           "intentAction": "set_row",

package/tools/intent_dispatch_generated.py

@@ -149,8 +149,6 @@ def dispatch_intent_tool(
             return execute('doc.tables.insertRow', rest)
         elif action == 'delete_row':
             return execute('doc.tables.deleteRow', rest)
-        elif action == 'move_row':
-            return execute('doc.tables.moveRow', rest)
         elif action == 'set_row':
             return execute('doc.tables.setRowHeight', rest)
         elif action == 'set_row_options':

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "a870119c850007e1b994fcaa36fcc58302b9e340657fe3634f589a83daf309fb"
+  "contractHash": "2954ad7f0581c8cbaa8903cf227429d4bc1c0ca550a663f3b5bd28449323717f"
 }

package/tools/tools.anthropic.json

@@ -4322,7 +4322,7 @@
     },
     {
       "name": "superdoc_comment",
-      "description": "Manage document comment threads: create, read, update, and delete. To create a comment, first use superdoc_search to find the target text, then pass action \"create\" with the comment text and a target built from items[0].blocks. For a single-block match use {kind:\"text\", blockId: items[0].blocks[0].blockId, range: items[0].blocks[0].range}. For a cross-block match use {kind:\"text\", segments: items[0].blocks.map(b => ({blockId: b.blockId, range: b.range}))}. Do NOT use items[0].highlightRange (snippet-relative, not block-relative) or items[0].target (a SelectionTarget, not accepted by comments.create). For threaded replies, pass \"parentId\" with the parent comment ID. Action \"list\" returns all comments with optional pagination (limit, offset) and filtering (includeResolved:true to include resolved). Action \"get\" retrieves a single comment by ID. Action \"update\" changes comment text, re-anchors the thread, or changes status to \"resolved\". The legacy `isInternal` field remains in schema for v1 compatibility but the v2 surface rejects it with `CAPABILITY_UNAVAILABLE`. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; only \"action\", \"text\", and \"target\" are needed.\n\nEXAMPLES:\n  1. {\"action\":\"create\",\"text\":\"Please review this section.\",\"target\":{\"kind\":\"text\",\"blockId\":\"<blockId>\",\"range\":{\"start\":5,\"end\":25}}}\n  2. {\"action\":\"list\",\"limit\":20,\"offset\":0}\n  3. {\"action\":\"update\",\"id\":\"<commentId>\",\"status\":\"resolved\"}\n  4. {\"action\":\"delete\",\"id\":\"<commentId>\"}",
+      "description": "Manage document comment threads: create, read, update, and delete. To create a comment, first use superdoc_search to find the target text, then pass action \"create\" with the comment text and a target built from items[0].blocks. For a single-block match use {kind:\"text\", blockId: items[0].blocks[0].blockId, range: items[0].blocks[0].range}. For a cross-block match use {kind:\"text\", segments: items[0].blocks.map(b => ({blockId: b.blockId, range: b.range}))}. Do NOT use items[0].highlightRange (snippet-relative, not block-relative) or items[0].target (a SelectionTarget, not accepted by comments.create). For threaded replies, pass \"parentId\" with the parent comment ID. Action \"list\" returns all comments with optional pagination (limit, offset) and filtering (includeResolved:true to include resolved). Action \"get\" retrieves a single comment by ID. Action \"update\" changes comment text, re-anchors the thread, or changes status to \"resolved\". The legacy `isInternal` field remains in schema for v1 compatibility but is not supported for new comment patch behavior. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; only \"action\", \"text\", and \"target\" are needed.\n\nEXAMPLES:\n  1. {\"action\":\"create\",\"text\":\"Please review this section.\",\"target\":{\"kind\":\"text\",\"blockId\":\"<blockId>\",\"range\":{\"start\":5,\"end\":25}}}\n  2. {\"action\":\"list\",\"limit\":20,\"offset\":0}\n  3. {\"action\":\"update\",\"id\":\"<commentId>\",\"status\":\"resolved\"}\n  4. {\"action\":\"delete\",\"id\":\"<commentId>\"}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -4464,7 +4464,7 @@
           },
           "isInternal": {
             "type": "boolean",
-            "description": "Legacy v1/document-api compatibility field. Not a supported v2 behavior. V2 adapters MUST reject a `comments.patch` request containing `isInternal` with `CAPABILITY_UNAVAILABLE` (kernel reason `internal-comments-unsupported`). The field is preserved in the schema only so v1 callers keep their input shape (`comments-spec.md` §7, §14.6). Only for action 'update'. Omit for other actions."
+            "description": "Legacy v1/document-api compatibility field. Not supported for new comment patch behavior. A `comments.patch` request containing `isInternal` fails with `CAPABILITY_UNAVAILABLE` (kernel reason `internal-comments-unsupported`). The field is preserved in the schema only so v1 callers keep their input shape (`comments-spec.md` §7, §14.6). Only for action 'update'. Omit for other actions."
           },
           "includeResolved": {
             "type": "boolean",
@@ -4579,6 +4579,13 @@
                       "destination"
                     ],
                     "description": "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
+                  },
+                  "side": {
+                    "enum": [
+                      "inserted",
+                      "deleted"
+                    ],
+                    "description": "Optional replacement side. When the id resolves to a paired replacement, decides only the 'inserted' or 'deleted' half, leaving the other half as a standalone pending change."
                   }
                 },
                 "additionalProperties": false,
@@ -4777,6 +4784,13 @@
                       "destination"
                     ],
                     "description": "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
+                  },
+                  "side": {
+                    "enum": [
+                      "inserted",
+                      "deleted"
+                    ],
+                    "description": "Optional replacement side. When the id resolves to a paired replacement, decides only the 'inserted' or 'deleted' half."
                   }
                 },
                 "additionalProperties": false,
@@ -7077,7 +7091,6 @@
               "insert_column",
               "insert_row",
               "merge_cells",
-              "move_row",
               "set_borders",
               "set_cell",
               "set_cell_text",
@@ -7090,7 +7103,7 @@
               "set_style_options",
               "unmerge_cells"
             ],
-            "description": "The action to perform. One of: delete, delete_column, delete_row, insert_column, insert_row, merge_cells, move_row, set_borders, set_cell, set_cell_text, set_column, set_layout, set_options, set_row, set_row_options, set_shading, set_style_options, unmerge_cells."
+            "description": "The action to perform. One of: delete, delete_column, delete_row, insert_column, insert_row, merge_cells, set_borders, set_cell, set_cell_text, set_column, set_layout, set_options, set_row, set_row_options, set_shading, set_style_options, unmerge_cells."
           },
           "force": {
             "type": "boolean",
@@ -7138,34 +7151,20 @@
                                                                 "oneOf": [
                                                                   {
                                                                     "oneOf": [
+                                                                      {
+                                                                        "$ref": "#/$defs/TableAddress"
+                                                                      },
                                                                       {
                                                                         "oneOf": [
-                                                                          {
-                                                                            "$ref": "#/$defs/TableAddress"
-                                                                          },
                                                                           {
                                                                             "oneOf": [
                                                                               {
-                                                                                "oneOf": [
-                                                                                  {
-                                                                                    "$ref": "#/$defs/TableRowAddress"
-                                                                                  },
-                                                                                  {
-                                                                                    "$ref": "#/$defs/TableAddress"
-                                                                                  }
-                                                                                ]
+                                                                                "$ref": "#/$defs/TableRowAddress"
                                                                               },
                                                                               {
                                                                                 "$ref": "#/$defs/TableAddress"
                                                                               }
                                                                             ]
-                                                                          }
-                                                                        ]
-                                                                      },
-                                                                      {
-                                                                        "oneOf": [
-                                                                          {
-                                                                            "$ref": "#/$defs/TableRowAddress"
                                                                           },
                                                                           {
                                                                             "$ref": "#/$defs/TableAddress"
@@ -7341,142 +7340,7 @@
           "rowIndex": {
             "type": "integer",
             "minimum": 0,
-            "description": "Only for actions 'insert_row', 'delete_row', 'move_row', 'set_row', 'set_row_options', 'unmerge_cells', 'set_cell_text'. Omit for other actions."
-          },
-          "destination": {
-            "oneOf": [
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "first",
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "last",
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "before",
-                    "type": "string"
-                  },
-                  "rowIndex": {
-                    "type": "integer",
-                    "minimum": 0
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "rowIndex"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "after",
-                    "type": "string"
-                  },
-                  "rowIndex": {
-                    "type": "integer",
-                    "minimum": 0
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "rowIndex"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "before",
-                    "type": "string"
-                  },
-                  "target": {
-                    "$ref": "#/$defs/TableRowAddress"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "target"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "after",
-                    "type": "string"
-                  },
-                  "target": {
-                    "$ref": "#/$defs/TableRowAddress"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "target"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "before",
-                    "type": "string"
-                  },
-                  "nodeId": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "nodeId"
-                ]
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "kind": {
-                    "const": "after",
-                    "type": "string"
-                  },
-                  "nodeId": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false,
-                "required": [
-                  "kind",
-                  "nodeId"
-                ]
-              }
-            ],
-            "description": "Required for action 'move_row'."
+            "description": "Only for actions 'insert_row', 'delete_row', 'set_row', 'set_row_options', 'unmerge_cells', 'set_cell_text'. Omit for other actions."
           },
           "heightPt": {
             "type": "number",