@superdoc/sdk 2.27.0-next.4 → 2.27.0

package/dist/presets/full.cjs

@@ -66,6 +66,7 @@ Where things live (ids for superdoc_api_call):
 - Page layout: doc.sections.list → sectionId, then doc.sections.setPageMargins / setPageSetup / setColumns / setPageNumbering / setTitlePage / setPageBorders; doc.create.sectionBreak.
 - Header / footer text: doc.sections.list → doc.headerFooters.list → (if the slot has no explicit part) doc.headerFooters.parts.create {kind} → doc.headerFooters.refs.set {target:{kind:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant}, refId}. A new part already holds ONE empty paragraph: write into it (doc.blocks.list {in:<story>} for its blockId, then doc.insert {value, type:"text", in:<story>, blockId, offset:0}); do not add a second paragraph. Header/footer doc.insert and doc.replace refuse block targets: use target:{kind:"selection", start:{kind:"text", blockId, offset}, end:{kind:"text", blockId, offset}} plus in:<story>. Story = {kind:"story", storyType:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant}. Page number: doc.fields.insert {mode:"raw", instruction:"PAGE", at:{kind:"text", story:<same story>, segments:[{blockId, range:{start:N, end:N}}]}} after the text "Page " (N = its length); "Page N of M" adds " of " and a NUMPAGES field. Alignment: doc.format.paragraph.setAlignment with the story on the target. Odd/even variants need doc.sections.setOddEvenHeadersFooters {enabled:true} first, then one part per variant.
 - Section breaks: doc.create.sectionBreak {at:{kind:"after", target:{kind:"block", nodeType, nodeId:<last paragraph of the closing section>}}, representation:"attachToPreviousParagraph", breakType:"nextPage"} closes the section on that paragraph, as Word does; {at:{kind:"before", target:<first paragraph of the new section>}} is the same boundary; {kind:"documentEnd"} appends a new final section. Then doc.sections.list for the new sectionId and doc.sections.setPageNumbering {start:1} to restart numbering. Add one only when the task needs a new section; never delete the paragraph hosting a break to remove it.
+- Table designs: doc.styles.getTheme reads the document palette; doc.tables.listPresets {source:"word"} returns IDs and appearance (follow nextOffset). Choose by header treatment, bandedRows.effect and fill/themeColor, and borders.layout. Accent slots are document-dependent; resolve every role through colorSchemeMapping (text/background aliases use t1/t2/bg1/bg2 keys) and apply hex tint/shade. Missing style properties inherit; direct cell formatting overrides them. doc.tables.applyPreset {nodeId, preset:<returned id>, styleOptions:{headerRow:true, bandedRows:true, bandedColumns:false}} applies a design while preserving direct formatting; choose other flags to match the task. Border-only banding does not create alternating fills. Check requested constraints and preconditions before mutating.
 - Tables: doc.tables.setBorders / applyBorderPreset / setShading (table or cell background) / setCellProperties / setColumnWidth / setRowHeight / mergeCells / splitCell / sort / setStyle / setLayout; cell text formatting via doc.format.apply on the cell paragraph (new cells must match their siblings' run formatting — read a sibling with superdoc_inspect includeTableCellRuns:true). A NEW table (create_table, markdown) gets 1pt black borders: when the document already has tables, copy their convention (width, border colour and weight: superdoc_inspect / doc.tables.get a sibling) with doc.tables.setLayout and setBorders. A border weight the request leaves open is Word's 0.5pt. Table background = setShading on the table node, not shade_cells per cell.
 - Formatting: doc.format.apply {target|ref, inline:{bold, italic, underline, color, fontSize, fontFamily, highlight}}; paragraph: doc.format.paragraph.setAlignment / setIndentation / setSpacing / setBorder / setShading / setKeepOptions / setTabStop / setNumbering. Units: colours are bare hex ("0000FF"), fontSize and letterSpacing in points, paragraph indentation and spacing in twips (20 = 1pt, 1440 = 1 inch), setBorder size in eighths of a point (1pt = 8) and space in points (Word's default is 1), table widths in twips where the schema says dxa. Box border: ONE batch of four setBorder {target, side:top|bottom|left|right, style:"single", size, color}; no paragraph setBorders exists.
 - Whole-body font/size: ONE doc.format.apply with target {kind:"selection", start:{kind:"text", blockId:<first paragraph>, offset:0}, end:{kind:"text", blockId:<last paragraph>, offset:<length>}}, not set_font_family or per-paragraph calls; headers, footers and notes are separate story calls.
@@ -102,6 +103,7 @@ const QUICK_REFERENCE_IDS = [
     'doc.format.paragraph.setIndentation',
     'doc.format.paragraph.setSpacing',
     'doc.format.paragraph.setKeepOptions',
+    'doc.styles.getTheme',
     'doc.styles.getCatalog',
     'doc.styles.create',
     'doc.comments.list',
@@ -112,6 +114,8 @@ const QUICK_REFERENCE_IDS = [
     'doc.trackChanges.list',
     'doc.trackChanges.get',
     'doc.trackChanges.decide',
+    'doc.tables.listPresets',
+    'doc.tables.applyPreset',
     'doc.tables.get',
     'doc.tables.getProperties',
     'doc.tables.getCells',

package/dist/presets/full.js

@@ -63,6 +63,7 @@ Where things live (ids for superdoc_api_call):
 - Page layout: doc.sections.list → sectionId, then doc.sections.setPageMargins / setPageSetup / setColumns / setPageNumbering / setTitlePage / setPageBorders; doc.create.sectionBreak.
 - Header / footer text: doc.sections.list → doc.headerFooters.list → (if the slot has no explicit part) doc.headerFooters.parts.create {kind} → doc.headerFooters.refs.set {target:{kind:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant}, refId}. A new part already holds ONE empty paragraph: write into it (doc.blocks.list {in:<story>} for its blockId, then doc.insert {value, type:"text", in:<story>, blockId, offset:0}); do not add a second paragraph. Header/footer doc.insert and doc.replace refuse block targets: use target:{kind:"selection", start:{kind:"text", blockId, offset}, end:{kind:"text", blockId, offset}} plus in:<story>. Story = {kind:"story", storyType:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant}. Page number: doc.fields.insert {mode:"raw", instruction:"PAGE", at:{kind:"text", story:<same story>, segments:[{blockId, range:{start:N, end:N}}]}} after the text "Page " (N = its length); "Page N of M" adds " of " and a NUMPAGES field. Alignment: doc.format.paragraph.setAlignment with the story on the target. Odd/even variants need doc.sections.setOddEvenHeadersFooters {enabled:true} first, then one part per variant.
 - Section breaks: doc.create.sectionBreak {at:{kind:"after", target:{kind:"block", nodeType, nodeId:<last paragraph of the closing section>}}, representation:"attachToPreviousParagraph", breakType:"nextPage"} closes the section on that paragraph, as Word does; {at:{kind:"before", target:<first paragraph of the new section>}} is the same boundary; {kind:"documentEnd"} appends a new final section. Then doc.sections.list for the new sectionId and doc.sections.setPageNumbering {start:1} to restart numbering. Add one only when the task needs a new section; never delete the paragraph hosting a break to remove it.
+- Table designs: doc.styles.getTheme reads the document palette; doc.tables.listPresets {source:"word"} returns IDs and appearance (follow nextOffset). Choose by header treatment, bandedRows.effect and fill/themeColor, and borders.layout. Accent slots are document-dependent; resolve every role through colorSchemeMapping (text/background aliases use t1/t2/bg1/bg2 keys) and apply hex tint/shade. Missing style properties inherit; direct cell formatting overrides them. doc.tables.applyPreset {nodeId, preset:<returned id>, styleOptions:{headerRow:true, bandedRows:true, bandedColumns:false}} applies a design while preserving direct formatting; choose other flags to match the task. Border-only banding does not create alternating fills. Check requested constraints and preconditions before mutating.
 - Tables: doc.tables.setBorders / applyBorderPreset / setShading (table or cell background) / setCellProperties / setColumnWidth / setRowHeight / mergeCells / splitCell / sort / setStyle / setLayout; cell text formatting via doc.format.apply on the cell paragraph (new cells must match their siblings' run formatting — read a sibling with superdoc_inspect includeTableCellRuns:true). A NEW table (create_table, markdown) gets 1pt black borders: when the document already has tables, copy their convention (width, border colour and weight: superdoc_inspect / doc.tables.get a sibling) with doc.tables.setLayout and setBorders. A border weight the request leaves open is Word's 0.5pt. Table background = setShading on the table node, not shade_cells per cell.
 - Formatting: doc.format.apply {target|ref, inline:{bold, italic, underline, color, fontSize, fontFamily, highlight}}; paragraph: doc.format.paragraph.setAlignment / setIndentation / setSpacing / setBorder / setShading / setKeepOptions / setTabStop / setNumbering. Units: colours are bare hex ("0000FF"), fontSize and letterSpacing in points, paragraph indentation and spacing in twips (20 = 1pt, 1440 = 1 inch), setBorder size in eighths of a point (1pt = 8) and space in points (Word's default is 1), table widths in twips where the schema says dxa. Box border: ONE batch of four setBorder {target, side:top|bottom|left|right, style:"single", size, color}; no paragraph setBorders exists.
 - Whole-body font/size: ONE doc.format.apply with target {kind:"selection", start:{kind:"text", blockId:<first paragraph>, offset:0}, end:{kind:"text", blockId:<last paragraph>, offset:<length>}}, not set_font_family or per-paragraph calls; headers, footers and notes are separate story calls.
@@ -99,6 +100,7 @@ const QUICK_REFERENCE_IDS = [
     'doc.format.paragraph.setIndentation',
     'doc.format.paragraph.setSpacing',
     'doc.format.paragraph.setKeepOptions',
+    'doc.styles.getTheme',
     'doc.styles.getCatalog',
     'doc.styles.create',
     'doc.comments.list',
@@ -109,6 +111,8 @@ const QUICK_REFERENCE_IDS = [
     'doc.trackChanges.list',
     'doc.trackChanges.get',
     'doc.trackChanges.decide',
+    'doc.tables.listPresets',
+    'doc.tables.applyPreset',
     'doc.tables.get',
     'doc.tables.getProperties',
     'doc.tables.getCells',

package/dist/prompts/full-addendum.md

@@ -13,6 +13,7 @@ Recipes (ids for superdoc_api_call unless a helper is named):
 - Footnote / endnote: superdoc_perform_action {action:"insert_footnote", anchorText:"Confidential Information", occurrence:1, content:"…", noteType:"footnote"}. The mark lands right after the phrase. Raw form: doc.footnotes.insert {type, content, at:{kind:"text", segments:[{blockId, range:{start,end}}]}}.
 - Picture: superdoc_perform_action {action:"insert_image", src:"eval-logo.png", position:"after", anchorText:"…", caption:"Figure 1 — …"} (file path, URL, or data URI; omit position/anchorText for document end). Centre it afterwards with format_paragraph on the image's paragraph and the caption if asked. Fine-tuning: doc.images.setSize / setWrapType / setPosition / setAltText.
 - Shade a header row / column / table: superdoc_perform_action {action:"shade_cells", tableOrdinal:1, rowIndex:0, color:"D9D9D9"}. Borders: doc.tables.setBorders / applyBorderPreset; cell props: doc.tables.setCellProperties (cell target only); widths/heights: setColumnWidth / setRowHeight / distributeRows / distributeColumns; merge/split: mergeCells / splitCell; sort; setStyle / applyStyle / setLayout.
+- Built-in Word table style (Grid Table 4 – Accent 1, List Table 3, Plain Table 2, …): doc.tables.listPresets {source:"word", query:"Grid Table 4"} returns preset IDs (follow nextOffset for more), then doc.tables.applyPreset {nodeId, preset:<returned id>, styleOptions:{headerRow, bandedRows, firstColumn, …}}. Read doc.styles.getTheme to resolve appearance color refs against this document, including colorSchemeMapping for all roles and hex tint/shade; never assume an accent slot is green. Select header fill, shading banding (not border-only bands), and border layout from appearance. Missing properties inherit and direct formatting overrides style cues. Use the "-accent-N" preset for theme colours, never accentColor. Direct edit only. doc.tables.getStyles lists styles already in the document; applyStyle references one of those IDs.
 - New table cells that must match neighbours: after insert_table_row / setCellText, read a sibling cell's run properties (superdoc_inspect with table runs) and apply them with doc.format.apply {target:{kind:"selection", start:{kind:"text", blockId:<cell paragraph>, offset:0}, end:{kind:"text", blockId, offset:<text length>}}, inline:{fontSize, fontFamily, bold, …}}. A new cell with default formatting next to 10pt siblings is a bug.
 - Page layout: doc.sections.list first (sectionId), then doc.sections.setPageMargins / setPageSetup (size, orientation) / setColumns / setPageNumbering / setTitlePage / setOddEvenHeadersFooters / setPageBorders / setBreakType; doc.create.sectionBreak for a new section.
 - Header / footer text: (1) doc.sections.list → sectionId; (2) doc.headerFooters.list → which slots exist and whether the slot is explicit; (3) if the slot has no explicit part: doc.headerFooters.parts.create {kind:"header"|"footer"} → refId, then doc.headerFooters.refs.set {target:{kind:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant:"default"|"first"|"even"}, refId}; (4) write text with doc.create.paragraph {text, in:{kind:"story", storyType:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant}, at:{kind:"documentEnd"}}; (5) page number: doc.fields.insert {mode:"raw", instruction:"PAGE", at:{kind:"text", story:<that same story>, segments:[{blockId:<the paragraph you created>, range:{start:N, end:N}}]}} where N is the offset inside that paragraph. Repeat for variant "first"/"even" when the document uses different first/even pages (headerFooters.list tells you).

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.27.0-next.4';
+const SDK_VERSION = '2.27.0';
 
 exports.SDK_VERSION = SDK_VERSION;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.27.0-next.4";
+export declare const SDK_VERSION = "2.27.0";

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.27.0-next.4';
+export const SDK_VERSION = '2.27.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.27.0-next.4",
+  "version": "2.27.0",
   "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.27.0-next.4",
-    "@superdoc/sdk-darwin-x64": "2.27.0-next.4",
-    "@superdoc/sdk-linux-x64": "2.27.0-next.4",
-    "@superdoc/sdk-linux-arm64": "2.27.0-next.4",
-    "@superdoc/sdk-windows-x64": "2.27.0-next.4"
+    "@superdoc/sdk-darwin-arm64": "2.27.0",
+    "@superdoc/sdk-darwin-x64": "2.27.0",
+    "@superdoc/sdk-linux-x64": "2.27.0",
+    "@superdoc/sdk-linux-arm64": "2.27.0",
+    "@superdoc/sdk-windows-x64": "2.27.0"
   },
   "publishConfig": {
     "access": "public"
@@ -53,7 +53,7 @@
     "typecheck": "tsc --noEmit",
     "typecheck:consumer": "tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext --moduleResolution NodeNext ../../../../tests/consumer-typecheck/src/sdk-per-open-collaboration-auth.mts ../../../../tests/consumer-typecheck/src/sdk-replace-file.mts ../../../../tests/consumer-typecheck/src/sdk-retained-paragraph.mts ../../../../tests/consumer-typecheck/src/sdk-state-directory.mts ../../../../tests/consumer-typecheck/src/sdk-agent-evidence.mts ../../../../tests/consumer-typecheck/src/sdk-custom-actions.mts ../../../../tests/consumer-typecheck/src/sd4807-sdk-inspect.mts ../../../../tests/consumer-typecheck/src/sdk-tracked-only-policy.mts ../../../../tests/consumer-typecheck/src/sdk-tracked-review-route.mts ../../../../tests/consumer-typecheck/src/sd5266-sdk-placeholder-null.mts ../../../../tests/consumer-typecheck/src/sdk-schema-types.mts",
     "test:agent-actions": "bun test src/__tests__/actions.test.ts src/__tests__/agent-runtime.test.ts src/__tests__/execution-context.test.ts src/__tests__/custom-actions.test.ts src/__tests__/textbox-snapshot.test.ts",
-    "test:cli-host": "bun test src/__tests__/diff-tracked-styles.e2e.test.ts src/__tests__/diff-direct-styles.e2e.test.ts src/__tests__/default-cli-optimization.e2e.test.ts src/runtime/__tests__/host-spawn-args.test.ts src/runtime/__tests__/cli-host.test.ts src/__tests__/tracked-review-route.test.ts src/__tests__/cli-document-lifecycle.e2e.test.ts src/__tests__/request-timeout-ms.e2e.test.ts src/__tests__/agent-evidence.e2e.test.ts src/__tests__/agent-apply.e2e.test.ts src/__tests__/find-text.e2e.test.ts src/__tests__/custom-actions.e2e.test.ts src/__tests__/typed-engine-cli-a3c.e2e.test.ts",
+    "test:cli-host": "bun test src/__tests__/diff-tracked-styles.e2e.test.ts src/__tests__/diff-direct-styles.e2e.test.ts src/__tests__/default-cli-optimization.e2e.test.ts src/runtime/__tests__/host-spawn-args.test.ts src/runtime/__tests__/cli-host.test.ts src/__tests__/tracked-review-route.test.ts src/__tests__/cli-document-lifecycle.e2e.test.ts src/__tests__/request-timeout-ms.e2e.test.ts src/__tests__/full-preset-table-presets.e2e.test.ts src/__tests__/agent-evidence.e2e.test.ts src/__tests__/agent-apply.e2e.test.ts src/__tests__/find-text.e2e.test.ts src/__tests__/custom-actions.e2e.test.ts src/__tests__/typed-engine-cli-a3c.e2e.test.ts",
     "smoke:product-action": "node scripts/product-action-smoke.mjs"
   }
 }

package/tools/catalog.json

@@ -3547,11 +3547,25 @@
             "description": "Line spacing rule. Required when 'line' is set. Only for action 'set_spacing'. Omit for other actions."
           },
           "contextualSpacing": {
-            "type": "boolean",
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
             "description": "Only for action 'set_flow_options'. Omit for other actions."
           },
           "pageBreakBefore": {
-            "type": "boolean",
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
             "description": "Only for action 'set_flow_options'. Omit for other actions."
           },
           "suppressAutoHyphens": {
@@ -5482,6 +5496,32 @@
             "minLength": 1,
             "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
           },
+          "authorIdentity": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "providerId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "userId": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "providerId",
+                  "userId"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Explicit provider-issued comment account. Omitted author attribution inherits the configured identity; explicit author fields opt out of a configured identity unless a pair is supplied. Null explicitly opts out. Unconfigured identities keep existing name-only export behavior. Only for action 'create'. Omit for other actions."
+          },
           "metadata": {
             "type": "object",
             "additionalProperties": true,

package/tools/generation-receipt.json

@@ -1,8 +1,8 @@
 {
   "formatVersion": 1,
-  "contractHash": "67d2fe0392b01382a12e7a22c4802c47859daf8023416d8ae1d2f85018aabf80",
-  "documentApiSourceHash": "ceec5c125a3b69dab05ef4e4e3a777a49fc576dc4326845025c3e003938795e9",
-  "generatorHash": "3923bb2c89673f667eb651022b01addad5b8f027c3678e9e585a208c43339034",
+  "contractHash": "6d03c60721081c3b4d6e3d4d677688ad1967f58b267a85824de5a42330a71c87",
+  "documentApiSourceHash": "e5454994813cc71a8ddf8337b720983a15a457f653ec183ec33e749980fe4dd5",
+  "generatorHash": "c5e5b6ecc72f3cea42d5979a48eb077e160442cb6ab0f1048cd33aeaea6dc41f",
   "inputs": {
     "apps/cli/src/host/sdk-policy.ts": "df3587f39b4888a7b11135cc453126febb6fa8e4d3fb59b3f4f9169b4364dcd3",
     "packages/sdk/codegen/src/artifacts.mjs": "1e03c94c1da3cca73a078b5ab445f891409e6053eb695d52933628226c7f1583",
@@ -18,19 +18,19 @@
     "packages/sdk/codegen/src/node22-core-characters.json": "ba26df167c0853b955b6e04d856a899a7c83865c7b5834d80645d1b41d66c693",
     "packages/sdk/codegen/src/shared.mjs": "a411e7ea4fab43b5b08b00294c746ff7063ceddbae66ece8d8c5990f131e0f7c",
     "packages/sdk/codegen/src/targets.mjs": "62c5ae3e3813e07b37e62487d973bac60ef6bea558a01f3ace2e0c6e8374e147",
-    "packages/sdk/langs/node/package.json": "c0c8f204058a94163e824a2254377dc82383d12e4c9d45a3a6e9b7fc3d9c5a37",
+    "packages/sdk/langs/node/package.json": "848a13c5e9dfe02cce0aa7f7367bbe880be2cc646769d211464d9b26fb27e4e0",
     "packages/sdk/langs/node/scripts/embed-prompts.mjs": "1b1641bf89cad962a4ff11d93f301fe5a4e32fe856cd3c9586106d8aaab4ad80",
     "packages/sdk/langs/node/scripts/embed-tools.mjs": "4cd8b0605b088421ea1fdf8e4e19c70f571f4e3352309a1480491600122e7bb3",
     "packages/sdk/langs/node/scripts/embed-version.mjs": "95e2ff3a7c15cb38130e12f04c8a96c901a5e55d9960610ebefa37178fd19cde",
     "packages/sdk/langs/node/src/agent/action-descriptors.json": "b2afbe8a23454bf807f7220172fb6211ccd098849f1ca27dc3546fdc352c8e48",
-    "packages/sdk/langs/node/src/agent/actions.ts": "a5ee29da19690344586e39f18631924c58ae8852b49b18339eeadaa45b1ea971",
+    "packages/sdk/langs/node/src/agent/actions.ts": "b5fdb14fdb8a79e3b44513d07b52a304f12d75300c4ae3d63efbb7c0795529bf",
     "packages/sdk/langs/node/src/agent/catalog.ts": "2b602247785611b1c8bfdf59fb2c03a810ec4bc2346655ec9e76d979bb382179",
     "packages/sdk/langs/node/src/presets/core.ts": "b0f32dfc94ddfc86ad96a676da26b526edfcd5f658bfc077d880df69c057c214",
-    "packages/sdk/langs/node/src/prompts/full-addendum.md": "1c18055ddee8e40661417f75d16c12741c7b5f89987386396dc673b4fc837875",
+    "packages/sdk/langs/node/src/prompts/full-addendum.md": "6dbe191b0f72d144adb2c04fe1e3eba9e399aa7e081405bb98ead9a91b92113b",
     "packages/sdk/langs/node/src/prompts/mcp-prompt.md": "ba1e239877b2b316744477e3ca7b6982fa265edb1358759209cc439457728e8b",
     "packages/sdk/langs/node/src/prompts/system-prompt.md": "dd9bdac644843db2f4964ea091f5c832b8c8eb058703861210374037c077bb92",
     "packages/sdk/langs/node/src/runtime/tracked-support.ts": "779efa7c8a949090aa83e7db93d4fa84500e7563a2d47c464305f4513c424e6f",
-    "packages/sdk/langs/rust/Cargo.toml": "18f2f1cc98055b77b9368c27335a2d82816cf4c8d2376e93697c34d6450ba0ae",
+    "packages/sdk/langs/rust/Cargo.toml": "52527b242b65b534d6afa0eae090817c5d0a49205f8ad3c099bb074121a2c391",
     "packages/sdk/langs/rust/rust-toolchain.toml": "080d1c422a980a506912db5c2cc9fbedcf1df1fe4c8de676934ab7c421c5d768",
     "packages/sdk/scripts/sdk-generate.mjs": "fc5b0cb07a39972694a0c60cfef19b2e166ec12890fb5060e97b2b818f746ef3",
     "packages/sdk/scripts/sdk-platform-targets.mjs": "1c9d5d29f346bdccad4dadcabca371d8a2943b1613ad5a673dcee8ecfac511b5",
@@ -42,49 +42,49 @@
   "outputs": {
     "packages/sdk/langs/rust/src/generated/mod.rs": {
       "id": "rust-mod",
-      "sha256": "e07e97de86a03ea4c64919ee23c8584cf07612a2aec762499b4c6b45c3712d8a",
+      "sha256": "4f2ae3fe2633820f36231e1abc0cfc42e16115ece738078d9d91a0c6ff97b7bd",
       "consumers": [
         "rust"
       ]
     },
     "packages/sdk/langs/rust/src/generated/types.rs": {
       "id": "rust-types",
-      "sha256": "40f41cf13908df8d0f45d34dc02286355925dc5f84aefb1e38c70db2425e6cd3",
+      "sha256": "14a9854bf2ba5a132011a58f9ee20118d6001d7305c0810bc399d92dbf1a3752",
       "consumers": [
         "rust"
       ]
     },
     "packages/sdk/langs/rust/src/generated/operations.rs": {
       "id": "rust-operations",
-      "sha256": "d3d2e6d35482a71cc150fe853ad63e9e426b112b3c4f1d8c074be531e7c12f80",
+      "sha256": "d093e8c0c3d071f64343ee7a72da290577baa122c582785c89e8b1cf30bcb352",
       "consumers": [
         "rust"
       ]
     },
     "packages/sdk/langs/rust/assets/contract.json": {
       "id": "rust-contract",
-      "sha256": "9310fd98f9425ecc40a47d504de4bf1330329e61e2b4a2e6b7a2c99d3b0f898a",
+      "sha256": "493e8e98802aa54eb97a09d70f11badcf419fc3b2bc78251d0469e4b9fc1cb15",
       "consumers": [
         "rust"
       ]
     },
     "packages/sdk/langs/rust/assets/action-policy.json": {
       "id": "rust-action-policy",
-      "sha256": "95160a6f5adb6c37cf2ec7bb532dbcac90865f7a5218bd5f305f636b31a8adf7",
+      "sha256": "fe323f1a81199fcc5ff7a6c7c8f908eabede979427c31fe9866d908e18fe4730",
       "consumers": [
         "rust"
       ]
     },
     "packages/sdk/langs/node/src/generated/contract.ts": {
       "id": "node-contract",
-      "sha256": "3f52e57265a61fe5bd810577d08609c355621552e2c89b3e6d9606c34c65578d",
+      "sha256": "d28a622130bf1528f0e34791454ff3decc7ac15fe3d774dc0457592e11c35221",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/generated/client.ts": {
       "id": "node-client",
-      "sha256": "3b264deb29612aed21ccb2fbb9798ea34ec308578540f201209d95c81c834641",
+      "sha256": "5ab8c98f9ae255d2d32700abf1f4a7d6c6cd3a181c03c39c54f7ef3fd8c2cbe9",
       "consumers": [
         "node"
       ]
@@ -98,14 +98,14 @@
     },
     "packages/sdk/langs/python/superdoc/generated/contract.py": {
       "id": "python-contract",
-      "sha256": "c5093485313e585353eb89a8efc5cb4c3465fb21ba53daa0bb936112beade3e2",
+      "sha256": "43a0fdf830052da45ccf86ba11039a2d793cae62abe666eec0af211988128767",
       "consumers": [
         "python"
       ]
     },
     "packages/sdk/langs/python/superdoc/generated/client.py": {
       "id": "python-client",
-      "sha256": "1b848a952098a35fb78f9a056693fff8d99bf68d49d0fa17e48a93395ad9b54d",
+      "sha256": "ba0dbaa3606207137b368befadee7eca6ca98ff3157a7f9b328b403a8aa72912",
       "consumers": [
         "python"
       ]
@@ -140,7 +140,7 @@
     },
     "packages/sdk/tools/catalog.json": {
       "id": "tool-catalog",
-      "sha256": "b71b75ecbb6c84e4949cfdac8028b7eaf51e4a536da6154037db3bc7858ff17d",
+      "sha256": "8ed0e6de53f58906af5e2557c436b887a347d6aa19972dc7f96dcf21387185a5",
       "consumers": [
         "node",
         "python",
@@ -149,7 +149,7 @@
     },
     "packages/sdk/tools/tools-policy.json": {
       "id": "tool-policy",
-      "sha256": "c8b1e511217f76f4e1393e757040d70bc6937b337f28396c77644f6598dc36f8",
+      "sha256": "761dee9c779e349ccd1d0f0fb9062615c650fe471058ce01a0acb572bac7e043",
       "consumers": [
         "node",
         "python"
@@ -157,7 +157,7 @@
     },
     "packages/sdk/tools/tools.openai.json": {
       "id": "tools-openai",
-      "sha256": "af312bf776869ec50c3ddba32184a4a9c7ad9444467cace18d6b17d1edba5d8a",
+      "sha256": "6c4e9958cdf2baf0e4caa77d7a094119bf1dc218b3254f85931e6b66984ef240",
       "consumers": [
         "node",
         "python",
@@ -166,7 +166,7 @@
     },
     "packages/sdk/tools/tools.anthropic.json": {
       "id": "tools-anthropic",
-      "sha256": "229aa2f5bd470b121bfd34aeaef0130a48e0a906954e786806afe4ef4211d82e",
+      "sha256": "cae209818a7cd1a8c5b9e9d540ac103d96df4403f1cb259e96d0ad56f57a2b32",
       "consumers": [
         "node",
         "python",
@@ -175,7 +175,7 @@
     },
     "packages/sdk/tools/tools.vercel.json": {
       "id": "tools-vercel",
-      "sha256": "af312bf776869ec50c3ddba32184a4a9c7ad9444467cace18d6b17d1edba5d8a",
+      "sha256": "6c4e9958cdf2baf0e4caa77d7a094119bf1dc218b3254f85931e6b66984ef240",
       "consumers": [
         "node",
         "python",
@@ -184,7 +184,7 @@
     },
     "packages/sdk/tools/tools.generic.json": {
       "id": "tools-generic",
-      "sha256": "c8d5b52a3f5f7c0b40f6c0ff40b6c6d328bae85518d3502abeab7ec4b242e9cc",
+      "sha256": "357580eec809e66757d2d4be777c8a374eddc7e818cb1d574b5f51012ed09058",
       "consumers": [
         "node",
         "python",
@@ -217,21 +217,21 @@
     },
     "packages/sdk/langs/node/src/embedded-prompts.generated.ts": {
       "id": "node-embedded-prompts",
-      "sha256": "ce8426cf995a2d6d693626b175263d63df7cc736fd71a96e262d4b4eebbdb45e",
+      "sha256": "4f15851ce14cdd81db1c74b5e746e63d205706e89865e808fc1d38c74bd6d0f3",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/embedded-tools.generated.ts": {
       "id": "node-embedded-tools",
-      "sha256": "17bbb031d2c5ad9b9c04f868cd46f035936b3cc5e26c3217f5a567f1a189d4c2",
+      "sha256": "d10266bcf94f298ca9b03f5875114c7ae15dd916adb526d7e392963ba027db07",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/runtime/sdk-version.generated.ts": {
       "id": "node-sdk-version",
-      "sha256": "aa7d39fafb7b2c596caee428b67afbbe3c97ac1fc050893eb1b35c27852afde6",
+      "sha256": "9cb574f6524877aeee34afe64e36a96bb1cb92ddc49f2e4a52c4d463c404dd45",
       "consumers": [
         "node"
       ]

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "67d2fe0392b01382a12e7a22c4802c47859daf8023416d8ae1d2f85018aabf80"
+  "contractHash": "6d03c60721081c3b4d6e3d4d677688ad1967f58b267a85824de5a42330a71c87"
 }

package/tools/tools.anthropic.json

@@ -3347,11 +3347,25 @@
             "description": "Line spacing rule. Required when 'line' is set. Only for action 'set_spacing'. Omit for other actions."
           },
           "contextualSpacing": {
-            "type": "boolean",
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
             "description": "Only for action 'set_flow_options'. Omit for other actions."
           },
           "pageBreakBefore": {
-            "type": "boolean",
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
             "description": "Only for action 'set_flow_options'. Omit for other actions."
           },
           "suppressAutoHyphens": {
@@ -5091,6 +5105,32 @@
             "minLength": 1,
             "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
           },
+          "authorIdentity": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "providerId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "userId": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "providerId",
+                  "userId"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Explicit provider-issued comment account. Omitted author attribution inherits the configured identity; explicit author fields opt out of a configured identity unless a pair is supplied. Null explicitly opts out. Unconfigured identities keep existing name-only export behavior. Only for action 'create'. Omit for other actions."
+          },
           "metadata": {
             "type": "object",
             "additionalProperties": true,

package/tools/tools.generic.json

@@ -3393,11 +3393,25 @@
             "description": "Line spacing rule. Required when 'line' is set. Only for action 'set_spacing'. Omit for other actions."
           },
           "contextualSpacing": {
-            "type": "boolean",
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
             "description": "Only for action 'set_flow_options'. Omit for other actions."
           },
           "pageBreakBefore": {
-            "type": "boolean",
+            "oneOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
             "description": "Only for action 'set_flow_options'. Omit for other actions."
           },
           "suppressAutoHyphens": {
@@ -5206,6 +5220,32 @@
             "minLength": 1,
             "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
           },
+          "authorIdentity": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "providerId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "userId": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "providerId",
+                  "userId"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Explicit provider-issued comment account. Omitted author attribution inherits the configured identity; explicit author fields opt out of a configured identity unless a pair is supplied. Null explicitly opts out. Unconfigured identities keep existing name-only export behavior. Only for action 'create'. Omit for other actions."
+          },
           "metadata": {
             "type": "object",
             "additionalProperties": true,

package/tools/tools.openai.json

@@ -3355,11 +3355,25 @@
               "description": "Line spacing rule. Required when 'line' is set. Only for action 'set_spacing'. Omit for other actions."
             },
             "contextualSpacing": {
-              "type": "boolean",
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
               "description": "Only for action 'set_flow_options'. Omit for other actions."
             },
             "pageBreakBefore": {
-              "type": "boolean",
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
               "description": "Only for action 'set_flow_options'. Omit for other actions."
             },
             "suppressAutoHyphens": {
@@ -5108,6 +5122,32 @@
               "minLength": 1,
               "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
             },
+            "authorIdentity": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "providerId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "userId": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "providerId",
+                    "userId"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Explicit provider-issued comment account. Omitted author attribution inherits the configured identity; explicit author fields opt out of a configured identity unless a pair is supplied. Null explicitly opts out. Unconfigured identities keep existing name-only export behavior. Only for action 'create'. Omit for other actions."
+            },
             "metadata": {
               "type": "object",
               "additionalProperties": true,

package/tools/tools.vercel.json

@@ -3355,11 +3355,25 @@
               "description": "Line spacing rule. Required when 'line' is set. Only for action 'set_spacing'. Omit for other actions."
             },
             "contextualSpacing": {
-              "type": "boolean",
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
               "description": "Only for action 'set_flow_options'. Omit for other actions."
             },
             "pageBreakBefore": {
-              "type": "boolean",
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
               "description": "Only for action 'set_flow_options'. Omit for other actions."
             },
             "suppressAutoHyphens": {
@@ -5108,6 +5122,32 @@
               "minLength": 1,
               "description": "Caller-owned author image URL. Only for action 'create'. Omit for other actions."
             },
+            "authorIdentity": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "providerId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "userId": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "providerId",
+                    "userId"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Explicit provider-issued comment account. Omitted author attribution inherits the configured identity; explicit author fields opt out of a configured identity unless a pair is supplied. Null explicitly opts out. Unconfigured identities keep existing name-only export behavior. Only for action 'create'. Omit for other actions."
+            },
             "metadata": {
               "type": "object",
               "additionalProperties": true,