@superdoc/sdk 2.25.0-next.1 → 2.25.0-next.10

package/dist/presets.cjs

@@ -3,6 +3,7 @@
 var errors = require('./runtime/errors.cjs');
 var legacy = require('./presets/legacy.cjs');
 var core = require('./presets/core.cjs');
+var full = require('./presets/full.cjs');
 
 /**
  * Preset registry for SuperDoc LLM tools.
@@ -37,6 +38,7 @@ const DEFAULT_PRESET = 'legacy';
 const BUILTIN_PRESETS = {
     legacy: legacy.legacyPreset,
     core: core.corePreset,
+    full: full.fullPreset,
 };
 /**
  * Mutable registry, seeded with the built-ins. Customers add their own presets

package/dist/presets.js

@@ -21,6 +21,7 @@
 import { SuperDocCliError } from './runtime/errors.js';
 import { legacyPreset } from './presets/legacy.js';
 import { corePreset } from './presets/core.js';
+import { fullPreset } from './presets/full.js';
 // ---------------------------------------------------------------------------
 // Registry
 // ---------------------------------------------------------------------------
@@ -34,6 +35,7 @@ export const DEFAULT_PRESET = 'legacy';
 const BUILTIN_PRESETS = {
     legacy: legacyPreset,
     core: corePreset,
+    full: fullPreset,
 };
 /**
  * Mutable registry, seeded with the built-ins. Customers add their own presets

package/dist/prompts/full-addendum.md

@@ -0,0 +1,40 @@
+============================================================
+EXTENDED SURFACE — the whole Document API (full preset)
+============================================================
+
+superdoc_perform_action covers the common verbs. Everything else the engine can do (a few hundred operations) is one step away. Escalation ladder — always in this order:
+
+1. superdoc_perform_action — when a named action fits, use it. It matches surrounding formatting and numbering for you.
+2. Helper actions on superdoc_perform_action for the frequent gaps: insert_image, insert_footnote, shade_cells, compare_with_file. One call each; they resolve ids and verify for you.
+3. superdoc_api_search — when nothing above fits, search: {query:"page margins"} / {domain:"sections"}. Then {operationId:"doc.sections.setPageMargins"} for the exact parameters. One catalog call, then act; do not browse the catalog for its own sake.
+4. superdoc_api_call — call the operation with {operationId, args}. Several operations in ONE round trip: {calls:[{operationId, args}, …]} — this is how you do repetitive work (shade eight cells, insert twelve paragraphs, apply one format to every match): read the targets once, then send one batch. It runs in order, stops at the first failure, and returns per-call receipts. Read them like any other receipt.
+
+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.
+- 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).
+- Table of contents: insert_toc action, or doc.create.tableOfContents; doc.toc.configure / update / remove.
+- Fields, bookmarks, cross-references, hyperlinks: doc.fields.insert {mode:"raw", instruction:"…", at:<text span>}, doc.bookmarks.insert, doc.crossRefs.insert, doc.hyperlinks.insert / wrap / patch.
+- Comments & tracked changes beyond the actions: doc.comments.create / patch / delete / list; doc.trackChanges.list / get / decide {decision:"accept"|"reject", target:{kind:"id", id} | {kind:"all"}}.
+- Paragraph formatting: doc.format.paragraph.setAlignment / setIndentation / setSpacing / setBorder / setShading / setKeepOptions / setTabStop / setNumbering (block target). Character formatting: doc.format.apply {target|ref, inline:{bold, italic, underline, color, fontSize, fontFamily, highlight, …}}.
+- Lists / numbering: doc.lists.create / attach / detach / indent / outdent / setLevel / setValue / restartAt / setType / setLevelNumbering / setLevelBullet / split / join / merge.
+- Drafting long or structured content (whole memos, multi-section drafts, a document from blank): ONE doc.insert {value:"# Title\n\nParagraph…\n\n## Heading 2\n\n- bullet\n\n| col | col |\n|---|---|\n| a | b |", type:"markdown", target:{kind:"block", nodeType, nodeId}, placement:"after"|"before"} — Markdown headings become real heading styles, lists become real numbering, pipe tables become tables. Into an empty document target its only paragraph with placement:"after" (then delete_blocks it if it is blank). target:{kind:"documentStart"} is NOT valid for doc.insert; use a block target. Verify with superdoc_inspect countsOnly afterwards (headings, lists, tables counts). Read back with doc.getMarkdown.
+- Compare two documents: superdoc_perform_action {action:"compare_with_file", path:"…/other.docx"} — differences land in THIS document as tracked changes; comments/styles/numbering differences apply directly.
+- Content controls, protection, metadata, custom XML, citations, index, captions: browse the matching domain in superdoc_api_search.
+
+Targets for superdoc_api_call:
+- Block: {kind:"block", nodeType:"paragraph"|"heading"|"listItem"|"table"|"tableRow"|"tableCell"|"image"|"tableOfContents"|"sdt", nodeId}. nodeIds come from superdoc_inspect (or doc.blocks.list {textSearch:{terms:["…"]}, includeText:true}).
+- Position (`at`): {kind:"documentEnd"} | {kind:"documentStart"} | {kind:"before"|"after", target:<block>}.
+- Text span: {kind:"text", segments:[{blockId, range:{start, end}}]} — character offsets inside that block's text (doc.blocks.list with includeText:true gives the text). Add story:{…} when the block lives in a header/footer.
+- Story scope (`in`): omit for the body; headers/footers use {kind:"story", storyType:"headerFooterSlot", section:{kind:"section", sectionId}, headerFooterKind, variant}.
+- changeMode:"tracked" only where the catalog says supportsTrackedMode (some refuse it for certain inputs; the error says why), dryRun only where supportsDryRun — otherwise the call is refused before anything runs. Table and section property changes are direct-only.
+- Preview requests ("preview", "what would change", "without making the change"): if the operation supportsDryRun, call it with dryRun:true and report the receipt; nothing is written. Otherwise describe from an inspect.
+
+Rules for the extended surface:
+- The receipt is still the truth. {success:false, failure} means nothing changed for that call — read the failure, fix the args (usually a wrong target shape or a missing nodeId), retry once. A thrown VALIDATION error (unknown/missing parameter, wrong id) also changed nothing. After a TIMEOUT or transport error, re-inspect before retrying an insert: the mutation may have landed.
+- After a structural superdoc_api_call (table, section, header/footer, footnote, image), verify with a narrow superdoc_inspect before declaring done.
+- Repetition is a batch, not a call per item. If you are about to make the same superdoc_api_call call a third time with different arguments, send the rest as one {calls:[…]} batch instead.
+- Never claim a capability is missing without a superdoc_api_search search first.

package/dist/prompts/system-prompt.md

@@ -20,6 +20,7 @@ Users speak in what they SEE, not in file-format terms. Translate their words in
 - REMOVING an item from a lettered or numbered run ("(a) …, (b) … and (c) …", sub-clauses ending "; and") reletters the items that follow and moves the closing conjunction to the new penultimate item, so the last one ends the way the list ends: deleting (iv) from "(ii) …; (iii) …; and (iv) …." takes TWO edits, (ii) "…;" becomes "…; and" and (iii) "…; and" becomes "…." (read (ii) first; it is in the paragraph above). Striking a defined term touches only clauses that use that exact term; look-alike terms ("Material Subsidiary" beside "Immaterial Subsidiary") stay. Clause text the user supplies goes in exactly as written: no added lead-ins, no rephrasing unless asked.
 - NEVER END THE TURN WITH THE DOCUMENT WORSE THAN YOU FOUND IT. If your own cleanup or undo removed content the user wanted — including text you wrote earlier this conversation — restore it IMMEDIATELY in the same turn (you know what it said; re-insert it or redo). Do not ask permission to repair damage you caused.
 - REVIEW means READING. "Comment on what can be improved" / "review this" / "give feedback" = read the actual text first (superdoc_inspect), then write comments that are SPECIFIC to each passage — quote or reference what the passage says and what to change. Identical boilerplate stamped on every paragraph is a failed review, not a review. comment_paragraphs applies ONE identical text everywhere — it is ONLY for broadcast notes ("please verify this section"); for review feedback use add_comments per target, each with its own text.
+- SUMMARIES: when inspect counts show comments or trackedChanges, read those domains too and mention them.
 - ACT when intent is plain; ask only when the request is genuinely ambiguous AND the wrong guess would be destructive. One clarifying question maximum, with your best-guess default stated.
 
 ============================================================
@@ -48,7 +49,7 @@ ACTIONS (superdoc_perform_action with flat args)
 - undo_changes: untilMarker (rendered marker from the original state, e.g. "2.1.") or steps (1-25). Deterministic revert — steps history back until the marker reappears; the receipt proves it. NEVER use steps > 1 blindly: prefer untilMarker, and after ANY undo verify (superdoc_inspect) that content you meant to KEEP still exists — if you overshot, redo_changes {steps:N} steps forward again to recover it.
 - redo_changes: steps (1-25, default 1). Steps history FORWARD to re-apply edits a prior undo removed — THE recovery for an undo overshoot. Only reaches the forward branch until a NEW edit is made.
 - attach_numbering: anchorText (text of the block) or nodeId, likeMarker (rendered marker of a sibling clause, e.g. "10."). Scheme numbering only (it fails where the numbers are typed text). Makes an EXISTING block a numbered clause at the same scheme/level — "make this the section 11 heading" in a clause-numbered document is exactly this (it will render as the next number).
-- replace_text: edits:[{find,replace,occurrence?}], caseSensitive default false. selector to scope. Keep find/replace spans MINIMAL. If the find appears more than once in the selected block and only one should change, give that edit occurrence (1 = first match in the block; needs selector; not selector.occurrence). With occurrence, also pass expectedRevision from your latest inspect or receipt; on REVISION_CONFLICT inspect again and recount. changeMode:"tracked" if asked. The receipt reports editsApplied and editsSkipped per find — READ IT: a skipped find is not in the selected block; re-target instead of assuming success.
+- replace_text: edits:[{find,replace,occurrence?}], caseSensitive default false. selector to scope. Keep find/replace spans MINIMAL. If the find appears more than once in the selected block and only one should change, give that edit occurrence (1 = first match in the block; needs selector; not selector.occurrence). With occurrence, also pass expectedRevision from your latest inspect or receipt; on REVISION_CONFLICT inspect again and recount. changeMode:"tracked" if asked; to redline a reworded phrase or clause as ONE deletion plus ONE insertion, add granularity:"range". The receipt reports editsApplied and editsSkipped per find — READ IT: a skipped find is not in the selected block; re-target instead of assuming success.
 - delete_text: finds:[string]. selector to scope deletions to ONE block — REQUIRED for whitespace-only finds (unscoped whitespace matches document-wide and is refused). changeMode:"tracked" if asked. Deletes TEXT ONLY: the block survives, so a list item keeps its bullet/number and an accepted tracked deletion leaves an empty numbered item behind. To remove the item itself use delete_blocks.
 - delete_blocks: selectors:[…], each resolving to ONE block (list item, paragraph or heading). changeMode:"tracked" if asked. THE way to DELETE a whole LIST ITEM, paragraph or heading — the bullet/number goes with it and scheme-numbered items renumber (typed markers after a deleted typed clause need the replace_text renumbering above). "Delete the first item under Article II" / "remove that clause" is exactly this, NOT delete_text. Pass every target in ONE call. Use delete_table for a whole table. The receipt's listPunctuation names the two edits that close the run after the deletion; apply them.
 - rewrite_block: selector, text. Inspect first to gather current text; never ask the user to paste text already in the doc.
@@ -73,7 +74,7 @@ ACTIONS (superdoc_perform_action with flat args)
 - move_text: text (the exact span/clause to relocate), afterText (destination — REQUIRED for a direct move). changeMode:"tracked" records the move as a redline (tracked delete of the source + tracked insert at the destination; afterText may then be omitted — the copy lands right after the struck source). For a text SPAN; whole sections = move_range, tables = move_table.
 - 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.
+- 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, accent top and bottom 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.
 - 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.

package/dist/runtime/document-rpc.cjs

@@ -3,6 +3,7 @@
 var node_crypto = require('node:crypto');
 var errors = require('./errors.cjs');
 var sdkPolicy = require('./sdk-policy.cjs');
+var trackedSupport = require('./tracked-support.cjs');
 var transportCommon = require('./transport-common.cjs');
 
 const DOCUMENT_RPC_FEATURES = sdkPolicy.SDK_POLICY.documentRpcFeatures;
@@ -125,13 +126,6 @@ function mapDocumentReplaceFileResult(response, sessionId) {
         document: { byteLength: record.byteLength, revision: record.revision },
     };
 }
-function supportsTrackedMode(operation) {
-    if (operation.trackedSupport === 'always' || operation.trackedSupport === 'conditional')
-        return true;
-    if (operation.trackedSupport === 'never')
-        return false;
-    return operation.supportsTrackedMode === true || operation.supportsConditionalTrackedMode === true;
-}
 function documentInvokePayload(operation, params, invokeOptions) {
     params = transportCommon.captureMutationPlanAuthor(operation.operationId, params, invokeOptions);
     const normalizedParams = transportCommon.applyOperationParamAliases(operation, params);
@@ -177,7 +171,7 @@ function documentInvokePayload(operation, params, invokeOptions) {
             options[name] = projectedValue;
         }
     }
-    if (options.changeMode !== undefined && !supportsTrackedMode(operation)) {
+    if (options.changeMode !== undefined && !trackedSupport.operationAcceptsTrackedMode(operation)) {
         if (options.changeMode === 'tracked') {
             throw unsupported(`Structured document RPC does not support tracked mode for ${operation.operationId}.`, operation.operationId);
         }

package/dist/runtime/document-rpc.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { SuperDocCliError } from './errors.js';
 import { SDK_POLICY } from './sdk-policy.js';
+import { operationAcceptsTrackedMode } from './tracked-support.js';
 import { applyOperationParamAliases, captureMutationPlanAuthor, } from './transport-common.js';
 export const DOCUMENT_RPC_FEATURES = SDK_POLICY.documentRpcFeatures;
 export const DOCUMENT_RPC_REPLACE_FILE_FEATURE = SDK_POLICY.features.replaceFile;
@@ -122,13 +123,6 @@ export function mapDocumentReplaceFileResult(response, sessionId) {
         document: { byteLength: record.byteLength, revision: record.revision },
     };
 }
-function supportsTrackedMode(operation) {
-    if (operation.trackedSupport === 'always' || operation.trackedSupport === 'conditional')
-        return true;
-    if (operation.trackedSupport === 'never')
-        return false;
-    return operation.supportsTrackedMode === true || operation.supportsConditionalTrackedMode === true;
-}
 function documentInvokePayload(operation, params, invokeOptions) {
     params = captureMutationPlanAuthor(operation.operationId, params, invokeOptions);
     const normalizedParams = applyOperationParamAliases(operation, params);
@@ -174,7 +168,7 @@ function documentInvokePayload(operation, params, invokeOptions) {
             options[name] = projectedValue;
         }
     }
-    if (options.changeMode !== undefined && !supportsTrackedMode(operation)) {
+    if (options.changeMode !== undefined && !operationAcceptsTrackedMode(operation)) {
         if (options.changeMode === 'tracked') {
             throw unsupported(`Structured document RPC does not support tracked mode for ${operation.operationId}.`, operation.operationId);
         }

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.25.0-next.1';
+const SDK_VERSION = '2.25.0-next.10';
 
 exports.SDK_VERSION = SDK_VERSION;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.25.0-next.1";
+export declare const SDK_VERSION = "2.25.0-next.10";

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.25.0-next.1';
+export const SDK_VERSION = '2.25.0-next.10';

package/dist/runtime/tracked-support.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+function operationAcceptsTrackedMode(operation) {
+    if (operation?.trackedSupport === 'always' || operation?.trackedSupport === 'conditional')
+        return true;
+    if (operation?.trackedSupport === 'never')
+        return false;
+    return operation?.supportsTrackedMode === true || operation?.supportsConditionalTrackedMode === true;
+}
+
+exports.operationAcceptsTrackedMode = operationAcceptsTrackedMode;

package/dist/runtime/tracked-support.d.ts

@@ -0,0 +1,6 @@
+export type TrackedSupportFlags = {
+    readonly trackedSupport?: unknown;
+    readonly supportsTrackedMode?: unknown;
+    readonly supportsConditionalTrackedMode?: unknown;
+};
+export declare function operationAcceptsTrackedMode(operation: TrackedSupportFlags | undefined): boolean;

package/dist/runtime/tracked-support.js

@@ -0,0 +1,7 @@
+export function operationAcceptsTrackedMode(operation) {
+    if (operation?.trackedSupport === 'always' || operation?.trackedSupport === 'conditional')
+        return true;
+    if (operation?.trackedSupport === 'never')
+        return false;
+    return operation?.supportsTrackedMode === true || operation?.supportsConditionalTrackedMode === true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.25.0-next.1",
+  "version": "2.25.0-next.10",
   "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.25.0-next.1",
-    "@superdoc/sdk-darwin-x64": "2.25.0-next.1",
-    "@superdoc/sdk-linux-x64": "2.25.0-next.1",
-    "@superdoc/sdk-linux-arm64": "2.25.0-next.1",
-    "@superdoc/sdk-windows-x64": "2.25.0-next.1"
+    "@superdoc/sdk-darwin-arm64": "2.25.0-next.10",
+    "@superdoc/sdk-darwin-x64": "2.25.0-next.10",
+    "@superdoc/sdk-linux-x64": "2.25.0-next.10",
+    "@superdoc/sdk-linux-arm64": "2.25.0-next.10",
+    "@superdoc/sdk-windows-x64": "2.25.0-next.10"
   },
   "publishConfig": {
     "access": "public"

package/tools/catalog.json

@@ -7297,6 +7297,15 @@
                           ],
                           "type": "string"
                         },
+                        "replacementGranularity": {
+                          "enum": [
+                            "word",
+                            "phrase",
+                            "range"
+                          ],
+                          "type": "string",
+                          "description": "Tracked revision boundaries for each rewritten range. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete range. Requires changeMode: tracked and a single-paragraph text range in visible coordinates; by:\"ref\" steps do not accept it."
+                        },
                         "style": {
                           "type": "object",
                           "properties": {

package/tools/generation-receipt.json

@@ -1,8 +1,8 @@
 {
   "formatVersion": 1,
-  "contractHash": "571c15fc12f574bfea752e1f34d5d26943b857086f82aa803386b16ff6cb748b",
-  "documentApiSourceHash": "be4011c4eaa7e9ab162283b4b61ae458c938f68f8f56098ba851d1fe777a280e",
-  "generatorHash": "555e161a6df034042019bf44c7c396e6971ff680d0f2e53c4987fcad3859f24b",
+  "contractHash": "756068a9617daba6d9b4281bbb7efe4225ac79896afbafaee12a4c7f90d21fa1",
+  "documentApiSourceHash": "e1a052db04cdc53e9bdc5773aac68ae29b283a12a9452b7c083f84cd60aa31a0",
+  "generatorHash": "87fa6da38480ef496e4a79a020a382f7e29fe3add24751483153042aca970c2e",
   "inputs": {
     "apps/cli/src/host/sdk-policy.ts": "8820bc2cb4694bd665cbfacbb55c262a5df5cde4ed2a1a8d0735c09c6a5e6dd8",
     "packages/sdk/codegen/src/artifacts.mjs": "aecab7eca4694cbcf2366ddd9cabc033abddad2ff8fb0960d505580dbaf4d8b7",
@@ -15,13 +15,14 @@
     "packages/sdk/codegen/src/model/schema.mjs": "29cb1167413280907ad324d8a1fcb54dc70cce829df00c1a755f43040d01cf3b",
     "packages/sdk/codegen/src/shared.mjs": "a411e7ea4fab43b5b08b00294c746ff7063ceddbae66ece8d8c5990f131e0f7c",
     "packages/sdk/codegen/src/targets.mjs": "62c5ae3e3813e07b37e62487d973bac60ef6bea558a01f3ace2e0c6e8374e147",
-    "packages/sdk/langs/node/package.json": "c527a428e4f0e1607cee8ec49ab918c3c54752cfcae122bb1e4f3a9d0b0d4beb",
+    "packages/sdk/langs/node/package.json": "c03be53800c98f324458cbc200c85c784160da2ff4f5b15b0090c00ef97c690d",
     "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": "427fdf2a163bbc6c25f0a165b84cfb17ea2b27a92611ec74cdc19bc77bff2594",
+    "packages/sdk/langs/node/src/agent/action-descriptors.json": "b2afbe8a23454bf807f7220172fb6211ccd098849f1ca27dc3546fdc352c8e48",
+    "packages/sdk/langs/node/src/prompts/full-addendum.md": "1c18055ddee8e40661417f75d16c12741c7b5f89987386396dc673b4fc837875",
     "packages/sdk/langs/node/src/prompts/mcp-prompt.md": "ba1e239877b2b316744477e3ca7b6982fa265edb1358759209cc439457728e8b",
-    "packages/sdk/langs/node/src/prompts/system-prompt.md": "a756ec031837351f5a47b73968472910211c826deaf7afe401cef5c2690e3ac3",
+    "packages/sdk/langs/node/src/prompts/system-prompt.md": "dd9bdac644843db2f4964ea091f5c832b8c8eb058703861210374037c077bb92",
     "packages/sdk/scripts/sdk-generate.mjs": "fc5b0cb07a39972694a0c60cfef19b2e166ec12890fb5060e97b2b818f746ef3",
     "packages/sdk/scripts/sdk-platform-targets.mjs": "6bdcd55fec9695c7af44ee5c7f67065450f61c27cdd9552d68b92e88abb9d7ab",
     "packages/sdk/tools/prompt-templates/system-prompt-core.md": "98632908dbece800115db92181b2a48823725b6e2612383de6bc6c34f57ac72e",
@@ -32,14 +33,14 @@
   "outputs": {
     "packages/sdk/langs/node/src/generated/contract.ts": {
       "id": "node-contract",
-      "sha256": "3a731906dd26de618b324ea4fd035211dac464d3cb7e923d56ad58ae581b601e",
+      "sha256": "120d819c4fae9de6ded1a66369dbfa91c038b96f1f15b9ca192e42cd31c4a55b",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/generated/client.ts": {
       "id": "node-client",
-      "sha256": "3ad801a85830aa6b29983a199557ae3a2172b03870b9faeadecf838c53c3dea6",
+      "sha256": "443e8cc3ed7a72ade8fb9539b024c5caab231e7320594994335985871f4a180a",
       "consumers": [
         "node"
       ]
@@ -53,14 +54,14 @@
     },
     "packages/sdk/langs/python/superdoc/generated/contract.py": {
       "id": "python-contract",
-      "sha256": "55af1018df757766c0f9a699a472e5319902b6506af55e47ede87f185fd6a4ba",
+      "sha256": "a08508e328c7c41b8e8ecd8ef086d537d20407dc95becb3d920b240b625d68b1",
       "consumers": [
         "python"
       ]
     },
     "packages/sdk/langs/python/superdoc/generated/client.py": {
       "id": "python-client",
-      "sha256": "8f45241f01762c57e4c8e8d6fd6e4cae669f11f9095d712d7a3f19af605b4788",
+      "sha256": "f55c6cf0cd9c0f9cb330608faa4f18936bebf61e1ec297062d894f791043d2a2",
       "consumers": [
         "python"
       ]
@@ -95,7 +96,7 @@
     },
     "packages/sdk/tools/catalog.json": {
       "id": "tool-catalog",
-      "sha256": "606606282b03c08d15c437e064f9a96783ddf02662ac3634b0e750528b1f5a4e",
+      "sha256": "0d22fe1e3bda56c043cd8e2156ec2af6f53e71db18dd1ce3a04486952c564976",
       "consumers": [
         "node",
         "python",
@@ -104,7 +105,7 @@
     },
     "packages/sdk/tools/tools-policy.json": {
       "id": "tool-policy",
-      "sha256": "8d3fd959cb3b3fd22bb8f5da31a33fb6de801376cb8e54e22fa5d9e8ececab10",
+      "sha256": "fb0195e4130bb323efa3fc9bddab193c6ea595656da14fa64222464ead34f853",
       "consumers": [
         "node",
         "python"
@@ -112,7 +113,7 @@
     },
     "packages/sdk/tools/tools.openai.json": {
       "id": "tools-openai",
-      "sha256": "fdf1f16a1555ff4262e6889417ba712c3f4f139e930c272ee2ede2032c2aced1",
+      "sha256": "f41b4b2c1813d784bb2d32b48575e69d6fc05545bfcb3d29fa6ee690342d6270",
       "consumers": [
         "node",
         "python",
@@ -121,7 +122,7 @@
     },
     "packages/sdk/tools/tools.anthropic.json": {
       "id": "tools-anthropic",
-      "sha256": "790291ea69a13c8d1cbc73443dac73cc39c7a488b1a835a5fd40274b1ebe64bc",
+      "sha256": "0920c8379fe6b116d34114a0f56378b52a7261aad78b55a59514ea5d1af3a903",
       "consumers": [
         "node",
         "python",
@@ -130,7 +131,7 @@
     },
     "packages/sdk/tools/tools.vercel.json": {
       "id": "tools-vercel",
-      "sha256": "fdf1f16a1555ff4262e6889417ba712c3f4f139e930c272ee2ede2032c2aced1",
+      "sha256": "f41b4b2c1813d784bb2d32b48575e69d6fc05545bfcb3d29fa6ee690342d6270",
       "consumers": [
         "node",
         "python",
@@ -139,7 +140,7 @@
     },
     "packages/sdk/tools/tools.generic.json": {
       "id": "tools-generic",
-      "sha256": "ea4d922bed6f2f42cc42ce4e618f91614cf0a265874ff80b15ec510b4ef5e312",
+      "sha256": "81d9007fb7daaf902da38f0bb83681e21969e5eee609a74eb80c637f33b95e50",
       "consumers": [
         "node",
         "python",
@@ -172,21 +173,21 @@
     },
     "packages/sdk/langs/node/src/embedded-prompts.generated.ts": {
       "id": "node-embedded-prompts",
-      "sha256": "c1d21c0865063d6ebb6058f71949865cd7d0a7ee30d3a7341297a38684a2c540",
+      "sha256": "ce8426cf995a2d6d693626b175263d63df7cc736fd71a96e262d4b4eebbdb45e",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/embedded-tools.generated.ts": {
       "id": "node-embedded-tools",
-      "sha256": "93669a5667db7f68372e3a8695b207ce064ec87599c99afbc372e08f122ef841",
+      "sha256": "69cd0f4c4a7fdb5c1fc631dc99ce659da811b4ab3fed9a220aabe8f2e62a503c",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/runtime/sdk-version.generated.ts": {
       "id": "node-sdk-version",
-      "sha256": "d83e737e02020f832a97557c8c4ac5daf38bb81ef58c3bd010dde2385ab24fbc",
+      "sha256": "8c36ae4227c435ef950b4237e6d408fde0555e6df1dce86fad64488a7886b68a",
       "consumers": [
         "node"
       ]

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "571c15fc12f574bfea752e1f34d5d26943b857086f82aa803386b16ff6cb748b"
+  "contractHash": "756068a9617daba6d9b4281bbb7efe4225ac79896afbafaee12a4c7f90d21fa1"
 }

package/tools/tools.anthropic.json

@@ -6849,6 +6849,15 @@
                           ],
                           "type": "string"
                         },
+                        "replacementGranularity": {
+                          "enum": [
+                            "word",
+                            "phrase",
+                            "range"
+                          ],
+                          "type": "string",
+                          "description": "Tracked revision boundaries for each rewritten range. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete range. Requires changeMode: tracked and a single-paragraph text range in visible coordinates; by:\"ref\" steps do not accept it."
+                        },
                         "style": {
                           "type": "object",
                           "properties": {

package/tools/tools.generic.json

@@ -7017,6 +7017,15 @@
                           ],
                           "type": "string"
                         },
+                        "replacementGranularity": {
+                          "enum": [
+                            "word",
+                            "phrase",
+                            "range"
+                          ],
+                          "type": "string",
+                          "description": "Tracked revision boundaries for each rewritten range. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete range. Requires changeMode: tracked and a single-paragraph text range in visible coordinates; by:\"ref\" steps do not accept it."
+                        },
                         "style": {
                           "type": "object",
                           "properties": {

package/tools/tools.openai.json

@@ -6875,6 +6875,15 @@
                             ],
                             "type": "string"
                           },
+                          "replacementGranularity": {
+                            "enum": [
+                              "word",
+                              "phrase",
+                              "range"
+                            ],
+                            "type": "string",
+                            "description": "Tracked revision boundaries for each rewritten range. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete range. Requires changeMode: tracked and a single-paragraph text range in visible coordinates; by:\"ref\" steps do not accept it."
+                          },
                           "style": {
                             "type": "object",
                             "properties": {

package/tools/tools.vercel.json

@@ -6875,6 +6875,15 @@
                             ],
                             "type": "string"
                           },
+                          "replacementGranularity": {
+                            "enum": [
+                              "word",
+                              "phrase",
+                              "range"
+                            ],
+                            "type": "string",
+                            "description": "Tracked revision boundaries for each rewritten range. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete range. Requires changeMode: tracked and a single-paragraph text range in visible coordinates; by:\"ref\" steps do not accept it."
+                          },
                           "style": {
                             "type": "object",
                             "properties": {