@superdoc/cli 0.35.0-next.8 → 0.35.0-next.9

package/dist/index.js

@@ -765063,7 +765063,7 @@ var init_host2 = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.12.0-next.8";
+var SDK_VERSION = "2.12.0-next.9";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { chmodSync, existsSync } from "node:fs";
@@ -806260,17 +806260,25 @@ function normalizeTableColor2(raw) {
   return normalized ? `#${normalized}` : null;
 }
 async function runAcceptTrackedChanges(doc, args2) {
-  return runTrackedChangeDecision(doc, "accept_tracked_changes", "accept", args2.author, args2.changeType);
+  return runTrackedChangeDecision(doc, "accept_tracked_changes", "accept", Array.isArray(args2.id) ? args2.id : typeof args2.id === "string" ? [args2.id] : undefined, args2.author, args2.changeType);
 }
 async function runRejectTrackedChanges(doc, args2) {
-  return runTrackedChangeDecision(doc, "reject_tracked_changes", "reject", args2.author, args2.changeType);
+  return runTrackedChangeDecision(doc, "reject_tracked_changes", "reject", Array.isArray(args2.id) ? args2.id : typeof args2.id === "string" ? [args2.id] : undefined, args2.author, args2.changeType);
 }
-async function runTrackedChangeDecision(doc, intentLabel, decision, author, changeType) {
+async function runTrackedChangeDecision(doc, intentLabel, decision, exactIds, author, changeType) {
   const pre = await buildDocumentSnapshot(doc);
   try {
-    const listFn = maybeMethod2(doc, ["trackChanges", "list"]);
     const decideFn = maybeMethod2(doc, ["trackChanges", "decide"]);
-    if (!listFn || !decideFn) {
+    if (!decideFn) {
+      throw new SuperDocCliError("doc.trackChanges.list / decide are not available on the document handle.", {
+        code: "TOOL_DISPATCH_NOT_FOUND"
+      });
+    }
+    if (exactIds && exactIds.length > 0) {
+      return decideExactTrackedChanges(doc, intentLabel, decision, decideFn, exactIds, pre);
+    }
+    const listFn = maybeMethod2(doc, ["trackChanges", "list"]);
+    if (!listFn) {
       throw new SuperDocCliError("doc.trackChanges.list / decide are not available on the document handle.", {
         code: "TOOL_DISPATCH_NOT_FOUND"
       });
@@ -806339,6 +806347,53 @@ async function runTrackedChangeDecision(doc, intentLabel, decision, author, chan
     return failedReceipt2(intentLabel, err2, pre);
   }
 }
+function trackedChangeDecideFailure(result) {
+  const rec = asRecord10(result);
+  if (!rec || rec.success !== false)
+    return null;
+  const failure27 = asRecord10(rec.failure);
+  return {
+    code: asString2(failure27?.code, "ACTION_FAILED") || "ACTION_FAILED",
+    message: asString2(failure27?.message, "tracked-change decision failed") || "tracked-change decision failed"
+  };
+}
+async function decideExactTrackedChanges(doc, intentLabel, decision, decideFn, exactIds, pre) {
+  const target = exactIds.length === 1 ? { kind: "id", id: exactIds[0] } : { kind: "ids", ids: [...exactIds] };
+  const result = await decideFn({ decision, target });
+  const failure27 = trackedChangeDecideFailure(result);
+  const selectedTargets = exactIds.map((id2) => ({
+    selector: { kind: "entity", entityType: "trackedChange", entityId: id2 },
+    matched: failure27 ? [] : [id2]
+  }));
+  if (failure27) {
+    return {
+      status: "failed",
+      intent: intentLabel,
+      preSnapshot: { revision: pre.revision, counts: pre.counts },
+      selectedTargets,
+      executedOperations: [{ operationId: "doc.trackChanges.decide", result }],
+      verification: [],
+      errors: [
+        {
+          code: failure27.code,
+          message: failure27.message,
+          recovery: { kind: "reinspect" }
+        }
+      ]
+    };
+  }
+  const post = await buildDocumentSnapshot(doc);
+  const verification = evaluateChecks(pre, post, [{ kind: "revision-changed" }]);
+  return {
+    status: verification.every((v) => v.passed) ? "ok" : "failed",
+    intent: intentLabel,
+    preSnapshot: { revision: pre.revision, counts: pre.counts },
+    postSnapshot: { revision: post.revision, counts: post.counts },
+    selectedTargets,
+    executedOperations: [{ operationId: "doc.trackChanges.decide", result }],
+    verification
+  };
+}
 async function listAllTrackedChanges(listFn) {
   const PAGE = 250;
   let offset = 0;
@@ -809341,14 +809396,12 @@ async function dispatchSuperdocPerformAction(doc, args2) {
     case "accept_tracked_changes":
       return runAcceptTrackedChanges(doc, {
         action: action2,
-        author: asString2(args2.author),
-        changeType: parseTrackedChangeKind(args2.changeType)
+        ...parseTrackedChangeDecisionArgs(action2, args2)
       });
     case "reject_tracked_changes":
       return runRejectTrackedChanges(doc, {
         action: action2,
-        author: asString2(args2.author),
-        changeType: parseTrackedChangeKind(args2.changeType)
+        ...parseTrackedChangeDecisionArgs(action2, args2)
       });
     case "normalize_body_font_size": {
       const fontSize = asNumber2(args2.fontSize);
@@ -809701,6 +809754,62 @@ async function dispatchSuperdocPerformAction(doc, args2) {
     }
   }
 }
+function parseTrackedChangeDecisionArgs(action2, args2) {
+  const hasId = args2.id !== undefined;
+  const hasAuthor = args2.author !== undefined;
+  const hasChangeType = args2.changeType !== undefined;
+  const id2 = hasId ? parseExactTrackedChangeIdList(args2.id) : undefined;
+  const author = asString2(args2.author)?.trim();
+  const changeType = parseTrackedChangeKind(args2.changeType);
+  if (hasId && !id2) {
+    throw new SuperDocCliError(`${action2} requires "id" to be a non-empty string or array of non-empty strings`, {
+      code: "INVALID_ARGUMENT"
+    });
+  }
+  if (hasAuthor && !author) {
+    throw new SuperDocCliError(`${action2} requires "author" to be a non-empty string when provided`, {
+      code: "INVALID_ARGUMENT"
+    });
+  }
+  if (hasChangeType && !changeType) {
+    throw new SuperDocCliError(`${action2} requires "changeType" to be insert, delete, replacement, or format when provided`, {
+      code: "INVALID_ARGUMENT"
+    });
+  }
+  if (id2 && (hasAuthor || hasChangeType)) {
+    throw new SuperDocCliError(`${action2} cannot combine "id" with "author" or "changeType"`, {
+      code: "INVALID_ARGUMENT"
+    });
+  }
+  if (id2)
+    return { id: id2 };
+  return {
+    ...author ? { author } : {},
+    ...changeType ? { changeType } : {}
+  };
+}
+function parseExactTrackedChangeIdList(value2) {
+  if (typeof value2 === "string") {
+    const trimmed = value2.trim();
+    return trimmed.length > 0 ? [trimmed] : undefined;
+  }
+  if (!Array.isArray(value2))
+    return;
+  const ids = [];
+  const seen = new Set;
+  for (const entry of value2) {
+    if (typeof entry !== "string")
+      return;
+    const trimmed = entry.trim();
+    if (trimmed.length === 0)
+      return;
+    if (seen.has(trimmed))
+      continue;
+    seen.add(trimmed);
+    ids.push(trimmed);
+  }
+  return ids.length > 0 ? ids : undefined;
+}
 async function superdocPerformAction(doc, args2) {
   try {
     return await dispatchSuperdocPerformAction(doc, args2);
@@ -809981,8 +810090,8 @@ var init_actions = __esm(() => {
     add_comments: 'commentText, selector (one block) OR selectors[] to comment MANY blocks in ONE call (same text) — use selectors[] for "comment every heading/section/clause"; NEVER emit multiple add_comments calls, batch the targets into selectors[]',
     resolve_comments: 'anchorText? (resolve only comments anchored on text containing this; omit to resolve ALL open comments), reopen? (true = reopen resolved comments instead) — THE way to resolve (or reopen) comments. Use for "resolve the comment(s)" / "mark comments resolved".',
     reply_to_comment: `commentText (the reply body), anchorText (text the target comment is anchored on / mentions) OR commentId — THE way to REPLY to an existing comment thread. Use for "reply to the comment about X" / "respond to Reviewer's comment". Adds a threaded reply, not a new top-level comment.`,
-    accept_tracked_changes: 'author?, changeType?: insert|delete|replacement|format — e.g. changeType:"format" accepts ONLY formatting revisions (bold/italic/color), leaving text edits pending',
-    reject_tracked_changes: "author?, changeType?: insert|delete|replacement|format",
+    accept_tracked_changes: 'id? (string or string[]) OR author?/changeType?: insert|delete|replacement|format — a string[] decides that exact set atomically; e.g. changeType:"format" accepts ONLY formatting revisions (bold/italic/color), leaving text edits pending',
+    reject_tracked_changes: "id? (string or string[]) OR author?/changeType?: insert|delete|replacement|format — a string[] decides that exact set atomically",
     normalize_body_font_size: "fontSize, changeMode?",
     set_font_family: 'fontFamily (e.g. "Arial"), selector? (one block) OR targetText/targetTexts[] (occurrences) — omit both to set the WHOLE body font, caseSensitive?, changeMode? — THE way to change the typeface. Use for "change the font to X" / "set the heading font to Y".',
     format_text: "bold?/italic?/underline?/strike? booleans, highlight? color name, color?, fontSize?, applied to EVERY occurrence of targetText (or targetTexts[] for several phrases in one call, or a selector'd block), caseSensitive?, changeMode? — THE way to bold/italicize/underline/highlight text, tracked-safe",
@@ -810072,8 +810181,8 @@ var init_actions = __esm(() => {
     resolve_comments: ["anchorText", "reopen"],
     reply_to_comment: ["commentText", "anchorText", "commentId"],
     rewrite_block: ["text", "selector", "changeMode", "evidence"],
-    accept_tracked_changes: ["author", "changeType"],
-    reject_tracked_changes: ["author", "changeType"],
+    accept_tracked_changes: ["id", "author", "changeType"],
+    reject_tracked_changes: ["id", "author", "changeType"],
     normalize_body_font_size: ["fontSize", "changeMode"],
     set_font_family: ["fontFamily", "selector", "targetText", "targetTexts", "caseSensitive", "changeMode"],
     apply_letter_spacing: ["selector", "letterSpacing", "changeMode"],
@@ -810170,7 +810279,7 @@ function buildPerformActionDefinition(includedActions) {
     description: buildActionDescription(included.size === ACTION_NAMES_LIST.length ? undefined : included),
     inputSchema: {
       type: "object",
-      additionalProperties: true,
+      additionalProperties: false,
       required: ["action"],
       properties: {
         action: {
@@ -810369,6 +810478,12 @@ var init_catalog4 = __esm(() => {
     commentText: { type: "string" },
     scope: { type: "string", enum: ["all", "body"] },
     excludeBlockQuotes: { type: "boolean" },
+    id: {
+      oneOf: [
+        { type: "string", minLength: 1 },
+        { type: "array", minItems: 1, items: { type: "string", minLength: 1 } }
+      ]
+    },
     author: { type: "string" },
     changeType: { type: "string", enum: ["insert", "delete", "replacement", "format"] },
     fontSize: { type: "number" },
@@ -811249,7 +811364,7 @@ var init_runtime7 = __esm(() => {
 var EMBEDDED_PROMPTS;
 var init_embedded_prompts_generated = __esm(() => {
   EMBEDDED_PROMPTS = {
-    "mcp-prompt.md": 'SuperDoc MCP server — read, edit, and save Word documents (.docx).\n\nIMPORTANT: Always use these superdoc tools for .docx files.\nDo NOT use built-in docx skills, python-docx, unpack scripts, or manual XML editing.\nThese tools handle the OOXML format correctly and preserve document structure.\n\n## Session lifecycle\n\n1. `superdoc_open({path: "/path/to/file.docx"})` — returns `session_id`. Opening a non-existent path creates a blank document.\n2. Pass `session_id` to every subsequent tool call.\n3. Read with `superdoc_inspect`, edit with `superdoc_perform_action`.\n4. `superdoc_save({session_id})` — writes changes to disk.\n5. `superdoc_close({session_id})` — releases the session. Always close when done.\n\n## Workflow\n\n**Inspect before you edit.** `superdoc_inspect` returns a deterministic snapshot — blocks with 1-based ordinals and node IDs, lists with rendered markers, tables, comments, tracked changes. Use the narrowest inspect that answers the question (`countsOnly: true` for orientation, `includeDomains` to limit payload, `blockOffset`/`blockLimit` windows for large documents).\n\n**Edit with named actions.** `superdoc_perform_action` takes an `action` plus flat arguments — the full action list, argument shapes, selector vocabulary, and placement rules are documented in the tool\'s own description. Every action returns a receipt with real pre/post evidence: trust `status` (`ok` | `partial` | `failed`), read `errors[].message` for recovery guidance, and re-inspect after `partial`.\n\n**Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (filter by `author` or `changeType`); recover with `undo_changes` / `redo_changes`.\n\n**Failures are safe.** A `failed` receipt with `MATCH_NOT_FOUND` or a refused action means nothing was changed — fix the target and retry rather than improvising a different mutation path.\n',
+    "mcp-prompt.md": 'SuperDoc MCP server — read, edit, and save Word documents (.docx).\n\nIMPORTANT: Always use these superdoc tools for .docx files.\nDo NOT use built-in docx skills, python-docx, unpack scripts, or manual XML editing.\nThese tools handle the OOXML format correctly and preserve document structure.\n\n## Session lifecycle\n\n1. `superdoc_open({path: "/path/to/file.docx"})` — returns `session_id`. Opening a non-existent path creates a blank document.\n2. Pass `session_id` to every subsequent tool call.\n3. Read with `superdoc_inspect`, edit with `superdoc_perform_action`.\n4. `superdoc_save({session_id})` — writes changes to disk.\n5. `superdoc_close({session_id})` — releases the session. Always close when done.\n\n## Workflow\n\n**Inspect before you edit.** `superdoc_inspect` returns a deterministic snapshot — blocks with 1-based ordinals and node IDs, lists with rendered markers, tables, comments, tracked changes. Use the narrowest inspect that answers the question (`countsOnly: true` for orientation, `includeDomains` to limit payload, `blockOffset`/`blockLimit` windows for large documents).\n\n**Edit with named actions.** `superdoc_perform_action` takes an `action` plus flat arguments — the full action list, argument shapes, selector vocabulary, and placement rules are documented in the tool\'s own description. Every action returns a receipt with real pre/post evidence: trust `status` (`ok` | `partial` | `failed`), read `errors[].message` for recovery guidance, and re-inspect after `partial`.\n\n**Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (target one change with `id`, or an exact set with `id:[…]`; or filter by `author` or `changeType`). Do not combine exact IDs with filters. Recover with `undo_changes` / `redo_changes`.\n\n**Failures are safe.** A `failed` receipt with `MATCH_NOT_FOUND` or a refused action means nothing was changed — fix the target and retry rather than improvising a different mutation path.\n',
     "system-prompt.md": `You are an expert document editor working inside a live Word document. You know how documents actually work — headings structure content, numbering schemes carry legal meaning, tables hold data, tracked changes record intent, comments carry review. You edit the way a skilled human editor would: you understand what people MEAN, not just what they SAY, and you leave the document the way a professional would leave it.
 
 ============================================================
@@ -811309,7 +811424,7 @@ ACTIONS (superdoc_perform_action with flat args)
 - add_comments: commentText, and either selector (one block) or selectors:[…] to comment MANY blocks in ONE call with the same text. To comment every heading/section/clause, resolve their targets and pass them all in selectors:[…] — NEVER emit a separate add_comments call per block.
 - reply_to_comment: commentText (the reply body), and either anchorText (text the target comment is anchored on / mentions) or commentId. THE way to REPLY to an existing comment thread ("reply to the comment about X") — a threaded reply, not a new top-level comment.
 - resolve_comments: anchorText? (resolve only comments anchored on / mentioning that text; omit to resolve ALL open comments), reopen:true to reopen resolved comments instead. THE way to "resolve the comment(s)" / "mark comments resolved".
-- accept_tracked_changes / reject_tracked_changes: optional author:"Full Name", optional changeType:"insert"|"delete"|"replacement"|"format". "Accept only the formatting changes" = changeType:"format" (formatting revisions — bold/italic/underline/color — are a DISTINCT tracked-change type from text edits; text changes stay pending).
+- accept_tracked_changes / reject_tracked_changes: id:"change-id" or id:["id1","id2"] for one atomic set, OR optional author:"Full Name" / changeType:"insert"|"delete"|"replacement"|"format" to filter. Do not combine id with author/changeType. "Accept only the formatting changes" = changeType:"format" (formatting revisions — bold/italic/underline/color — are a DISTINCT tracked-change type from text edits; text changes stay pending).
 - format_text: bold/italic/underline/strike:true, highlight:"yellow", color (named or hex), fontSize — applied to EVERY occurrence of targetText (or targetTexts:["…","…"] for several phrases in one call; or selector for a whole block). caseSensitive:true for exact case. changeMode:"tracked" produces format-type tracked changes. THE way to bold/italicize/underline/highlight/color text — find the literal texts first (inspect), then ONE call. NOTE: one call applies ONE set of properties to ALL its targets — to color two phrases DIFFERENT colors, make a SEPARATE call per color (do NOT batch different-colored phrases into one targetTexts call).
 - apply_style: selector (the block to restyle), then ONE of styleId ("Heading2"), headingLevel (1-6), or likeText (text inside the block whose style AND effective look to copy). "Make Summary match the Parties heading" = apply_style {selector:…, likeText:"Parties"}. THE way to restyle an existing block — never delete-and-recreate it.
 - normalize_body_font_size: fontSize:N.

package/dist/prompts/mcp-prompt.md

@@ -18,6 +18,6 @@ These tools handle the OOXML format correctly and preserve document structure.
 
 **Edit with named actions.** `superdoc_perform_action` takes an `action` plus flat arguments — the full action list, argument shapes, selector vocabulary, and placement rules are documented in the tool's own description. Every action returns a receipt with real pre/post evidence: trust `status` (`ok` | `partial` | `failed`), read `errors[].message` for recovery guidance, and re-inspect after `partial`.
 
-**Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (filter by `author` or `changeType`); recover with `undo_changes` / `redo_changes`.
+**Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (target one change with `id`, or an exact set with `id:[…]`; or filter by `author` or `changeType`). Do not combine exact IDs with filters. Recover with `undo_changes` / `redo_changes`.
 
 **Failures are safe.** A `failed` receipt with `MATCH_NOT_FOUND` or a refused action means nothing was changed — fix the target and retry rather than improvising a different mutation path.

package/dist/prompts/system-prompt.md

@@ -57,7 +57,7 @@ ACTIONS (superdoc_perform_action with flat args)
 - add_comments: commentText, and either selector (one block) or selectors:[…] to comment MANY blocks in ONE call with the same text. To comment every heading/section/clause, resolve their targets and pass them all in selectors:[…] — NEVER emit a separate add_comments call per block.
 - reply_to_comment: commentText (the reply body), and either anchorText (text the target comment is anchored on / mentions) or commentId. THE way to REPLY to an existing comment thread ("reply to the comment about X") — a threaded reply, not a new top-level comment.
 - resolve_comments: anchorText? (resolve only comments anchored on / mentioning that text; omit to resolve ALL open comments), reopen:true to reopen resolved comments instead. THE way to "resolve the comment(s)" / "mark comments resolved".
-- accept_tracked_changes / reject_tracked_changes: optional author:"Full Name", optional changeType:"insert"|"delete"|"replacement"|"format". "Accept only the formatting changes" = changeType:"format" (formatting revisions — bold/italic/underline/color — are a DISTINCT tracked-change type from text edits; text changes stay pending).
+- accept_tracked_changes / reject_tracked_changes: id:"change-id" or id:["id1","id2"] for one atomic set, OR optional author:"Full Name" / changeType:"insert"|"delete"|"replacement"|"format" to filter. Do not combine id with author/changeType. "Accept only the formatting changes" = changeType:"format" (formatting revisions — bold/italic/underline/color — are a DISTINCT tracked-change type from text edits; text changes stay pending).
 - format_text: bold/italic/underline/strike:true, highlight:"yellow", color (named or hex), fontSize — applied to EVERY occurrence of targetText (or targetTexts:["…","…"] for several phrases in one call; or selector for a whole block). caseSensitive:true for exact case. changeMode:"tracked" produces format-type tracked changes. THE way to bold/italicize/underline/highlight/color text — find the literal texts first (inspect), then ONE call. NOTE: one call applies ONE set of properties to ALL its targets — to color two phrases DIFFERENT colors, make a SEPARATE call per color (do NOT batch different-colored phrases into one targetTexts call).
 - apply_style: selector (the block to restyle), then ONE of styleId ("Heading2"), headingLevel (1-6), or likeText (text inside the block whose style AND effective look to copy). "Make Summary match the Parties heading" = apply_style {selector:…, likeText:"Parties"}. THE way to restyle an existing block — never delete-and-recreate it.
 - normalize_body_font_size: fontSize:N.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/cli",
-  "version": "0.35.0-next.8",
+  "version": "0.35.0-next.9",
   "description": "Command-line interface for SuperDoc: inspect, convert, and edit .docx files from a terminal or a script.",
   "type": "module",
   "license": "AGPL-3.0",
@@ -35,7 +35,7 @@
   },
   "devDependencies": {
     "@hocuspocus/server": "^2.13.6",
-    "@superdoc/sdk": "2.12.0-next.8",
+    "@superdoc/sdk": "2.12.0-next.9",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@superdoc/docx-engine": "0.14.0-next.6",
     "@types/bun": "^1.3.8",
@@ -51,11 +51,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc/cli-darwin-arm64": "0.35.0-next.8",
-    "@superdoc/cli-darwin-x64": "0.35.0-next.8",
-    "@superdoc/cli-linux-x64": "0.35.0-next.8",
-    "@superdoc/cli-linux-arm64": "0.35.0-next.8",
-    "@superdoc/cli-windows-x64": "0.35.0-next.8"
+    "@superdoc/cli-darwin-arm64": "0.35.0-next.9",
+    "@superdoc/cli-darwin-x64": "0.35.0-next.9",
+    "@superdoc/cli-linux-x64": "0.35.0-next.9",
+    "@superdoc/cli-linux-arm64": "0.35.0-next.9",
+    "@superdoc/cli-windows-x64": "0.35.0-next.9"
   },
   "scripts": {
     "predev": "node scripts/ensure-superdoc-build.js",