@superdoc-dev/sdk 1.13.0 → 1.14.0-next.2

package/dist/index.cjs

@@ -79,6 +79,13 @@ class SuperDocDocumentCore {
     markClosed() {
         this.boundRuntime.markClosed();
     }
+    async formatRange(params, options = {}) {
+        const { properties, ...rest } = params;
+        return this.boundRuntime.invoke(contract.CONTRACT.operations['doc.format.apply'], {
+            ...rest,
+            inline: properties,
+        }, options);
+    }
 }
 function attachBoundDocApi(target, api) {
     const { save: _save, close: _close, ...boundMethods } = api;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type BoundDocApi, type DocCloseBoundParams, type DocCloseResult, type DocOpenParams as GeneratedDocOpenParams, type DocOpenResult, type DocSaveBoundParams, type DocSaveResult } from './generated/client.js';
+import { type BoundDocApi, type DocCloseBoundParams, type DocCloseResult, type DocFormatApplyBoundParams, type DocFormatApplyResult, type DocOpenParams as GeneratedDocOpenParams, type DocOpenResult, type DocSaveBoundParams, type DocSaveResult } from './generated/client.js';
 import { SuperDocRuntime, type SuperDocClientOptions, type InvokeOptions, type OperationSpec, type RuntimeInvoker } from './runtime/process.js';
 /**
  * Wraps a raw runtime and injects a fixed sessionId into every invoke call.
@@ -14,6 +14,9 @@ declare class BoundRuntime implements RuntimeInvoker {
     invoke<TData = unknown>(operation: OperationSpec, params?: Record<string, unknown>, options?: InvokeOptions): Promise<TData>;
     markClosed(): void;
 }
+export interface DocFormatRangeBoundParams extends Omit<DocFormatApplyBoundParams, 'inline'> {
+    properties: NonNullable<DocFormatApplyBoundParams['inline']>;
+}
 /**
  * Bound document handle. All document operations are available as typed methods.
  * The handle injects its session id automatically — callers never pass
@@ -33,6 +36,7 @@ declare class SuperDocDocumentCore {
     close(params?: DocCloseBoundParams, options?: InvokeOptions): Promise<DocCloseResult>;
     /** @internal */
     markClosed(): void;
+    formatRange(params: DocFormatRangeBoundParams, options?: InvokeOptions): Promise<DocFormatApplyResult>;
 }
 type SuperDocDocumentInstance = SuperDocDocumentCore & BoundDocApi;
 export declare const SuperDocDocument: new (boundRuntime: BoundRuntime, sessionId: string, openResult: DocOpenResult, client: SuperDocClient) => SuperDocDocumentInstance;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,aAAa,IAAI,sBAAsB,EAC5C,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAO9B;;;;;GAKG;AACH,cAAM,YAAa,YAAW,cAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM;IAKjD,MAAM,CAAC,KAAK,GAAG,OAAO,EAC1B,SAAS,EAAE,aAAa,EACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,KAAK,CAAC;IAUjB,UAAU,IAAI,IAAI;CAGnB;AAED,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,yBAAyB,EAAE,QAAQ,CAAC;IAC1F,UAAU,EAAE,WAAW,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC9D;AAMD;;;;GAIG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,gBAAgB;gBACJ,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc;IAQ5G,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,oEAAoE;IACpE,IAAI,UAAU,IAAI,aAAa,CAE9B;IAEK,IAAI,CAAC,MAAM,GAAE,kBAAuB,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ1F,KAAK,CAAC,MAAM,GAAE,mBAAwB,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAWnG,gBAAgB;IAChB,UAAU,IAAI,IAAI;IAIZ,WAAW,CAAC,MAAM,EAAE,yBAAyB,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAWjH;AAED,KAAK,wBAAwB,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAOnE,eAAO,MAAM,gBAAgB,EAAE,KAC7B,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,cAAc,KACnB,wBAKwB,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAMxD,MAAM,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAEnD,OAAO,GAAE,qBAA0B;IAKzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB/E,QAAQ,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzF,eAAe,CAAC,MAAM,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,gBAAgB;IAChB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGtC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAExF;AAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,6BAA6B,EAC7B,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -73,6 +73,13 @@ class SuperDocDocumentCore {
     markClosed() {
         this.boundRuntime.markClosed();
     }
+    async formatRange(params, options = {}) {
+        const { properties, ...rest } = params;
+        return this.boundRuntime.invoke(CONTRACT.operations['doc.format.apply'], {
+            ...rest,
+            inline: properties,
+        }, options);
+    }
 }
 function attachBoundDocApi(target, api) {
     const { save: _save, close: _close, ...boundMethods } = api;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.13.0",
+  "version": "1.14.0-next.2",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,11 +26,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc-dev/sdk-darwin-arm64": "1.13.0",
-    "@superdoc-dev/sdk-darwin-x64": "1.13.0",
-    "@superdoc-dev/sdk-linux-x64": "1.13.0",
-    "@superdoc-dev/sdk-windows-x64": "1.13.0",
-    "@superdoc-dev/sdk-linux-arm64": "1.13.0"
+    "@superdoc-dev/sdk-darwin-arm64": "1.14.0-next.2",
+    "@superdoc-dev/sdk-linux-x64": "1.14.0-next.2",
+    "@superdoc-dev/sdk-darwin-x64": "1.14.0-next.2",
+    "@superdoc-dev/sdk-linux-arm64": "1.14.0-next.2",
+    "@superdoc-dev/sdk-windows-x64": "1.14.0-next.2"
   },
   "publishConfig": {
     "access": "public"

package/tools/catalog.json

@@ -2600,15 +2600,34 @@
                   },
                   {
                     "$ref": "#/$defs/TextTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/SelectionTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/CommentTrackedChangeTarget"
                   }
                 ],
-                "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
+                "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content."
               },
               {
-                "$ref": "#/$defs/TextAddress"
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/TextAddress"
+                  },
+                  {
+                    "$ref": "#/$defs/TextTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/SelectionTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/CommentTrackedChangeTarget"
+                  }
+                ]
               }
             ],
-            "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks. Only for actions 'create', 'update'. Omit for other actions."
+            "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content. Only for actions 'create', 'update'. Omit for other actions."
           },
           "parentId": {
             "type": "string",
@@ -2682,7 +2701,7 @@
     },
     {
       "toolName": "superdoc_track_changes",
-      "description": "Review and resolve tracked changes (insertions, deletions, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"} or all changes at once with {scope:\"all\"}. Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"insert\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
+      "description": "Review and resolve tracked changes (insertions, deletions, replacements, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, replacement, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"}, a partial selection with {kind:\"range\", range:{...}}, or all changes at once with {scope:\"all\"} (optionally plus story). Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"replacement\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"kind\":\"range\",\"range\":{\"kind\":\"text\",\"segments\":[{\"blockId\":\"<blockId>\",\"range\":{\"start\":0,\"end\":5}}]}}}\n  5. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2706,9 +2725,10 @@
             "enum": [
               "insert",
               "delete",
+              "replacement",
               "format"
             ],
-            "description": "Filter by change type: 'insert', 'delete', or 'format'. Only for action 'list'. Omit for other actions."
+            "description": "Filter by change type: 'insert', 'delete', 'replacement', or 'format'. Only for action 'list'. Omit for other actions."
           },
           "force": {
             "type": "boolean",
@@ -2746,6 +2766,30 @@
                   "id"
                 ]
               },
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "const": "range",
+                    "type": "string"
+                  },
+                  "range": {
+                    "$ref": "#/$defs/TextTarget"
+                  },
+                  "story": {
+                    "$ref": "#/$defs/StoryLocator"
+                  },
+                  "part": {
+                    "type": "string",
+                    "description": "Optional part discriminator for the range target."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "range"
+                ]
+              },
               {
                 "type": "object",
                 "properties": {
@@ -2753,6 +2797,18 @@
                     "enum": [
                       "all"
                     ]
+                  },
+                  "story": {
+                    "oneOf": [
+                      {
+                        "$ref": "#/$defs/StoryLocator"
+                      },
+                      {
+                        "const": "all",
+                        "type": "string"
+                      }
+                    ],
+                    "description": "Optional explicit bulk filter. Omit or pass 'all' to target every revision-capable story, or pass a StoryLocator to scope the decision to one story."
                   }
                 },
                 "additionalProperties": false,

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "266b6bb8fa042ebd94c3da6e11652471f49c40a061960f3df9055cf64c4bcbbe"
+  "contractHash": "5f439c4117bbb2e55f227e7711df415c1173f8c476954c6e412a4b8b45edd1a3"
 }

package/tools/tools.anthropic.json

@@ -2311,15 +2311,34 @@
                   },
                   {
                     "$ref": "#/$defs/TextTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/SelectionTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/CommentTrackedChangeTarget"
                   }
                 ],
-                "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
+                "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content."
               },
               {
-                "$ref": "#/$defs/TextAddress"
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/TextAddress"
+                  },
+                  {
+                    "$ref": "#/$defs/TextTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/SelectionTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/CommentTrackedChangeTarget"
+                  }
+                ]
               }
             ],
-            "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks. Only for actions 'create', 'update'. Omit for other actions."
+            "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content. Only for actions 'create', 'update'. Omit for other actions."
           },
           "parentId": {
             "type": "string",
@@ -2361,7 +2380,7 @@
     },
     {
       "name": "superdoc_track_changes",
-      "description": "Review and resolve tracked changes (insertions, deletions, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"} or all changes at once with {scope:\"all\"}. Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"insert\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
+      "description": "Review and resolve tracked changes (insertions, deletions, replacements, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, replacement, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"}, a partial selection with {kind:\"range\", range:{...}}, or all changes at once with {scope:\"all\"} (optionally plus story). Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"replacement\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"kind\":\"range\",\"range\":{\"kind\":\"text\",\"segments\":[{\"blockId\":\"<blockId>\",\"range\":{\"start\":0,\"end\":5}}]}}}\n  5. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -2385,9 +2404,10 @@
             "enum": [
               "insert",
               "delete",
+              "replacement",
               "format"
             ],
-            "description": "Filter by change type: 'insert', 'delete', or 'format'. Only for action 'list'. Omit for other actions."
+            "description": "Filter by change type: 'insert', 'delete', 'replacement', or 'format'. Only for action 'list'. Omit for other actions."
           },
           "force": {
             "type": "boolean",
@@ -2425,6 +2445,30 @@
                   "id"
                 ]
               },
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "const": "range",
+                    "type": "string"
+                  },
+                  "range": {
+                    "$ref": "#/$defs/TextTarget"
+                  },
+                  "story": {
+                    "$ref": "#/$defs/StoryLocator"
+                  },
+                  "part": {
+                    "type": "string",
+                    "description": "Optional part discriminator for the range target."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "range"
+                ]
+              },
               {
                 "type": "object",
                 "properties": {
@@ -2432,6 +2476,18 @@
                     "enum": [
                       "all"
                     ]
+                  },
+                  "story": {
+                    "oneOf": [
+                      {
+                        "$ref": "#/$defs/StoryLocator"
+                      },
+                      {
+                        "const": "all",
+                        "type": "string"
+                      }
+                    ],
+                    "description": "Optional explicit bulk filter. Omit or pass 'all' to target every revision-capable story, or pass a StoryLocator to scope the decision to one story."
                   }
                 },
                 "additionalProperties": false,

package/tools/tools.generic.json

@@ -2420,15 +2420,34 @@
                   },
                   {
                     "$ref": "#/$defs/TextTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/SelectionTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/CommentTrackedChangeTarget"
                   }
                 ],
-                "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
+                "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content."
               },
               {
-                "$ref": "#/$defs/TextAddress"
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/TextAddress"
+                  },
+                  {
+                    "$ref": "#/$defs/TextTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/SelectionTarget"
+                  },
+                  {
+                    "$ref": "#/$defs/CommentTrackedChangeTarget"
+                  }
+                ]
               }
             ],
-            "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks. Only for actions 'create', 'update'. Omit for other actions."
+            "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content. Only for actions 'create', 'update'. Omit for other actions."
           },
           "parentId": {
             "type": "string",
@@ -2490,7 +2509,7 @@
     },
     {
       "name": "superdoc_track_changes",
-      "description": "Review and resolve tracked changes (insertions, deletions, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"} or all changes at once with {scope:\"all\"}. Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"insert\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
+      "description": "Review and resolve tracked changes (insertions, deletions, replacements, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, replacement, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"}, a partial selection with {kind:\"range\", range:{...}}, or all changes at once with {scope:\"all\"} (optionally plus story). Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"replacement\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"kind\":\"range\",\"range\":{\"kind\":\"text\",\"segments\":[{\"blockId\":\"<blockId>\",\"range\":{\"start\":0,\"end\":5}}]}}}\n  5. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
       "parameters": {
         "type": "object",
         "properties": {
@@ -2514,9 +2533,10 @@
             "enum": [
               "insert",
               "delete",
+              "replacement",
               "format"
             ],
-            "description": "Filter by change type: 'insert', 'delete', or 'format'. Only for action 'list'. Omit for other actions."
+            "description": "Filter by change type: 'insert', 'delete', 'replacement', or 'format'. Only for action 'list'. Omit for other actions."
           },
           "force": {
             "type": "boolean",
@@ -2554,6 +2574,30 @@
                   "id"
                 ]
               },
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "const": "range",
+                    "type": "string"
+                  },
+                  "range": {
+                    "$ref": "#/$defs/TextTarget"
+                  },
+                  "story": {
+                    "$ref": "#/$defs/StoryLocator"
+                  },
+                  "part": {
+                    "type": "string",
+                    "description": "Optional part discriminator for the range target."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "range"
+                ]
+              },
               {
                 "type": "object",
                 "properties": {
@@ -2561,6 +2605,18 @@
                     "enum": [
                       "all"
                     ]
+                  },
+                  "story": {
+                    "oneOf": [
+                      {
+                        "$ref": "#/$defs/StoryLocator"
+                      },
+                      {
+                        "const": "all",
+                        "type": "string"
+                      }
+                    ],
+                    "description": "Optional explicit bulk filter. Omit or pass 'all' to target every revision-capable story, or pass a StoryLocator to scope the decision to one story."
                   }
                 },
                 "additionalProperties": false,

package/tools/tools.openai.json

@@ -2328,15 +2328,34 @@
                     },
                     {
                       "$ref": "#/$defs/TextTarget"
+                    },
+                    {
+                      "$ref": "#/$defs/SelectionTarget"
+                    },
+                    {
+                      "$ref": "#/$defs/CommentTrackedChangeTarget"
                     }
                   ],
-                  "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
+                  "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content."
                 },
                 {
-                  "$ref": "#/$defs/TextAddress"
+                  "oneOf": [
+                    {
+                      "$ref": "#/$defs/TextAddress"
+                    },
+                    {
+                      "$ref": "#/$defs/TextTarget"
+                    },
+                    {
+                      "$ref": "#/$defs/SelectionTarget"
+                    },
+                    {
+                      "$ref": "#/$defs/CommentTrackedChangeTarget"
+                    }
+                  ]
                 }
               ],
-              "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks. Only for actions 'create', 'update'. Omit for other actions."
+              "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content. Only for actions 'create', 'update'. Omit for other actions."
             },
             "parentId": {
               "type": "string",
@@ -2381,7 +2400,7 @@
       "type": "function",
       "function": {
         "name": "superdoc_track_changes",
-        "description": "Review and resolve tracked changes (insertions, deletions, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"} or all changes at once with {scope:\"all\"}. Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"insert\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
+        "description": "Review and resolve tracked changes (insertions, deletions, replacements, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, replacement, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"}, a partial selection with {kind:\"range\", range:{...}}, or all changes at once with {scope:\"all\"} (optionally plus story). Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n  1. {\"action\":\"list\"}\n  2. {\"action\":\"list\",\"type\":\"replacement\",\"limit\":10}\n  3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n  4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"kind\":\"range\",\"range\":{\"kind\":\"text\",\"segments\":[{\"blockId\":\"<blockId>\",\"range\":{\"start\":0,\"end\":5}}]}}}\n  5. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
         "parameters": {
           "type": "object",
           "properties": {
@@ -2405,9 +2424,10 @@
               "enum": [
                 "insert",
                 "delete",
+                "replacement",
                 "format"
               ],
-              "description": "Filter by change type: 'insert', 'delete', or 'format'. Only for action 'list'. Omit for other actions."
+              "description": "Filter by change type: 'insert', 'delete', 'replacement', or 'format'. Only for action 'list'. Omit for other actions."
             },
             "force": {
               "type": "boolean",
@@ -2445,6 +2465,30 @@
                     "id"
                   ]
                 },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "const": "range",
+                      "type": "string"
+                    },
+                    "range": {
+                      "$ref": "#/$defs/TextTarget"
+                    },
+                    "story": {
+                      "$ref": "#/$defs/StoryLocator"
+                    },
+                    "part": {
+                      "type": "string",
+                      "description": "Optional part discriminator for the range target."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "kind",
+                    "range"
+                  ]
+                },
                 {
                   "type": "object",
                   "properties": {
@@ -2452,6 +2496,18 @@
                       "enum": [
                         "all"
                       ]
+                    },
+                    "story": {
+                      "oneOf": [
+                        {
+                          "$ref": "#/$defs/StoryLocator"
+                        },
+                        {
+                          "const": "all",
+                          "type": "string"
+                        }
+                      ],
+                      "description": "Optional explicit bulk filter. Omit or pass 'all' to target every revision-capable story, or pass a StoryLocator to scope the decision to one story."
                     }
                   },
                   "additionalProperties": false,