@superdoc/cli-darwin-x64 0.23.0-next.100 → 0.24.0

package/bin/tools/catalog.json

@@ -4725,7 +4725,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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. 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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; \"action\", \"text\", and \"target\" are required, while commentId (the v1 compatibility alias for externalId), externalId, author fields, and metadata are optional correlation fields.\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": {
@@ -4850,6 +4850,43 @@
             "type": "string",
             "description": "Parent comment ID for creating a threaded reply. Only for action 'create'. Omit for other actions."
           },
+          "commentId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024,
+            "description": "Compatibility alias for externalId, matching the caller-supplied commentId accepted by the v1 editor. V2 still generates a separate Word-compatible commentId. Only for action 'create'. Omit for other actions."
+          },
+          "externalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024,
+            "description": "Caller-owned durable, document-unique integration id. Kept separate from the generated Word-compatible commentId. Only for action 'create'. Omit for other actions."
+          },
+          "author": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Author display name. Defaults to the configured session author. Only for action 'create'. Omit for other actions."
+          },
+          "authorId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Stable caller-owned author id. Only for action 'create'. Omit for other actions."
+          },
+          "authorEmail": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Caller-owned author email. Only for action 'create'. Omit for other actions."
+          },
+          "authorImage": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
+          },
+          "metadata": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Caller-owned JSON metadata persisted with the comment. Only for action 'create'. Omit for other actions."
+          },
           "id": {
             "type": "string",
             "description": "Required for actions 'delete', 'get'."

package/bin/tools/tools.anthropic.json

@@ -4440,7 +4440,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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. 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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; \"action\", \"text\", and \"target\" are required, while commentId (the v1 compatibility alias for externalId), externalId, author fields, and metadata are optional correlation fields.\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": {
@@ -4565,6 +4565,43 @@
             "type": "string",
             "description": "Parent comment ID for creating a threaded reply. Only for action 'create'. Omit for other actions."
           },
+          "commentId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024,
+            "description": "Compatibility alias for externalId, matching the caller-supplied commentId accepted by the v1 editor. V2 still generates a separate Word-compatible commentId. Only for action 'create'. Omit for other actions."
+          },
+          "externalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024,
+            "description": "Caller-owned durable, document-unique integration id. Kept separate from the generated Word-compatible commentId. Only for action 'create'. Omit for other actions."
+          },
+          "author": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Author display name. Defaults to the configured session author. Only for action 'create'. Omit for other actions."
+          },
+          "authorId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Stable caller-owned author id. Only for action 'create'. Omit for other actions."
+          },
+          "authorEmail": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Caller-owned author email. Only for action 'create'. Omit for other actions."
+          },
+          "authorImage": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
+          },
+          "metadata": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Caller-owned JSON metadata persisted with the comment. Only for action 'create'. Omit for other actions."
+          },
           "id": {
             "type": "string",
             "description": "Required for actions 'delete', 'get'."

package/bin/tools/tools.generic.json

@@ -4550,7 +4550,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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. 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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; \"action\", \"text\", and \"target\" are required, while commentId (the v1 compatibility alias for externalId), externalId, author fields, and metadata are optional correlation fields.\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>\"}",
       "parameters": {
         "type": "object",
         "properties": {
@@ -4675,6 +4675,43 @@
             "type": "string",
             "description": "Parent comment ID for creating a threaded reply. Only for action 'create'. Omit for other actions."
           },
+          "commentId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024,
+            "description": "Compatibility alias for externalId, matching the caller-supplied commentId accepted by the v1 editor. V2 still generates a separate Word-compatible commentId. Only for action 'create'. Omit for other actions."
+          },
+          "externalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024,
+            "description": "Caller-owned durable, document-unique integration id. Kept separate from the generated Word-compatible commentId. Only for action 'create'. Omit for other actions."
+          },
+          "author": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Author display name. Defaults to the configured session author. Only for action 'create'. Omit for other actions."
+          },
+          "authorId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Stable caller-owned author id. Only for action 'create'. Omit for other actions."
+          },
+          "authorEmail": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Caller-owned author email. Only for action 'create'. Omit for other actions."
+          },
+          "authorImage": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
+          },
+          "metadata": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Caller-owned JSON metadata persisted with the comment. Only for action 'create'. Omit for other actions."
+          },
           "id": {
             "type": "string",
             "description": "Required for actions 'delete', 'get'."

package/bin/tools/tools.openai.json

@@ -4457,7 +4457,7 @@
       "type": "function",
       "function": {
         "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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. 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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; \"action\", \"text\", and \"target\" are required, while commentId (the v1 compatibility alias for externalId), externalId, author fields, and metadata are optional correlation fields.\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>\"}",
         "parameters": {
           "type": "object",
           "properties": {
@@ -4582,6 +4582,43 @@
               "type": "string",
               "description": "Parent comment ID for creating a threaded reply. Only for action 'create'. Omit for other actions."
             },
+            "commentId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "description": "Compatibility alias for externalId, matching the caller-supplied commentId accepted by the v1 editor. V2 still generates a separate Word-compatible commentId. Only for action 'create'. Omit for other actions."
+            },
+            "externalId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "description": "Caller-owned durable, document-unique integration id. Kept separate from the generated Word-compatible commentId. Only for action 'create'. Omit for other actions."
+            },
+            "author": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Author display name. Defaults to the configured session author. Only for action 'create'. Omit for other actions."
+            },
+            "authorId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Stable caller-owned author id. Only for action 'create'. Omit for other actions."
+            },
+            "authorEmail": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Caller-owned author email. Only for action 'create'. Omit for other actions."
+            },
+            "authorImage": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
+            },
+            "metadata": {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "Caller-owned JSON metadata persisted with the comment. Only for action 'create'. Omit for other actions."
+            },
             "id": {
               "type": "string",
               "description": "Required for actions 'delete', 'get'."

package/bin/tools/tools.vercel.json

@@ -4457,7 +4457,7 @@
       "type": "function",
       "function": {
         "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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. 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, changes status to \"resolved\", or toggles the legacy `sdcom:internal` flag for v1 compatibility. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; \"action\", \"text\", and \"target\" are required, while commentId (the v1 compatibility alias for externalId), externalId, author fields, and metadata are optional correlation fields.\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>\"}",
         "parameters": {
           "type": "object",
           "properties": {
@@ -4582,6 +4582,43 @@
               "type": "string",
               "description": "Parent comment ID for creating a threaded reply. Only for action 'create'. Omit for other actions."
             },
+            "commentId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "description": "Compatibility alias for externalId, matching the caller-supplied commentId accepted by the v1 editor. V2 still generates a separate Word-compatible commentId. Only for action 'create'. Omit for other actions."
+            },
+            "externalId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "description": "Caller-owned durable, document-unique integration id. Kept separate from the generated Word-compatible commentId. Only for action 'create'. Omit for other actions."
+            },
+            "author": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Author display name. Defaults to the configured session author. Only for action 'create'. Omit for other actions."
+            },
+            "authorId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Stable caller-owned author id. Only for action 'create'. Omit for other actions."
+            },
+            "authorEmail": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Caller-owned author email. Only for action 'create'. Omit for other actions."
+            },
+            "authorImage": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
+            },
+            "metadata": {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "Caller-owned JSON metadata persisted with the comment. Only for action 'create'. Omit for other actions."
+            },
             "id": {
               "type": "string",
               "description": "Required for actions 'delete', 'get'."

package/package.json

@@ -1,6 +1,17 @@
 {
   "name": "@superdoc/cli-darwin-x64",
-  "version": "0.23.0-next.100",
+  "version": "0.24.0",
+  "description": "SuperDoc CLI binary for macOS x64. Selected automatically by @superdoc/cli; do not install it directly.",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/superdoc/docx-editor.git",
+    "directory": "apps/cli/platforms/cli-darwin-x64"
+  },
+  "homepage": "https://github.com/superdoc/docx-editor#readme",
+  "bugs": {
+    "url": "https://github.com/superdoc/docx-editor/issues"
+  },
   "os": [
     "darwin"
   ],