superdoc 2.16.1-next.3 → 2.16.1-next.5

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.16.1-next.3",
+	superdocVersion: "2.16.1-next.5",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.16.1-next.3",
+	superdocVersion: "2.16.1-next.5",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/capabilities/capabilities.d.ts

@@ -1,7 +1,8 @@
 import { OperationId } from '../contract/types.js';
+import { OperationTrackedSupport } from '../contract/metadata-types.js';
 import { InlinePropertyStorage, InlinePropertyType, InlineRunPatchKey } from '../format/inline-run-patch.js';
 import { SDHtmlMarkdownSupportCheckInput, SDHtmlMarkdownSupportCheckResult } from './html-markdown-support.js';
-export declare const CAPABILITY_REASON_CODES: readonly ["COMMAND_UNAVAILABLE", "HELPER_UNAVAILABLE", "OPERATION_UNAVAILABLE", "TRACKED_MODE_UNAVAILABLE", "DRY_RUN_UNAVAILABLE", "NAMESPACE_UNAVAILABLE", "STYLES_PART_MISSING", "COLLABORATION_ACTIVE"];
+export declare const CAPABILITY_REASON_CODES: readonly ["COMMAND_UNAVAILABLE", "HELPER_UNAVAILABLE", "OPERATION_UNAVAILABLE", "TRACKED_MODE_UNAVAILABLE", "DRY_RUN_UNAVAILABLE", "NAMESPACE_UNAVAILABLE", "STYLES_PART_MISSING", "COLLABORATION_ACTIVE", "TARGET_CONTEXT_REQUIRED", "TARGET_UNSUPPORTED"];
 export type CapabilityReasonCode = (typeof CAPABILITY_REASON_CODES)[number];
 /**
  * A boolean flag indicating whether a capability is active, with optional
@@ -15,9 +16,36 @@ export type CapabilityFlag = {
 export interface OperationRuntimeCapability {
     available: boolean;
     tracked: boolean;
+    /**
+     * Detailed tracked-mode support. `tracked` remains true only for `always`
+     * so existing callers keep a conservative, backward-compatible boolean.
+     */
+    trackedSupport?: OperationTrackedSupport;
     dryRun: boolean;
     reasons?: CapabilityReasonCode[];
 }
+export type CapabilitySupportDecision = {
+    kind: 'supported';
+} | {
+    kind: 'unsupported';
+    code: CapabilityReasonCode;
+    reason: string;
+} | {
+    kind: 'requires-input';
+    code: 'TARGET_CONTEXT_REQUIRED';
+    reason: string;
+};
+export interface OperationCapabilityResolveInput {
+    operationId: OperationId;
+    input?: unknown;
+    options?: unknown;
+}
+export interface OperationCapabilityResolveResult {
+    operationId: OperationId;
+    available: CapabilitySupportDecision;
+    tracked: CapabilitySupportDecision;
+    dryRun: CapabilitySupportDecision;
+}
 export type OperationCapabilities = Record<OperationId, OperationRuntimeCapability>;
 /** Runtime capabilities exposed by the plan engine (mutations.apply / mutations.preview). */
 export interface PlanEngineCapabilities {
@@ -74,6 +102,7 @@ export interface DocumentApiCapabilities {
 export interface CapabilitiesAdapter {
     get(): DocumentApiCapabilities;
     check?(input: SDHtmlMarkdownSupportCheckInput): Promise<SDHtmlMarkdownSupportCheckResult>;
+    resolve?(input: OperationCapabilityResolveInput): OperationCapabilityResolveResult;
 }
 /**
  * Delegates to the capabilities adapter to retrieve the current capability snapshot.
@@ -83,3 +112,4 @@ export interface CapabilitiesAdapter {
  */
 export declare function executeCapabilities(adapter: CapabilitiesAdapter): DocumentApiCapabilities;
 export declare function executeCapabilitiesCheck(adapter: CapabilitiesAdapter, input: SDHtmlMarkdownSupportCheckInput): Promise<SDHtmlMarkdownSupportCheckResult>;
+export declare function executeCapabilitiesResolve(adapter: CapabilitiesAdapter, input: OperationCapabilityResolveInput): OperationCapabilityResolveResult;

package/dist/document-api/src/contract/command-catalog.d.ts

@@ -1,11 +1,15 @@
 import { CommandCatalog, CommandStaticMetadata, OperationId } from './types.js';
 export declare const COMMAND_CATALOG: CommandCatalog;
 /** Operation IDs whose catalog entry has `mutates: true`. */
-export declare const MUTATING_OPERATION_IDS: ("replace" | "find" | "insert" | "delete" | "info" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "tables.moveColumn" | "format.bold" | "format.strike" | "format.color" | "format.rtl" | "format.cs" | "format.shading" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "format.italic" | "format.underline" | "format.caps" | "format.smallCaps" | "format.outline" | "format.shadow" | "format.emboss" | "format.imprint" | "format.vanish" | "format.webHidden" | "format.specVanish" | "format.border" | "format.fitText" | "format.dstrike" | "format.vertAlign" | "format.position" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "format.rStyle" | "format.rFonts" | "format.eastAsianLayout" | "format.em" | "format.ligatures" | "format.numForm" | "format.numSpacing" | "format.stylisticSets" | "format.contextualAlternates" | "get" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "blocks.findText" | "blocks.list" | "blocks.delete" | "blocks.deleteRange" | "styles.apply" | "styles.getCatalog" | "templates.apply" | "create.paragraph" | "create.heading" | "create.sectionBreak" | "sections.list" | "sections.get" | "sections.setBreakType" | "sections.setPageMargins" | "sections.setHeaderFooterMargins" | "sections.setPageSetup" | "sections.setColumns" | "sections.setLineNumbering" | "sections.setPageNumbering" | "sections.setTitlePage" | "sections.setOddEvenHeadersFooters" | "sections.setVerticalAlign" | "sections.setSectionDirection" | "sections.setHeaderFooterRef" | "sections.clearHeaderFooterRef" | "sections.setLinkToPrevious" | "sections.setPageBorders" | "sections.clearPageBorders" | "styles.paragraph.setStyle" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.resetDirectFormatting" | "format.paragraph.setAlignment" | "format.paragraph.clearAlignment" | "format.paragraph.setIndentation" | "format.paragraph.clearIndentation" | "format.paragraph.setSpacing" | "format.paragraph.clearSpacing" | "format.paragraph.setKeepOptions" | "format.paragraph.setOutlineLevel" | "format.paragraph.setFlowOptions" | "format.paragraph.setTabStop" | "format.paragraph.clearTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection" | "format.paragraph.setNumbering" | "lists.list" | "lists.get" | "lists.insert" | "lists.create" | "lists.attach" | "lists.detach" | "lists.delete" | "lists.indent" | "lists.outdent" | "lists.join" | "lists.canJoin" | "lists.separate" | "lists.merge" | "lists.split" | "lists.setLevel" | "lists.setValue" | "lists.continuePrevious" | "lists.canContinuePrevious" | "lists.setLevelRestart" | "lists.convertToText" | "lists.applyTemplate" | "lists.applyPreset" | "lists.setType" | "lists.captureTemplate" | "lists.setLevelNumbering" | "lists.setLevelBullet" | "lists.setLevelPictureBullet" | "lists.setLevelAlignment" | "lists.setLevelIndents" | "lists.setLevelTrailingCharacter" | "lists.setLevelMarkerFont" | "lists.clearLevelOverrides" | "lists.getStyle" | "lists.applyStyle" | "lists.restartAt" | "lists.setLevelNumberStyle" | "lists.setLevelText" | "lists.setLevelStart" | "lists.setLevelLayout" | "comments.create" | "comments.patch" | "comments.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "trackChanges.decide" | "query.match" | "ranges.resolve" | "selection.current" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "create.table" | "tables.convertFromText" | "tables.delete" | "tables.clearContents" | "tables.move" | "tables.split" | "tables.convertToText" | "tables.setLayout" | "tables.insertRow" | "tables.deleteRow" | "tables.setRowHeight" | "tables.distributeRows" | "tables.setRowOptions" | "tables.insertColumn" | "tables.deleteColumn" | "tables.setColumnWidth" | "tables.distributeColumns" | "tables.insertCell" | "tables.deleteCell" | "tables.mergeCells" | "tables.unmergeCells" | "tables.splitCell" | "tables.setCellProperties" | "tables.setCellText" | "tables.sort" | "tables.setAltText" | "tables.setStyle" | "tables.clearStyle" | "tables.setStyleOption" | "tables.setBorder" | "tables.clearBorder" | "tables.applyBorderPreset" | "tables.setShading" | "tables.clearShading" | "tables.setTablePadding" | "tables.setCellPadding" | "tables.setCellSpacing" | "tables.clearCellSpacing" | "tables.applyStyle" | "tables.setBorders" | "tables.setTableOptions" | "tables.applyPreset" | "tables.get" | "tables.getCells" | "tables.getProperties" | "tables.getStyles" | "tables.setDefaultStyle" | "tables.clearDefaultStyle" | "create.tableOfContents" | "toc.list" | "toc.get" | "toc.configure" | "toc.update" | "toc.remove" | "toc.markEntry" | "toc.unmarkEntry" | "toc.listEntries" | "toc.getEntry" | "toc.editEntry" | "history.get" | "history.undo" | "history.redo" | "create.image" | "images.list" | "images.get" | "images.delete" | "images.move" | "images.convertToInline" | "images.convertToFloating" | "images.setSize" | "images.setWrapType" | "images.setWrapSide" | "images.setWrapDistances" | "images.setPosition" | "images.setAnchorOptions" | "images.setZOrder" | "images.scale" | "images.setLockAspectRatio" | "images.rotate" | "images.flip" | "images.crop" | "images.resetCrop" | "images.replaceSource" | "images.setAltText" | "images.setDecorative" | "images.setName" | "images.setHyperlink" | "images.insertCaption" | "images.updateCaption" | "images.removeCaption" | "hyperlinks.list" | "hyperlinks.get" | "hyperlinks.wrap" | "hyperlinks.insert" | "hyperlinks.patch" | "hyperlinks.remove" | "headerFooters.list" | "headerFooters.get" | "headerFooters.resolve" | "headerFooters.refs.set" | "headerFooters.refs.clear" | "headerFooters.refs.setLinkedToPrevious" | "headerFooters.parts.list" | "headerFooters.parts.create" | "headerFooters.parts.delete" | "watermarks.list" | "watermarks.insert" | "watermarks.replace" | "watermarks.remove" | "create.contentControl" | "contentControls.list" | "contentControls.get" | "contentControls.listInRange" | "contentControls.selectByTag" | "contentControls.selectByTitle" | "contentControls.listChildren" | "contentControls.getParent" | "contentControls.wrap" | "contentControls.unwrap" | "contentControls.delete" | "contentControls.copy" | "contentControls.move" | "contentControls.patch" | "contentControls.setLockMode" | "contentControls.setType" | "contentControls.getContent" | "contentControls.replaceContent" | "contentControls.clearContent" | "contentControls.appendContent" | "contentControls.prependContent" | "contentControls.insertBefore" | "contentControls.insertAfter" | "contentControls.getBinding" | "contentControls.setBinding" | "contentControls.clearBinding" | "contentControls.getRawProperties" | "contentControls.patchRawProperties" | "contentControls.validateWordCompatibility" | "contentControls.normalizeWordCompatibility" | "contentControls.normalizeTagPayload" | "contentControls.text.setMultiline" | "contentControls.text.setValue" | "contentControls.text.clearValue" | "contentControls.date.setValue" | "contentControls.date.clearValue" | "contentControls.date.setDisplayFormat" | "contentControls.date.setDisplayLocale" | "contentControls.date.setStorageFormat" | "contentControls.date.setCalendar" | "contentControls.checkbox.getState" | "contentControls.checkbox.setState" | "contentControls.checkbox.toggle" | "contentControls.checkbox.setSymbolPair" | "contentControls.choiceList.getItems" | "contentControls.choiceList.setItems" | "contentControls.choiceList.setSelected" | "contentControls.repeatingSection.listItems" | "contentControls.repeatingSection.insertItemBefore" | "contentControls.repeatingSection.insertItemAfter" | "contentControls.repeatingSection.cloneItem" | "contentControls.repeatingSection.deleteItem" | "contentControls.repeatingSection.setAllowInsertDelete" | "contentControls.group.wrap" | "contentControls.group.ungroup" | "bookmarks.list" | "bookmarks.get" | "bookmarks.insert" | "bookmarks.rename" | "bookmarks.remove" | "footnotes.list" | "footnotes.get" | "footnotes.insert" | "footnotes.update" | "footnotes.remove" | "footnotes.configure" | "clipboard.parse" | "clipboard.insert" | "clipboard.serializeSelection" | "crossRefs.list" | "crossRefs.get" | "crossRefs.insert" | "crossRefs.rebuild" | "crossRefs.remove" | "index.list" | "index.get" | "index.insert" | "index.configure" | "index.rebuild" | "index.remove" | "index.entries.list" | "index.entries.get" | "index.entries.insert" | "index.entries.update" | "index.entries.remove" | "captions.list" | "captions.get" | "captions.insert" | "captions.update" | "captions.remove" | "captions.configure" | "fields.list" | "fields.get" | "fields.insert" | "fields.rebuild" | "fields.remove" | "citations.list" | "citations.get" | "citations.insert" | "citations.update" | "citations.remove" | "citations.sources.list" | "citations.sources.get" | "citations.sources.insert" | "citations.sources.update" | "citations.sources.remove" | "citations.bibliography.get" | "citations.bibliography.insert" | "citations.bibliography.rebuild" | "citations.bibliography.configure" | "citations.bibliography.remove" | "authorities.list" | "authorities.get" | "authorities.insert" | "authorities.configure" | "authorities.rebuild" | "authorities.remove" | "authorities.entries.list" | "authorities.entries.get" | "authorities.entries.insert" | "authorities.entries.update" | "authorities.entries.remove" | "diff.capture" | "diff.compare" | "diff.apply" | "export.toDocx" | "protection.get" | "protection.setEditingRestriction" | "protection.clearEditingRestriction" | "permissionRanges.list" | "permissionRanges.get" | "permissionRanges.create" | "permissionRanges.remove" | "permissionRanges.updatePrincipal" | "customXml.parts.list" | "customXml.parts.get" | "customXml.parts.create" | "customXml.parts.patch" | "customXml.parts.remove" | "metadata.attach" | "metadata.list" | "metadata.get" | "metadata.update" | "metadata.remove" | "metadata.resolve")[];
+export declare const MUTATING_OPERATION_IDS: ("replace" | "find" | "insert" | "delete" | "info" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "tables.moveColumn" | "format.bold" | "format.strike" | "format.color" | "format.rtl" | "format.cs" | "format.shading" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "format.italic" | "format.underline" | "format.caps" | "format.smallCaps" | "format.outline" | "format.shadow" | "format.emboss" | "format.imprint" | "format.vanish" | "format.webHidden" | "format.specVanish" | "format.border" | "format.fitText" | "format.dstrike" | "format.vertAlign" | "format.position" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "format.rStyle" | "format.rFonts" | "format.eastAsianLayout" | "format.em" | "format.ligatures" | "format.numForm" | "format.numSpacing" | "format.stylisticSets" | "format.contextualAlternates" | "get" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "blocks.findText" | "blocks.list" | "blocks.delete" | "blocks.deleteRange" | "styles.apply" | "styles.getCatalog" | "templates.apply" | "create.paragraph" | "create.heading" | "create.sectionBreak" | "sections.list" | "sections.get" | "sections.setBreakType" | "sections.setPageMargins" | "sections.setHeaderFooterMargins" | "sections.setPageSetup" | "sections.setColumns" | "sections.setLineNumbering" | "sections.setPageNumbering" | "sections.setTitlePage" | "sections.setOddEvenHeadersFooters" | "sections.setVerticalAlign" | "sections.setSectionDirection" | "sections.setHeaderFooterRef" | "sections.clearHeaderFooterRef" | "sections.setLinkToPrevious" | "sections.setPageBorders" | "sections.clearPageBorders" | "styles.paragraph.setStyle" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.resetDirectFormatting" | "format.paragraph.setAlignment" | "format.paragraph.clearAlignment" | "format.paragraph.setIndentation" | "format.paragraph.clearIndentation" | "format.paragraph.setSpacing" | "format.paragraph.clearSpacing" | "format.paragraph.setKeepOptions" | "format.paragraph.setOutlineLevel" | "format.paragraph.setFlowOptions" | "format.paragraph.setTabStop" | "format.paragraph.clearTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection" | "format.paragraph.setNumbering" | "lists.list" | "lists.get" | "lists.insert" | "lists.create" | "lists.attach" | "lists.detach" | "lists.delete" | "lists.indent" | "lists.outdent" | "lists.join" | "lists.canJoin" | "lists.separate" | "lists.merge" | "lists.split" | "lists.setLevel" | "lists.setValue" | "lists.continuePrevious" | "lists.canContinuePrevious" | "lists.setLevelRestart" | "lists.convertToText" | "lists.applyTemplate" | "lists.applyPreset" | "lists.setType" | "lists.captureTemplate" | "lists.setLevelNumbering" | "lists.setLevelBullet" | "lists.setLevelPictureBullet" | "lists.setLevelAlignment" | "lists.setLevelIndents" | "lists.setLevelTrailingCharacter" | "lists.setLevelMarkerFont" | "lists.clearLevelOverrides" | "lists.getStyle" | "lists.applyStyle" | "lists.restartAt" | "lists.setLevelNumberStyle" | "lists.setLevelText" | "lists.setLevelStart" | "lists.setLevelLayout" | "comments.create" | "comments.patch" | "comments.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "trackChanges.decide" | "query.match" | "ranges.resolve" | "selection.current" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "capabilities.resolve" | "create.table" | "tables.convertFromText" | "tables.delete" | "tables.clearContents" | "tables.move" | "tables.split" | "tables.convertToText" | "tables.setLayout" | "tables.insertRow" | "tables.deleteRow" | "tables.setRowHeight" | "tables.distributeRows" | "tables.setRowOptions" | "tables.insertColumn" | "tables.deleteColumn" | "tables.setColumnWidth" | "tables.distributeColumns" | "tables.insertCell" | "tables.deleteCell" | "tables.mergeCells" | "tables.unmergeCells" | "tables.splitCell" | "tables.setCellProperties" | "tables.setCellText" | "tables.sort" | "tables.setAltText" | "tables.setStyle" | "tables.clearStyle" | "tables.setStyleOption" | "tables.setBorder" | "tables.clearBorder" | "tables.applyBorderPreset" | "tables.setShading" | "tables.clearShading" | "tables.setTablePadding" | "tables.setCellPadding" | "tables.setCellSpacing" | "tables.clearCellSpacing" | "tables.applyStyle" | "tables.setBorders" | "tables.setTableOptions" | "tables.applyPreset" | "tables.get" | "tables.getCells" | "tables.getProperties" | "tables.getStyles" | "tables.setDefaultStyle" | "tables.clearDefaultStyle" | "create.tableOfContents" | "toc.list" | "toc.get" | "toc.configure" | "toc.update" | "toc.remove" | "toc.markEntry" | "toc.unmarkEntry" | "toc.listEntries" | "toc.getEntry" | "toc.editEntry" | "history.get" | "history.undo" | "history.redo" | "create.image" | "images.list" | "images.get" | "images.delete" | "images.move" | "images.convertToInline" | "images.convertToFloating" | "images.setSize" | "images.setWrapType" | "images.setWrapSide" | "images.setWrapDistances" | "images.setPosition" | "images.setAnchorOptions" | "images.setZOrder" | "images.scale" | "images.setLockAspectRatio" | "images.rotate" | "images.flip" | "images.crop" | "images.resetCrop" | "images.replaceSource" | "images.setAltText" | "images.setDecorative" | "images.setName" | "images.setHyperlink" | "images.insertCaption" | "images.updateCaption" | "images.removeCaption" | "hyperlinks.list" | "hyperlinks.get" | "hyperlinks.wrap" | "hyperlinks.insert" | "hyperlinks.patch" | "hyperlinks.remove" | "headerFooters.list" | "headerFooters.get" | "headerFooters.resolve" | "headerFooters.refs.set" | "headerFooters.refs.clear" | "headerFooters.refs.setLinkedToPrevious" | "headerFooters.parts.list" | "headerFooters.parts.create" | "headerFooters.parts.delete" | "watermarks.list" | "watermarks.insert" | "watermarks.replace" | "watermarks.remove" | "create.contentControl" | "contentControls.list" | "contentControls.get" | "contentControls.listInRange" | "contentControls.selectByTag" | "contentControls.selectByTitle" | "contentControls.listChildren" | "contentControls.getParent" | "contentControls.wrap" | "contentControls.unwrap" | "contentControls.delete" | "contentControls.copy" | "contentControls.move" | "contentControls.patch" | "contentControls.setLockMode" | "contentControls.setType" | "contentControls.getContent" | "contentControls.replaceContent" | "contentControls.clearContent" | "contentControls.appendContent" | "contentControls.prependContent" | "contentControls.insertBefore" | "contentControls.insertAfter" | "contentControls.getBinding" | "contentControls.setBinding" | "contentControls.clearBinding" | "contentControls.getRawProperties" | "contentControls.patchRawProperties" | "contentControls.validateWordCompatibility" | "contentControls.normalizeWordCompatibility" | "contentControls.normalizeTagPayload" | "contentControls.text.setMultiline" | "contentControls.text.setValue" | "contentControls.text.clearValue" | "contentControls.date.setValue" | "contentControls.date.clearValue" | "contentControls.date.setDisplayFormat" | "contentControls.date.setDisplayLocale" | "contentControls.date.setStorageFormat" | "contentControls.date.setCalendar" | "contentControls.checkbox.getState" | "contentControls.checkbox.setState" | "contentControls.checkbox.toggle" | "contentControls.checkbox.setSymbolPair" | "contentControls.choiceList.getItems" | "contentControls.choiceList.setItems" | "contentControls.choiceList.setSelected" | "contentControls.repeatingSection.listItems" | "contentControls.repeatingSection.insertItemBefore" | "contentControls.repeatingSection.insertItemAfter" | "contentControls.repeatingSection.cloneItem" | "contentControls.repeatingSection.deleteItem" | "contentControls.repeatingSection.setAllowInsertDelete" | "contentControls.group.wrap" | "contentControls.group.ungroup" | "bookmarks.list" | "bookmarks.get" | "bookmarks.insert" | "bookmarks.rename" | "bookmarks.remove" | "footnotes.list" | "footnotes.get" | "footnotes.insert" | "footnotes.update" | "footnotes.remove" | "footnotes.configure" | "clipboard.parse" | "clipboard.insert" | "clipboard.serializeSelection" | "crossRefs.list" | "crossRefs.get" | "crossRefs.insert" | "crossRefs.rebuild" | "crossRefs.remove" | "index.list" | "index.get" | "index.insert" | "index.configure" | "index.rebuild" | "index.remove" | "index.entries.list" | "index.entries.get" | "index.entries.insert" | "index.entries.update" | "index.entries.remove" | "captions.list" | "captions.get" | "captions.insert" | "captions.update" | "captions.remove" | "captions.configure" | "fields.list" | "fields.get" | "fields.insert" | "fields.rebuild" | "fields.remove" | "citations.list" | "citations.get" | "citations.insert" | "citations.update" | "citations.remove" | "citations.sources.list" | "citations.sources.get" | "citations.sources.insert" | "citations.sources.update" | "citations.sources.remove" | "citations.bibliography.get" | "citations.bibliography.insert" | "citations.bibliography.rebuild" | "citations.bibliography.configure" | "citations.bibliography.remove" | "authorities.list" | "authorities.get" | "authorities.insert" | "authorities.configure" | "authorities.rebuild" | "authorities.remove" | "authorities.entries.list" | "authorities.entries.get" | "authorities.entries.insert" | "authorities.entries.update" | "authorities.entries.remove" | "diff.capture" | "diff.compare" | "diff.apply" | "export.toDocx" | "protection.get" | "protection.setEditingRestriction" | "protection.clearEditingRestriction" | "permissionRanges.list" | "permissionRanges.get" | "permissionRanges.create" | "permissionRanges.remove" | "permissionRanges.updatePrincipal" | "customXml.parts.list" | "customXml.parts.get" | "customXml.parts.create" | "customXml.parts.patch" | "customXml.parts.remove" | "metadata.attach" | "metadata.list" | "metadata.get" | "metadata.update" | "metadata.remove" | "metadata.resolve")[];
 /** Maps each operation to its human-readable description. */
 export declare const OPERATION_DESCRIPTION_MAP: Record<OperationId, string>;
 /** Maps each operation to whether it requires an open document to execute. */
 export declare const OPERATION_REQUIRES_DOCUMENT_CONTEXT_MAP: Record<OperationId, boolean>;
+/** Maps each operation to whether it may execute as an entry inside plan.execute. */
+export declare const OPERATION_BATCHABLE_MAP: Record<OperationId, boolean>;
+/** Transport aliases keyed by operation, external field, then canonical input field. */
+export declare const OPERATION_INPUT_ALIAS_MAP: Readonly<Partial<Record<OperationId, Readonly<Record<string, string>>>>>;
 /** Maps each operation to its expected-result description. */
 export declare const OPERATION_EXPECTED_RESULT_MAP: Record<OperationId, string>;
 /**

package/dist/document-api/src/contract/metadata-types.d.ts

@@ -1,6 +1,8 @@
 import { ReceiptFailureCode } from '../types/receipt.js';
 export declare const OPERATION_IDEMPOTENCY_VALUES: readonly ["idempotent", "conditional", "non-idempotent"];
 export type OperationIdempotency = (typeof OPERATION_IDEMPOTENCY_VALUES)[number];
+export declare const OPERATION_TRACKED_SUPPORT_VALUES: readonly ["always", "conditional", "never"];
+export type OperationTrackedSupport = (typeof OPERATION_TRACKED_SUPPORT_VALUES)[number];
 export declare const PRE_APPLY_THROW_CODES: readonly ["TARGET_NOT_FOUND", "CAPABILITY_UNAVAILABLE", "INVALID_TARGET", "AMBIGUOUS_TARGET", "REVISION_MISMATCH", "MATCH_NOT_FOUND", "AMBIGUOUS_MATCH", "STYLE_CONFLICT", "PRECONDITION_FAILED", "INVALID_INPUT", "CROSS_BLOCK_MATCH", "SPAN_FRAGMENTED", "TARGET_MOVED", "PLAN_CONFLICT_OVERLAP", "INVALID_STEP_COMBINATION", "REVISION_CHANGED_SINCE_COMPILE", "INVALID_INSERTION_CONTEXT", "DOCUMENT_IDENTITY_CONFLICT", "INTERNAL_ERROR", "ADDRESS_STALE", "DUPLICATE_ID", "INVALID_CONTEXT", "RAW_MODE_REQUIRED", "PRESERVE_ONLY_VIOLATION", "CAPABILITY_UNSUPPORTED", "LOCK_VIOLATION", "TYPE_MISMATCH", "STORY_NOT_FOUND", "STORY_MISMATCH", "STORY_NOT_SUPPORTED", "CROSS_STORY_PLAN", "MATERIALIZATION_FAILED"];
 export type PreApplyThrowCode = (typeof PRE_APPLY_THROW_CODES)[number];
 export interface CommandThrowPolicy {
@@ -11,6 +13,9 @@ export interface CommandStaticMetadata {
     mutates: boolean;
     idempotency: OperationIdempotency;
     supportsDryRun: boolean;
+    /** Canonical tracked-mode eligibility. Legacy boolean fields below are derived from this value. */
+    trackedSupport: OperationTrackedSupport;
+    /** @deprecated Use `trackedSupport === 'always'`. */
     supportsTrackedMode: boolean;
     /**
      * Tracked mode is permitted for *some* targets of this operation but cannot
@@ -29,6 +34,7 @@ export interface CommandStaticMetadata {
      * Without this, an adapter-level contextual allowance is unreachable from
      * any transport that gates on the contract (see `tables.setCellText`).
      */
+    /** @deprecated Use `trackedSupport === 'conditional'`. */
     supportsConditionalTrackedMode?: boolean;
     possibleFailureCodes: readonly ReceiptFailureCode[];
     throws: CommandThrowPolicy;

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -8,11 +8,15 @@ export interface OperationDefinitionEntry {
     metadata: CommandStaticMetadata;
     referenceDocPath: string;
     referenceGroup: ReferenceGroupKey;
+    /** Whether this operation may run as an entry inside plan.execute. Defaults to true. */
+    batchable?: boolean;
     skipAsATool?: boolean;
     /** Which intent tool this operation belongs to (e.g. 'edit' → superdoc_edit). */
     intentGroup?: string;
     /** Action enum value within the intent group (e.g. 'insert', 'replace'). */
     intentAction?: string;
+    /** Stable transport aliases, keyed by external name and pointing to the canonical input field. */
+    inputAliases?: Readonly<Record<string, string>>;
 }
 export interface IntentGroupMeta {
     toolName: string;
@@ -53,6 +57,7 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "templates/apply.mdx";
         readonly referenceGroup: "templates";
+        readonly batchable: false;
     };
     readonly 'create.paragraph': {
         readonly memberPath: "create.paragraph";
@@ -907,6 +912,9 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "comments/create.mdx";
         readonly referenceGroup: "comments";
+        readonly inputAliases: {
+            readonly parentId: "parentCommentId";
+        };
         readonly intentGroup: "comment";
         readonly intentAction: "create";
     };
@@ -918,6 +926,9 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "comments/patch.mdx";
         readonly referenceGroup: "comments";
+        readonly inputAliases: {
+            readonly id: "commentId";
+        };
         readonly intentGroup: "comment";
         readonly intentAction: "update";
     };
@@ -929,6 +940,9 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "comments/delete.mdx";
         readonly referenceGroup: "comments";
+        readonly inputAliases: {
+            readonly id: "commentId";
+        };
         readonly intentGroup: "comment";
         readonly intentAction: "delete";
     };
@@ -940,6 +954,9 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "comments/get.mdx";
         readonly referenceGroup: "comments";
+        readonly inputAliases: {
+            readonly id: "commentId";
+        };
         readonly intentGroup: "comment";
         readonly intentAction: "get";
     };
@@ -1044,6 +1061,7 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "mutations/plan-execute.mdx";
         readonly referenceGroup: "mutations";
+        readonly batchable: false;
         readonly skipAsATool: true;
     };
     readonly 'capabilities.get': {
@@ -1066,6 +1084,16 @@ export declare const OPERATION_DEFINITIONS: {
         readonly intentGroup: "edit";
         readonly intentAction: "check_support";
     };
+    readonly 'capabilities.resolve': {
+        readonly memberPath: "capabilities.resolve";
+        readonly description: "Resolve availability, tracked-mode support, and dry-run support for one concrete operation request.";
+        readonly expectedResult: "Returns structured support decisions from the same runtime registration policy used by capability discovery.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "capabilities/resolve.mdx";
+        readonly referenceGroup: "capabilities";
+        readonly skipAsATool: true;
+    };
     readonly 'create.table': {
         readonly memberPath: "create.table";
         readonly description: "Create a new table at the target position.";
@@ -3426,49 +3454,135 @@ export declare const OPERATION_DEFINITIONS: {
         readonly referenceDocPath: "metadata/resolve.mdx";
         readonly referenceGroup: "metadata";
     };
-    readonly "format.bold": OperationDefinitionEntry;
-    readonly "format.strike": OperationDefinitionEntry;
-    readonly "format.color": OperationDefinitionEntry;
-    readonly "format.rtl": OperationDefinitionEntry;
-    readonly "format.cs": OperationDefinitionEntry;
-    readonly "format.shading": OperationDefinitionEntry;
-    readonly "format.fontFamily": OperationDefinitionEntry;
-    readonly "format.lang": OperationDefinitionEntry;
-    readonly "format.fontSize": OperationDefinitionEntry;
-    readonly "format.fontSizeCs": OperationDefinitionEntry;
-    readonly "format.highlight": OperationDefinitionEntry;
-    readonly "format.italic": OperationDefinitionEntry;
-    readonly "format.underline": OperationDefinitionEntry;
-    readonly "format.caps": OperationDefinitionEntry;
-    readonly "format.smallCaps": OperationDefinitionEntry;
-    readonly "format.outline": OperationDefinitionEntry;
-    readonly "format.shadow": OperationDefinitionEntry;
-    readonly "format.emboss": OperationDefinitionEntry;
-    readonly "format.imprint": OperationDefinitionEntry;
-    readonly "format.vanish": OperationDefinitionEntry;
-    readonly "format.webHidden": OperationDefinitionEntry;
-    readonly "format.specVanish": OperationDefinitionEntry;
-    readonly "format.border": OperationDefinitionEntry;
-    readonly "format.fitText": OperationDefinitionEntry;
-    readonly "format.dstrike": OperationDefinitionEntry;
-    readonly "format.vertAlign": OperationDefinitionEntry;
-    readonly "format.position": OperationDefinitionEntry;
-    readonly "format.bCs": OperationDefinitionEntry;
-    readonly "format.iCs": OperationDefinitionEntry;
-    readonly "format.snapToGrid": OperationDefinitionEntry;
-    readonly "format.oMath": OperationDefinitionEntry;
-    readonly "format.letterSpacing": OperationDefinitionEntry;
-    readonly "format.charScale": OperationDefinitionEntry;
-    readonly "format.kerning": OperationDefinitionEntry;
-    readonly "format.rStyle": OperationDefinitionEntry;
-    readonly "format.rFonts": OperationDefinitionEntry;
-    readonly "format.eastAsianLayout": OperationDefinitionEntry;
-    readonly "format.em": OperationDefinitionEntry;
-    readonly "format.ligatures": OperationDefinitionEntry;
-    readonly "format.numForm": OperationDefinitionEntry;
-    readonly "format.numSpacing": OperationDefinitionEntry;
-    readonly "format.stylisticSets": OperationDefinitionEntry;
-    readonly "format.contextualAlternates": OperationDefinitionEntry;
+    readonly "format.bold": OperationDefinitionEntry & {
+        memberPath: "format.bold";
+    };
+    readonly "format.strike": OperationDefinitionEntry & {
+        memberPath: "format.strike";
+    };
+    readonly "format.color": OperationDefinitionEntry & {
+        memberPath: "format.color";
+    };
+    readonly "format.rtl": OperationDefinitionEntry & {
+        memberPath: "format.rtl";
+    };
+    readonly "format.cs": OperationDefinitionEntry & {
+        memberPath: "format.cs";
+    };
+    readonly "format.shading": OperationDefinitionEntry & {
+        memberPath: "format.shading";
+    };
+    readonly "format.fontFamily": OperationDefinitionEntry & {
+        memberPath: "format.fontFamily";
+    };
+    readonly "format.lang": OperationDefinitionEntry & {
+        memberPath: "format.lang";
+    };
+    readonly "format.fontSize": OperationDefinitionEntry & {
+        memberPath: "format.fontSize";
+    };
+    readonly "format.fontSizeCs": OperationDefinitionEntry & {
+        memberPath: "format.fontSizeCs";
+    };
+    readonly "format.highlight": OperationDefinitionEntry & {
+        memberPath: "format.highlight";
+    };
+    readonly "format.italic": OperationDefinitionEntry & {
+        memberPath: "format.italic";
+    };
+    readonly "format.underline": OperationDefinitionEntry & {
+        memberPath: "format.underline";
+    };
+    readonly "format.caps": OperationDefinitionEntry & {
+        memberPath: "format.caps";
+    };
+    readonly "format.smallCaps": OperationDefinitionEntry & {
+        memberPath: "format.smallCaps";
+    };
+    readonly "format.outline": OperationDefinitionEntry & {
+        memberPath: "format.outline";
+    };
+    readonly "format.shadow": OperationDefinitionEntry & {
+        memberPath: "format.shadow";
+    };
+    readonly "format.emboss": OperationDefinitionEntry & {
+        memberPath: "format.emboss";
+    };
+    readonly "format.imprint": OperationDefinitionEntry & {
+        memberPath: "format.imprint";
+    };
+    readonly "format.vanish": OperationDefinitionEntry & {
+        memberPath: "format.vanish";
+    };
+    readonly "format.webHidden": OperationDefinitionEntry & {
+        memberPath: "format.webHidden";
+    };
+    readonly "format.specVanish": OperationDefinitionEntry & {
+        memberPath: "format.specVanish";
+    };
+    readonly "format.border": OperationDefinitionEntry & {
+        memberPath: "format.border";
+    };
+    readonly "format.fitText": OperationDefinitionEntry & {
+        memberPath: "format.fitText";
+    };
+    readonly "format.dstrike": OperationDefinitionEntry & {
+        memberPath: "format.dstrike";
+    };
+    readonly "format.vertAlign": OperationDefinitionEntry & {
+        memberPath: "format.vertAlign";
+    };
+    readonly "format.position": OperationDefinitionEntry & {
+        memberPath: "format.position";
+    };
+    readonly "format.bCs": OperationDefinitionEntry & {
+        memberPath: "format.bCs";
+    };
+    readonly "format.iCs": OperationDefinitionEntry & {
+        memberPath: "format.iCs";
+    };
+    readonly "format.snapToGrid": OperationDefinitionEntry & {
+        memberPath: "format.snapToGrid";
+    };
+    readonly "format.oMath": OperationDefinitionEntry & {
+        memberPath: "format.oMath";
+    };
+    readonly "format.letterSpacing": OperationDefinitionEntry & {
+        memberPath: "format.letterSpacing";
+    };
+    readonly "format.charScale": OperationDefinitionEntry & {
+        memberPath: "format.charScale";
+    };
+    readonly "format.kerning": OperationDefinitionEntry & {
+        memberPath: "format.kerning";
+    };
+    readonly "format.rStyle": OperationDefinitionEntry & {
+        memberPath: "format.rStyle";
+    };
+    readonly "format.rFonts": OperationDefinitionEntry & {
+        memberPath: "format.rFonts";
+    };
+    readonly "format.eastAsianLayout": OperationDefinitionEntry & {
+        memberPath: "format.eastAsianLayout";
+    };
+    readonly "format.em": OperationDefinitionEntry & {
+        memberPath: "format.em";
+    };
+    readonly "format.ligatures": OperationDefinitionEntry & {
+        memberPath: "format.ligatures";
+    };
+    readonly "format.numForm": OperationDefinitionEntry & {
+        memberPath: "format.numForm";
+    };
+    readonly "format.numSpacing": OperationDefinitionEntry & {
+        memberPath: "format.numSpacing";
+    };
+    readonly "format.stylisticSets": OperationDefinitionEntry & {
+        memberPath: "format.stylisticSets";
+    };
+    readonly "format.contextualAlternates": OperationDefinitionEntry & {
+        memberPath: "format.contextualAlternates";
+    };
     readonly get: {
         readonly memberPath: "get";
         readonly description: "Read the full document as an SDDocument structure.";
@@ -3505,6 +3619,9 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "get-node-by-id.mdx";
         readonly referenceGroup: "core";
+        readonly inputAliases: {
+            readonly id: "nodeId";
+        };
     };
     readonly getText: {
         readonly memberPath: "getText";
@@ -3547,6 +3664,7 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "project-markdown.mdx";
         readonly referenceGroup: "core";
+        readonly batchable: false;
         readonly intentGroup: "get_content";
         readonly intentAction: "markdown_projection";
     };
@@ -3558,6 +3676,7 @@ export declare const OPERATION_DEFINITIONS: {
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "project-html.mdx";
         readonly referenceGroup: "core";
+        readonly batchable: false;
         readonly intentGroup: "get_content";
         readonly intentAction: "html_projection";
     };