@superdoc/sdk 2.13.1-next.8 → 2.13.1-next.9

package/dist/presets/core.cjs

@@ -95,6 +95,15 @@ function stripCorruptedToolArgKeys(value) {
     }
     return clean;
 }
+/**
+ * Arguments the action surface used to advertise and no longer accepts. A model
+ * prompted from an older surface (or trained on one) still sends them, and the
+ * generic "Unknown argument(s)" message does not say what to reach for instead,
+ * so the call dead-ends. Naming the replacement makes the refusal recoverable.
+ */
+const RETIRED_ACTION_ARGS = {
+    dryRun: "dryRun is not supported by superdoc_perform_action: no action previews a mutation. To make an edit reviewable before it is final, pass changeMode: 'tracked' on an action that records tracked changes; to take one back, use the undo_changes action.",
+};
 function validateAgentToolArgs(toolName, args) {
     const definition = catalog.AGENT_TOOL_DEFINITIONS.find((entry) => entry.name === toolName);
     if (definition == null)
@@ -105,9 +114,21 @@ function validateAgentToolArgs(toolName, args) {
     const knownKeys = new Set(Object.keys(properties));
     const unknownKeys = Object.keys(args).filter((key) => !knownKeys.has(key));
     if (unknownKeys.length > 0) {
-        throw new errors.SuperDocCliError(`Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`, {
+        // hasOwn, not `in`: an argument named `constructor` or `toString` would
+        // otherwise match the prototype chain and report a native function as its
+        // replacement guidance.
+        const retiredKeys = unknownKeys.filter((key) => Object.hasOwn(RETIRED_ACTION_ARGS, key));
+        const message = retiredKeys.length > 0
+            ? retiredKeys.map((key) => RETIRED_ACTION_ARGS[key]).join(' ')
+            : `Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`;
+        throw new errors.SuperDocCliError(message, {
             code: 'INVALID_ARGUMENT',
-            details: { toolName, unknownKeys, knownKeys: [...knownKeys] },
+            details: {
+                toolName,
+                unknownKeys,
+                knownKeys: [...knownKeys],
+                ...(retiredKeys.length > 0 ? { retiredKeys } : {}),
+            },
         });
     }
     const missingKeys = required.filter((key) => args[key] == null);

package/dist/presets/core.js

@@ -91,6 +91,15 @@ function stripCorruptedToolArgKeys(value) {
     }
     return clean;
 }
+/**
+ * Arguments the action surface used to advertise and no longer accepts. A model
+ * prompted from an older surface (or trained on one) still sends them, and the
+ * generic "Unknown argument(s)" message does not say what to reach for instead,
+ * so the call dead-ends. Naming the replacement makes the refusal recoverable.
+ */
+const RETIRED_ACTION_ARGS = {
+    dryRun: "dryRun is not supported by superdoc_perform_action: no action previews a mutation. To make an edit reviewable before it is final, pass changeMode: 'tracked' on an action that records tracked changes; to take one back, use the undo_changes action.",
+};
 function validateAgentToolArgs(toolName, args) {
     const definition = AGENT_TOOL_DEFINITIONS.find((entry) => entry.name === toolName);
     if (definition == null)
@@ -101,9 +110,21 @@ function validateAgentToolArgs(toolName, args) {
     const knownKeys = new Set(Object.keys(properties));
     const unknownKeys = Object.keys(args).filter((key) => !knownKeys.has(key));
     if (unknownKeys.length > 0) {
-        throw new SuperDocCliError(`Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`, {
+        // hasOwn, not `in`: an argument named `constructor` or `toString` would
+        // otherwise match the prototype chain and report a native function as its
+        // replacement guidance.
+        const retiredKeys = unknownKeys.filter((key) => Object.hasOwn(RETIRED_ACTION_ARGS, key));
+        const message = retiredKeys.length > 0
+            ? retiredKeys.map((key) => RETIRED_ACTION_ARGS[key]).join(' ')
+            : `Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`;
+        throw new SuperDocCliError(message, {
             code: 'INVALID_ARGUMENT',
-            details: { toolName, unknownKeys, knownKeys: [...knownKeys] },
+            details: {
+                toolName,
+                unknownKeys,
+                knownKeys: [...knownKeys],
+                ...(retiredKeys.length > 0 ? { retiredKeys } : {}),
+            },
         });
     }
     const missingKeys = required.filter((key) => args[key] == null);

package/dist/prompts/system-prompt.md

@@ -74,7 +74,7 @@ ACTIONS (superdoc_perform_action with flat args)
 - move_table: tableOrdinal? (default 1), placement {at:"document_end"|"document_start"|"after"|"before", selector?}. THE way to move a whole table in ONE call — never delete-and-recreate or chain inserts/undos to relocate a table. changeMode:"tracked" records the move for review.
 - delete_table: tableOrdinal? (default 1), changeMode?. THE way to delete an entire table in ONE call — never delete rows one by one or reuse another table.
 - style_table: tableOrdinal? (default 1), accentColor? (header fill hex). ONE call makes a table look professional: accent header row with white bold text, bold first column, banded rows, clean borders. Use after create_table or on any existing table. changeMode:"tracked" records the formatting for review.
-- insert_table_row: tableOrdinal (1-based), rowIndex (0-based; omit to append), position:"above"|"below", optional cellTexts. dryRun:true for preview.
+- insert_table_row: tableOrdinal (1-based), rowIndex (0-based; omit to append), position:"above"|"below", optional cellTexts.
 - insert_table_column: tableOrdinal, columnIndex (0-based; omit to append right), position:"left"|"right", optional headerText.
 - delete_table_row / delete_table_column: rowIndex or columnIndex required, tableOrdinal optional.
 - split_table: tableOrdinal, rowIndex (>=1), optional separatorText.
@@ -103,7 +103,7 @@ OPERATING RULES
 - For anchored rewrites or multi-term edits, prefer textSearch selectors over copied nodeIds. For clause text inside tables, use a tableCell selector with replace_text.
 - For tab-indented headings, replace only the visible text with replace_text (rewrite_block can delete the tab node).
 - For BULK or PATTERN transforms (every percentage, every date), use ONE replace_text call with multiple edits. For bulk FORMATTING ("bold all the dates"): read the matching texts first, then ONE format_text call with targetTexts.
-- For preview-only requests ("show what it would look like", "don't save"), pass dryRun:true and make NO other mutating call; describe the preview from the receipt.
+- For preview-only requests ("show what it would look like", "don't save"), make NO mutating call — read the document with superdoc_inspect and describe the change in your answer. If they want to SEE it in the document before it is final, make the edit with changeMode:"tracked" so it lands as a reviewable suggestion they can accept or reject — but only on an action that records tracked changes; for an action marked Direct edit, describe the change instead of making it.
 - Pure count questions: superdoc_inspect countsOnly:true, then stop. Use includeDomains to keep snapshots small.
 - Do not include doc or sessionId in tool args. Never rely on benchmark routing, eval metadata, or fixture names.
 - If the runtime truly cannot express the request, say what is missing instead of faking success.

package/dist/runtime/sdk-version.generated.cjs

@@ -3,6 +3,6 @@
 // AUTO-GENERATED by scripts/embed-version.mjs — DO NOT EDIT.
 // Source of truth: package.json. Regenerated on every SDK build so the
 // SDK retains its own version identity when bundled into another package.
-const SDK_VERSION = '2.13.1-next.8';
+const SDK_VERSION = '2.13.1-next.9';
 
 exports.SDK_VERSION = SDK_VERSION;

package/dist/runtime/sdk-version.generated.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.13.1-next.8";
+export declare const SDK_VERSION = "2.13.1-next.9";

package/dist/runtime/sdk-version.generated.js

@@ -1,4 +1,4 @@
 // AUTO-GENERATED by scripts/embed-version.mjs — DO NOT EDIT.
 // Source of truth: package.json. Regenerated on every SDK build so the
 // SDK retains its own version identity when bundled into another package.
-export const SDK_VERSION = '2.13.1-next.8';
+export const SDK_VERSION = '2.13.1-next.9';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.13.1-next.8",
+  "version": "2.13.1-next.9",
   "description": "Node SDK for SuperDoc, wrapping the SuperDoc CLI to read and edit .docx files from JavaScript and TypeScript.",
   "private": false,
   "license": "AGPL-3.0",
@@ -38,11 +38,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc/sdk-darwin-arm64": "2.13.1-next.8",
-    "@superdoc/sdk-darwin-x64": "2.13.1-next.8",
-    "@superdoc/sdk-linux-x64": "2.13.1-next.8",
-    "@superdoc/sdk-linux-arm64": "2.13.1-next.8",
-    "@superdoc/sdk-windows-x64": "2.13.1-next.8"
+    "@superdoc/sdk-darwin-arm64": "2.13.1-next.9",
+    "@superdoc/sdk-darwin-x64": "2.13.1-next.9",
+    "@superdoc/sdk-linux-x64": "2.13.1-next.9",
+    "@superdoc/sdk-linux-arm64": "2.13.1-next.9",
+    "@superdoc/sdk-windows-x64": "2.13.1-next.9"
   },
   "publishConfig": {
     "access": "public"

package/tools/prompt-templates/system-prompt-core.md

@@ -428,7 +428,6 @@ When formatting newly created content, use the right source:
 - **Do NOT hardcode formatting values.** Always read from blocks data and replicate.
 - **Do NOT copy heading/title formatting onto body paragraphs.** Read from body text blocks (alignment "justify" or "left"), not title blocks.
 - **Pass structured objects, not JSON-encoded strings.** Fields like `at`, `target`, and `inline` expect objects, not serialized JSON strings.
-- **Only pass `dryRun` when the action's schema explicitly lists it.** Do not assume every action accepts it. Prefer a real call over a preview for destructive actions unless dryRun is documented for that action.
 - **If blocks still report `underline: true` after you explicitly removed it, treat it as a style inheritance artifact.** Do not retry formatting to fix it.
 - **On "Unknown field" errors, drop the unrecognized field and retry.** Use the narrowest working call shape rather than guessing alternative field names.
 - **Table styling crosses two tools.** Borders / shading / cnf flags / spacing are on `superdoc_table`; cell-text alignment and font color/weight are on `superdoc_format` (paragraph- and run-level). A "style the whole table" pass calls both. See the Tables: cross-tool workflows section for the full recipe.

package/tools/system-prompt-mcp.md

@@ -478,7 +478,6 @@ When formatting newly created content, use the right source:
 - **Do NOT hardcode formatting values.** Always read from blocks data and replicate.
 - **Do NOT copy heading/title formatting onto body paragraphs.** Read from body text blocks (alignment "justify" or "left"), not title blocks.
 - **Pass structured objects, not JSON-encoded strings.** Fields like `at`, `target`, and `inline` expect objects, not serialized JSON strings.
-- **Only pass `dryRun` when the action's schema explicitly lists it.** Do not assume every action accepts it. Prefer a real call over a preview for destructive actions unless dryRun is documented for that action.
 - **If blocks still report `underline: true` after you explicitly removed it, treat it as a style inheritance artifact.** Do not retry formatting to fix it.
 - **On "Unknown field" errors, drop the unrecognized field and retry.** Use the narrowest working call shape rather than guessing alternative field names.
 - **Table styling crosses two tools.** Borders / shading / cnf flags / spacing are on `superdoc_table`; cell-text alignment and font color/weight are on `superdoc_format` (paragraph- and run-level). A "style the whole table" pass calls both. See the Tables: cross-tool workflows section for the full recipe.

package/tools/system-prompt.md

@@ -432,7 +432,6 @@ When formatting newly created content, use the right source:
 - **Do NOT hardcode formatting values.** Always read from blocks data and replicate.
 - **Do NOT copy heading/title formatting onto body paragraphs.** Read from body text blocks (alignment "justify" or "left"), not title blocks.
 - **Pass structured objects, not JSON-encoded strings.** Fields like `at`, `target`, and `inline` expect objects, not serialized JSON strings.
-- **Only pass `dryRun` when the action's schema explicitly lists it.** Do not assume every action accepts it. Prefer a real call over a preview for destructive actions unless dryRun is documented for that action.
 - **If blocks still report `underline: true` after you explicitly removed it, treat it as a style inheritance artifact.** Do not retry formatting to fix it.
 - **On "Unknown field" errors, drop the unrecognized field and retry.** Use the narrowest working call shape rather than guessing alternative field names.
 - **Table styling crosses two tools.** Borders / shading / cnf flags / spacing are on `superdoc_table`; cell-text alignment and font color/weight are on `superdoc_format` (paragraph- and run-level). A "style the whole table" pass calls both. See the Tables: cross-tool workflows section for the full recipe.