@superdoc/sdk 2.23.0-next.8 → 2.23.0

package/dist/guards.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function isRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+
+exports.isRecord = isRecord;

package/dist/guards.d.ts

@@ -0,0 +1 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/guards.js

@@ -0,0 +1,3 @@
+export function isRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}

package/dist/presets/core.cjs

@@ -9,6 +9,7 @@ var catalog = require('../agent/catalog.cjs');
 var runtime = require('../agent/runtime.cjs');
 var actions = require('../agent/actions.cjs');
 var embeddedPrompts_generated = require('../embedded-prompts.generated.cjs');
+var guards = require('../guards.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 /**
@@ -74,9 +75,6 @@ async function readPromptFile(fileName, label, candidateDirs = PROMPT_DIR_CANDID
         details: { triedPaths: tried },
     });
 }
-function isRecord(value) {
-    return typeof value === 'object' && value != null && !Array.isArray(value);
-}
 function isObviouslyCorruptedToolArgKey(key) {
     const trimmed = key.trim();
     return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);
@@ -85,7 +83,7 @@ function stripCorruptedToolArgKeys(value) {
     if (Array.isArray(value)) {
         return value.map((item) => stripCorruptedToolArgKeys(item));
     }
-    if (!isRecord(value))
+    if (!guards.isRecord(value))
         return value;
     const clean = {};
     for (const [key, entryValue] of Object.entries(value)) {
@@ -109,7 +107,7 @@ function validateAgentToolArgs(toolName, args) {
     if (definition == null)
         return;
     const schema = definition.inputSchema;
-    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const properties = guards.isRecord(schema.properties) ? schema.properties : {};
     const required = Array.isArray(schema.required) ? schema.required : [];
     const knownKeys = new Set(Object.keys(properties));
     const unknownKeys = Object.keys(args).filter((key) => !knownKeys.has(key));
@@ -162,7 +160,7 @@ function compactCountMap(counts) {
     return compact;
 }
 function pickScalarFields(value, keys, limit = 6) {
-    if (!isRecord(value))
+    if (!guards.isRecord(value))
         return {};
     const entries = keys
         ? keys.filter((key) => key in value).map((key) => [key, value[key]])
@@ -186,12 +184,12 @@ function compactOperationResult(result) {
     }
     if (Array.isArray(result))
         return { itemCount: result.length };
-    if (!isRecord(result))
+    if (!guards.isRecord(result))
         return { kind: typeof result };
     const compact = {
         ...pickScalarFields(result, ['success', 'status', 'count', 'total', 'applied', 'created', 'deleted']),
     };
-    if (isRecord(result.revision)) {
+    if (guards.isRecord(result.revision)) {
         const revision = pickScalarFields(result.revision, ['before', 'after', 'current']);
         if (Object.keys(revision).length > 0)
             compact.revision = revision;
@@ -200,7 +198,7 @@ function compactOperationResult(result) {
         compact.stepCount = result.steps.length;
         compact.steps = result.steps
             .slice(0, 4)
-            .map((step) => (isRecord(step) ? pickScalarFields(step, ['stepId', 'op', 'effect', 'matchCount'], 4) : {}));
+            .map((step) => (guards.isRecord(step) ? pickScalarFields(step, ['stepId', 'op', 'effect', 'matchCount'], 4) : {}));
     }
     if (Array.isArray(result.items))
         compact.itemCount = result.items.length;
@@ -532,14 +530,14 @@ const ENFORCEMENT_SIDE_DOORS = new Set([
 ]);
 const POLICY_OPTION_KEYS = ['excludeActions', 'enforceChangeMode', 'allowDirectActions'];
 async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
-    if (!isRecord(args)) {
+    if (!guards.isRecord(args)) {
         throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
             code: 'INVALID_ARGUMENT',
             details: { toolName },
         });
     }
     const sanitizedArgs = stripCorruptedToolArgKeys(args);
-    if (!isRecord(sanitizedArgs)) {
+    if (!guards.isRecord(sanitizedArgs)) {
         throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
             code: 'INVALID_ARGUMENT',
             details: { toolName },
@@ -601,7 +599,7 @@ async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
     if (catalog.isAgentToolName(toolName)) {
         validateAgentToolArgs(toolName, dispatchArgs);
         const result = await dispatchAgentTool(documentHandle, toolName, dispatchArgs, forwardOptions);
-        if (enforcing && toolName === 'superdoc_perform_action' && isRecord(result)) {
+        if (enforcing && toolName === 'superdoc_perform_action' && guards.isRecord(result)) {
             // Receipts under enforcement state the mode that actually ran, so a host
             // can audit "was this edit tracked?" without re-deriving the policy.
             const changeMode = dispatchArgs.changeMode === 'tracked' ? 'tracked' : 'direct';

package/dist/presets/core.js

@@ -22,6 +22,7 @@ import { AGENT_TOOL_DEFINITIONS, isAgentToolName, listAgentTools, resolveActionP
 import { agentApply, agentInspect, agentOperation, agentVerify } from '../agent/runtime.js';
 import { ACTION_ARGS, ACTION_DISPOSITIONS, isActionName, superdocPerformAction } from '../agent/actions.js';
 import { EMBEDDED_PROMPTS } from '../embedded-prompts.generated.js';
+import { isRecord } from '../guards.js';
 // Prompts ship as <dist>/prompts/*.md. Resolve relative to the compiled
 // module, but the module's depth differs by build: in the SDK package this
 // file is dist/presets/core.js (so prompts are at ../prompts), while the
@@ -70,9 +71,6 @@ export async function readPromptFile(fileName, label, candidateDirs = PROMPT_DIR
         details: { triedPaths: tried },
     });
 }
-function isRecord(value) {
-    return typeof value === 'object' && value != null && !Array.isArray(value);
-}
 function isObviouslyCorruptedToolArgKey(key) {
     const trimmed = key.trim();
     return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);

package/dist/presets/legacy.cjs

@@ -6,6 +6,7 @@ var node_url = require('node:url');
 var errors = require('../runtime/errors.cjs');
 var intentDispatch_generated = require('../generated/intent-dispatch.generated.cjs');
 var embeddedTools_generated = require('../embedded-tools.generated.cjs');
+var guards = require('../guards.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 /**
@@ -32,9 +33,6 @@ const providerFileByName = {
     generic: 'tools.generic.json',
 };
 const STRIP_EMPTY_OPTIONAL_ARGS = new Set(['parentId', 'parentCommentId', 'id', 'status']);
-function isRecord(value) {
-    return typeof value === 'object' && value != null && !Array.isArray(value);
-}
 function isObviouslyCorruptedToolArgKey(key) {
     const trimmed = key.trim();
     return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);
@@ -43,7 +41,7 @@ function stripCorruptedToolArgKeys(value) {
     if (Array.isArray(value)) {
         return value.map((item) => stripCorruptedToolArgKeys(item));
     }
-    if (!isRecord(value))
+    if (!guards.isRecord(value))
         return value;
     const clean = {};
     for (const [key, entryValue] of Object.entries(value)) {
@@ -139,7 +137,7 @@ function resolveDocApiMethod(documentHandle, operationId) {
     const tokens = operationId.split('.').slice(1);
     let cursor = documentHandle;
     for (const token of tokens) {
-        if (!isRecord(cursor) || !(token in cursor)) {
+        if (!guards.isRecord(cursor) || !(token in cursor)) {
             throw new errors.SuperDocCliError(`No SDK doc method found for operation ${operationId}.`, {
                 code: 'TOOL_DISPATCH_NOT_FOUND',
                 details: { operationId, token },
@@ -165,7 +163,7 @@ function resolveDocApiMethod(documentHandle, operationId) {
  */
 function validateToolArgs(toolName, args, tool) {
     const schema = tool.inputSchema;
-    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const properties = guards.isRecord(schema.properties) ? schema.properties : {};
     const required = Array.isArray(schema.required) ? schema.required : [];
     // 1. Reject unknown keys (additionalProperties: false in merged schema)
     const knownKeys = new Set(Object.keys(properties));
@@ -247,14 +245,14 @@ async function legacyGetMcpPrompt() {
     return (await readToolFile('system-prompt-mcp.md', 'MCP system prompt not found.')).raw;
 }
 async function legacyDispatch(documentHandle, toolName, args, invokeOptions) {
-    if (!isRecord(args)) {
+    if (!guards.isRecord(args)) {
         throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
             code: 'INVALID_ARGUMENT',
             details: { toolName },
         });
     }
     const sanitizedArgs = stripCorruptedToolArgKeys(args);
-    if (!isRecord(sanitizedArgs)) {
+    if (!guards.isRecord(sanitizedArgs)) {
         throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
             code: 'INVALID_ARGUMENT',
             details: { toolName },

package/dist/presets/legacy.js

@@ -19,6 +19,7 @@ import { fileURLToPath } from 'node:url';
 import { SuperDocCliError } from '../runtime/errors.js';
 import { dispatchIntentTool } from '../generated/intent-dispatch.generated.js';
 import { EMBEDDED_TOOLS } from '../embedded-tools.generated.js';
+import { isRecord } from '../guards.js';
 const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
 const TOOLS_DIR_CANDIDATES = [path.resolve(MODULE_DIR, '..', '..', 'tools'), path.resolve(MODULE_DIR, 'tools')];
 const providerFileByName = {
@@ -28,9 +29,6 @@ const providerFileByName = {
     generic: 'tools.generic.json',
 };
 const STRIP_EMPTY_OPTIONAL_ARGS = new Set(['parentId', 'parentCommentId', 'id', 'status']);
-function isRecord(value) {
-    return typeof value === 'object' && value != null && !Array.isArray(value);
-}
 function isObviouslyCorruptedToolArgKey(key) {
     const trimmed = key.trim();
     return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);

package/dist/prompts/system-prompt.md

@@ -16,8 +16,8 @@ Users speak in what they SEE, not in file-format terms. Translate their words in
 - PLACEMENT: when the user names a position, honor it exactly. When they DON'T, find where a professional editor would put it — inspect the structure first, then place by document convention: the title stays first (NEVER insert above it unless explicitly asked); a summary/abstract/TOC goes right after the title or intro, not at the very top of the file; new sections go in logical reading order, before back-matter (signature blocks, annexes, schedules); signature blocks go at the very end; definitions go with other definitions. Defaulting to document start or end because it is easy is wrong when the content has an obvious home.
 - LEGAL DOCUMENTS ARE CROSS-REFERENCED. Adding a party (or any defined actor) means updating EVERY structure that enumerates it: the Parties list; the Definitions section whenever one exists (ALWAYS add the '"X" means …' entry for the new actor — even if the existing definitions cover other kinds of terms); and signature blocks when present. Same for removals. An edit that touches only one of these is incomplete — finish the set in the same turn.
 - CLEANUP is part of the job. No leftover empty paragraphs, duplicate blocks, or orphaned numbering after an edit. If your edit creates debris, remove it in the same turn.
-- NUMBERS COME FROM SCHEMES, NEVER FROM TEXT. Do not type "11." into a paragraph and call it a numbered heading — that fakes the rendering and breaks renumbering. Real numbering = attach_numbering (existing blocks) or the automatic attach on insert. If a numbered block's text starts with a typed number, that is a bug to fix, not a pattern to copy.
-- NEW SECTIONS in clause-numbered documents (clauses 1.–10.): "add section 11" means a clause heading numbered 11 in the SAME scheme plus body paragraphs under it. Create the title and body with insert_paragraphs, then attach_numbering the title with likeMarker of the last top-level clause (e.g. "10.") — it renders as "11." automatically.
+- CLAUSE NUMBERS follow the siblings. SCHEME numbering (inspect shows numbering.marker on the blocks): never type a number into the text; a new clause = insert_paragraphs, then attach_numbering with likeMarker of the last sibling (e.g. "10.") and the rest renumbers itself. TYPED numbering (counts.lists is 0 and the siblings' text starts with the number: "\t4.\t", "\t(b)\t", "\t(i)\t"): copy that exact shape into the inserted text (leading tab, next number, tab, caption, two spaces), style a sub-item like an existing sub-item (apply_style likeText), never attach_numbering or append_list there, and renumber what follows yourself in ONE replace_text call: the later markers of the SAME sequence (a new top-level clause shifts the top-level clauses after it, not their (a)/(i) sub-runs, not an attachment's own clauses) AND every "Section N" cross-reference to a moved clause (a clause's reference to itself takes its new number). Schedule, Exhibit, Annex and Appendix labels are not clause numbers: leave them alone. A typed number is the document's convention, not a bug to fix.
+- 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.
 - 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.
@@ -42,15 +42,15 @@ ACTIONS (superdoc_perform_action with flat args)
 - insert_paragraphs: texts (in final order) — or a single text for one paragraph. headingLevel makes the first item a heading (1-6). changeMode:"tracked" if asked. Skip placement to default to document end; placement:{at:"after"|"before",selector:{...}} to position. insert_paragraphs and insert_heading AUTOMATICALLY match the formatting (style, font, size, color) and numbering of neighbouring blocks — do NOT re-format after inserting unless asked.
 - insert_heading: text, level (1-6).
 - append_list: items (string array), kind:"ordered"|"bullet". headingText/headingLevel only if asked for a heading above. placement:{at:"after"|"before",selector:{...}} builds the list at that block instead of document end — when the list belongs inside a section, ALWAYS pass placement. The receipt's placement-honored check is the truth.
-- add_list_items: entries:[{text, level?}] (level relative to the anchor: 0 = same level, 1 = nested sub-item) — or items:[…] plain strings at the list level. Locate the list by anchorText (text inside one of its items) or listOrdinal (1-based). THE way to ADD items into an EXISTING list — reuses its numbering + markers, matches the anchor item's font/size/bold/colour automatically (receipt.formattingMatched — do NOT re-format after adding unless asked), joins imported list-looking paragraphs in place, and is tracked-safe. NOT append_list (which starts a brand-new list).
+- add_list_items: entries:[{text, level?}] (level relative to the anchor: 0 = same level, 1 = nested sub-item) — or items:[…] plain strings at the list level. Locate the list by anchorText (text inside one of its items) or listOrdinal (1-based). THE way to ADD items into an EXISTING list or scheme-numbered sequence (never a typed one) — reuses its numbering + markers, matches the anchor item's font/size/bold/colour automatically (receipt.formattingMatched — do NOT re-format after adding unless asked), joins imported list-looking paragraphs in place, and is tracked-safe. NOT append_list (which starts a brand-new list).
 - convert_list: kind:"ordered"|"bullet", with listOrdinal or anchorText for real lists, OR fromMarker+toMarker (rendered clause numbers from inspect, e.g. "2.1.", "2.3.") for NUMBERED-CLAUSE ranges — including heading-styled clauses, OR fromText+toText (exact text inside the FIRST and LAST of consecutive plain paragraphs) to convert existing paragraphs into a list IN PLACE. Sub-clauses in range included automatically. THE way to convert numbering<->bullets AND the way to make existing paragraphs a list; never rewrite text to fake it, never recreate-the-content-then-delete-the-originals (two chances to lose text — convert_list fromText/toText is one lossless call).
 - split_list: anchorText (text inside the item that should START the second list), restartNumbering? (default true). Splits ONE list into two at that item — the new list restarts at 1, nested sub-items stay with their parent. THE way to "split the list starting at item N into a new list with reset numbering"; never fake it with convert_list/attach_numbering. changeMode:"tracked" records the change for review.
 - 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."). 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).
+- 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.
 - 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 the remaining items renumber. "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.
+- 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.
 - create_table: rows, columns, optional cellTexts (2D array). rows counts ALL rows INCLUDING the header — header plus one data row is rows:2. placement defaults to document end. changeMode:"tracked" if asked ("track-changes table") — the insertion itself becomes a tracked change.
 - comment_paragraphs: commentText. excludeBlockQuotes:true to skip block quotes. Applies the SAME text to every BODY paragraph (it does NOT comment the title/heading) — broadcast notes only, never review feedback (see REVIEW rule). To comment a heading too, add_comments on it explicitly.
@@ -96,7 +96,7 @@ OPERATING RULES
 - REVERTS: "undo / revert / make it back" = superdoc_perform_action undo_changes with untilMarker from the original state (a convert receipt's revertHint contains the exact call) — NEVER re-convert or re-edit to approximate the old state.
 - If the request names a target descriptively ("the indented heading", "the second clause"), inspect FIRST and use the block's actual text or nodeId — never invent find text.
 - Numbered legal clauses ("2.3.") usually live on numbered HEADINGS, not lists: if counts.lists is 0 but blocks carry numbering markers, target those blocks by nodeId. "Add item 2.4" = insert_paragraphs (one text) after the "2.3." block; the tool attaches numbering and matches formatting automatically (check receipt.contextualFormatting).
-- ADDING SEVERAL items to an existing list or numbered sequence = ONE add_list_items call (it joins the sequence and is tracked-safe — it works even when the "list" is clause numbering and counts.lists is 0). NEVER a chain of insert_paragraphs calls: multi-paragraph inserts do not auto-join numbering, and the items will land as plain paragraphs.
+- ADDING SEVERAL items to an existing list or scheme-numbered sequence = ONE add_list_items call (it joins the sequence and is tracked-safe — it works even when the "list" is clause numbering with markers and counts.lists is 0). NEVER a chain of insert_paragraphs calls there: multi-paragraph inserts do not auto-join numbering, and the items will land as plain paragraphs. TYPED sequences are the exception: ONE insert_paragraphs call whose texts carry the typed markers.
 - New SECTION headings use the SAME headingLevel as sibling section headings (title is usually level 1; sections 2+). Never default to level 1.
 - paragraphOrdinal counts visible non-empty paragraphs; bodyParagraphOrdinal counts substantive body paragraphs after front matter. Prefer paragraphOrdinal for "first/second paragraph".
 - For literal ordinal rewrites, do not switch paragraphs because the matched one looks title-like or short. If a rewrite is a no-op, keep the target and change the rewrite.

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.23.0-next.8';
+const SDK_VERSION = '2.23.0';
 
 exports.SDK_VERSION = SDK_VERSION;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.23.0-next.8";
+export declare const SDK_VERSION = "2.23.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.23.0-next.8';
+export const SDK_VERSION = '2.23.0';

package/package.json

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

package/tools/catalog.json

@@ -1517,6 +1517,14 @@
             "type": "string",
             "description": "Require exact selected text before mutation. Only explicit single-paragraph text selections support this guard. Only for action 'replace'. Omit for other actions."
           },
+          "replacementGranularity": {
+            "enum": [
+              "word",
+              "phrase",
+              "range"
+            ],
+            "description": "Tracked revision boundaries for an explicit single-paragraph text selection. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete selection. Requires changeMode: tracked. Only for action 'replace'. Omit for other actions."
+          },
           "behavior": {
             "$ref": "#/$defs/DeleteBehavior",
             "description": "Delete behavior: 'selection' (default) or 'exact'. Only for action 'delete'. Omit for other actions."

package/tools/generation-receipt.json

@@ -1,8 +1,8 @@
 {
   "formatVersion": 1,
-  "contractHash": "bc924b5585efd8f81307d866cfc6ec679039be9dc2d1f2e8c0eb0c394e2be5f7",
-  "documentApiSourceHash": "1a2d43b0207099cefeb15344c75639185d45e4cf46ffa487292771370935f92b",
-  "generatorHash": "582aa8e90f60ac6426891df34d9d815413f4c0eab37300fd438d7a393673c614",
+  "contractHash": "32dbab4c9dbd876ba853d0651199b963871ac514f441674adf937e71091686e6",
+  "documentApiSourceHash": "10dd2593185780e2adc4aa61c0f1949dcba48eb9369bd0d560e21363d8f26803",
+  "generatorHash": "a1b6eff9ef92fc0bc2df86520cfc03628f887311339a645a70b4f855caa11221",
   "inputs": {
     "apps/cli/src/host/sdk-policy.ts": "8820bc2cb4694bd665cbfacbb55c262a5df5cde4ed2a1a8d0735c09c6a5e6dd8",
     "packages/sdk/codegen/src/artifacts.mjs": "aecab7eca4694cbcf2366ddd9cabc033abddad2ff8fb0960d505580dbaf4d8b7",
@@ -15,13 +15,13 @@
     "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": "4fe97943068bf593dfc284e35857a2c491e33de0939ca7fd973a0cd51d9fa5e3",
+    "packages/sdk/langs/node/package.json": "d018761c32c84a229d2f5bc9709c0b1e417a9f2687f6cb0d0d22b05bfaa4de3a",
     "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/prompts/mcp-prompt.md": "ba1e239877b2b316744477e3ca7b6982fa265edb1358759209cc439457728e8b",
-    "packages/sdk/langs/node/src/prompts/system-prompt.md": "4881073df51001a5e448ef7f755cd858cf752c66374cb8bddc328b1356b3cc6a",
+    "packages/sdk/langs/node/src/prompts/system-prompt.md": "a756ec031837351f5a47b73968472910211c826deaf7afe401cef5c2690e3ac3",
     "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 +32,14 @@
   "outputs": {
     "packages/sdk/langs/node/src/generated/contract.ts": {
       "id": "node-contract",
-      "sha256": "a4d9b0d437b5bc477a220114610f067b34adc48a02ff9a2e450977c0ac07f446",
+      "sha256": "fd3a7a4536ee8b0bb85b55ff4f3bb6e0a68c9fead3a75f549ee6b5bf98c8a6ca",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/generated/client.ts": {
       "id": "node-client",
-      "sha256": "92d71ceeb9a53d372c3a076c5340b2f7e1208de5cf151d0dc8850a0c70d9c348",
+      "sha256": "a05cb2fbdd4ef253fdb23526820a949a699fadf89b8b2fd387b744650dd2f10f",
       "consumers": [
         "node"
       ]
@@ -53,14 +53,14 @@
     },
     "packages/sdk/langs/python/superdoc/generated/contract.py": {
       "id": "python-contract",
-      "sha256": "2217b912fadcd741d4232927d6c1f30d27f0666fcd9532949972eafbf327ecca",
+      "sha256": "977efd304ec4bbedbd7a3dcb28b8b5a0adc9b4b756114e1b70907006d7bc7027",
       "consumers": [
         "python"
       ]
     },
     "packages/sdk/langs/python/superdoc/generated/client.py": {
       "id": "python-client",
-      "sha256": "05827d8d3a1e8b1e01eabd84297af16d247ec94dd2573715e114195c43dc93e6",
+      "sha256": "fc810d54b24e30baff720730fd97f6bcd2719f1095a75544723eb93a92643155",
       "consumers": [
         "python"
       ]
@@ -95,7 +95,7 @@
     },
     "packages/sdk/tools/catalog.json": {
       "id": "tool-catalog",
-      "sha256": "386c15c0640ef0c9c74ac392e6089fe597b9b76d3455bb2f1b641d763b219f76",
+      "sha256": "3ca76b8c9bac9a2908b68aeb146eb7953f6e35cfa0c3543bc57df1ba37eb686d",
       "consumers": [
         "node",
         "python",
@@ -104,7 +104,7 @@
     },
     "packages/sdk/tools/tools-policy.json": {
       "id": "tool-policy",
-      "sha256": "0b91ea9c92e69af4e2773cac2616878b2bbb6f6e0885518169f3f8ab53da249c",
+      "sha256": "730298670a730973228ac207a76c66c90de3f7d9a38756dbbdb732ccaafcc348",
       "consumers": [
         "node",
         "python"
@@ -112,7 +112,7 @@
     },
     "packages/sdk/tools/tools.openai.json": {
       "id": "tools-openai",
-      "sha256": "3934e84c92697a6ab9fb47a5f0444b1387f9d1809bef90dce09b7d0db586b41b",
+      "sha256": "bd99a0510e50a3482b389f6f6be7f1dbc160a9570c12a3e7be3298585df957de",
       "consumers": [
         "node",
         "python",
@@ -121,7 +121,7 @@
     },
     "packages/sdk/tools/tools.anthropic.json": {
       "id": "tools-anthropic",
-      "sha256": "e58e88bb52e755e565bc81999388cb97cf82155818e3f4d48d62d6b2e818d27d",
+      "sha256": "5b9defbc04492e901e555661f4e1d7536ac0f5ad9358dfdfffc9b22103022bdf",
       "consumers": [
         "node",
         "python",
@@ -130,7 +130,7 @@
     },
     "packages/sdk/tools/tools.vercel.json": {
       "id": "tools-vercel",
-      "sha256": "3934e84c92697a6ab9fb47a5f0444b1387f9d1809bef90dce09b7d0db586b41b",
+      "sha256": "bd99a0510e50a3482b389f6f6be7f1dbc160a9570c12a3e7be3298585df957de",
       "consumers": [
         "node",
         "python",
@@ -139,7 +139,7 @@
     },
     "packages/sdk/tools/tools.generic.json": {
       "id": "tools-generic",
-      "sha256": "46e3852dd401a2587d04c3d4213f6cc4ba3417de1b88e3536c582da212243e3c",
+      "sha256": "604e62b4227958b18c54832d6a63b30e02d559b76062978488c8d523e86d2530",
       "consumers": [
         "node",
         "python",
@@ -172,21 +172,21 @@
     },
     "packages/sdk/langs/node/src/embedded-prompts.generated.ts": {
       "id": "node-embedded-prompts",
-      "sha256": "d9cca82bd3d4593285e5eb274fd0b9b309aacb7217c60b7c7d9754ad5b5426c6",
+      "sha256": "c1d21c0865063d6ebb6058f71949865cd7d0a7ee30d3a7341297a38684a2c540",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/embedded-tools.generated.ts": {
       "id": "node-embedded-tools",
-      "sha256": "e1ddeac5e7f5a753548e606130422d102654e3d9d6a77184acab37bb2650e726",
+      "sha256": "ee3db5082ad8cc2384d79f1b990c5f08e588fa50ac001541cbc1328f6309d4c4",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/runtime/sdk-version.generated.ts": {
       "id": "node-sdk-version",
-      "sha256": "34ca6483ff670a0a901a765131951adf69689fae23f4cbaf653a15cb1956157e",
+      "sha256": "663cf136c3bdd4673f3cd8e5ec274f76b895c4cac93d4c6662b1a66118ec13e9",
       "consumers": [
         "node"
       ]

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "bc924b5585efd8f81307d866cfc6ec679039be9dc2d1f2e8c0eb0c394e2be5f7"
+  "contractHash": "32dbab4c9dbd876ba853d0651199b963871ac514f441674adf937e71091686e6"
 }

package/tools/tools.anthropic.json

@@ -1480,6 +1480,14 @@
             "type": "string",
             "description": "Require exact selected text before mutation. Only explicit single-paragraph text selections support this guard. Only for action 'replace'. Omit for other actions."
           },
+          "replacementGranularity": {
+            "enum": [
+              "word",
+              "phrase",
+              "range"
+            ],
+            "description": "Tracked revision boundaries for an explicit single-paragraph text selection. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete selection. Requires changeMode: tracked. Only for action 'replace'. Omit for other actions."
+          },
           "behavior": {
             "$ref": "#/$defs/DeleteBehavior",
             "description": "Delete behavior: 'selection' (default) or 'exact'. Only for action 'delete'. Omit for other actions."

package/tools/tools.generic.json

@@ -1503,6 +1503,14 @@
             "type": "string",
             "description": "Require exact selected text before mutation. Only explicit single-paragraph text selections support this guard. Only for action 'replace'. Omit for other actions."
           },
+          "replacementGranularity": {
+            "enum": [
+              "word",
+              "phrase",
+              "range"
+            ],
+            "description": "Tracked revision boundaries for an explicit single-paragraph text selection. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete selection. Requires changeMode: tracked. Only for action 'replace'. Omit for other actions."
+          },
           "behavior": {
             "$ref": "#/$defs/DeleteBehavior",
             "description": "Delete behavior: 'selection' (default) or 'exact'. Only for action 'delete'. Omit for other actions."

package/tools/tools.openai.json

@@ -1485,6 +1485,14 @@
               "type": "string",
               "description": "Require exact selected text before mutation. Only explicit single-paragraph text selections support this guard. Only for action 'replace'. Omit for other actions."
             },
+            "replacementGranularity": {
+              "enum": [
+                "word",
+                "phrase",
+                "range"
+              ],
+              "description": "Tracked revision boundaries for an explicit single-paragraph text selection. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete selection. Requires changeMode: tracked. Only for action 'replace'. Omit for other actions."
+            },
             "behavior": {
               "$ref": "#/$defs/DeleteBehavior",
               "description": "Delete behavior: 'selection' (default) or 'exact'. Only for action 'delete'. Omit for other actions."

package/tools/tools.vercel.json

@@ -1485,6 +1485,14 @@
               "type": "string",
               "description": "Require exact selected text before mutation. Only explicit single-paragraph text selections support this guard. Only for action 'replace'. Omit for other actions."
             },
+            "replacementGranularity": {
+              "enum": [
+                "word",
+                "phrase",
+                "range"
+              ],
+              "description": "Tracked revision boundaries for an explicit single-paragraph text selection. word (default) preserves matching tokens; phrase joins edits separated only by spaces; range replaces the complete selection. Requires changeMode: tracked. Only for action 'replace'. Omit for other actions."
+            },
             "behavior": {
               "$ref": "#/$defs/DeleteBehavior",
               "description": "Delete behavior: 'selection' (default) or 'exact'. Only for action 'delete'. Omit for other actions."