@superdoc/mcp 1.9.0-next.5 → 1.9.0-next.6

package/dist/index.js

@@ -31620,7 +31620,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.22.0-next.5";
+var SDK_VERSION = "2.22.0-next.6";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -165526,6 +165526,7 @@ function createParagraphSemanticOwnershipCollector(xml) {
         paragraphOwner = { start: event.start, ancestors: [...stack], hasSemanticRange: false, ownership: Object.freeze({
           containerKind: parent.local === "body" ? "body" : "cell",
           containerId: parent.containerId,
+          containerPath: Object.freeze(stack.filter((frame) => frame.plain && (frame.local === "body" || frame.local === "tc")).map((frame) => frame.containerId)),
           namespaceBindings: createCanonicalXmlNamespaceBindings(Object.entries(event.namespaceBindings)),
           parentNamespaceBindings: parent.namespaceBindings
         }) };
@@ -166048,6 +166049,17 @@ function relatedLogicalIds(entry) {
     ...entry.subsumption?.role === "parent" ? entry.subsumption.ownedChildIds : []
   ];
 }
+function paragraphEndsCertifiedContainer(state, review, paragraph) {
+  const ownership = readResidentParagraphOwnership(state, paragraph.blockId);
+  if (!ownership)
+    return false;
+  const end = Math.min(payloadLength(review.payload), paragraph.byteEnd + 256);
+  const bytes = readResidentPartRangeFromStateSync(state, review.partUri, paragraph.byteEnd, end);
+  if (!bytes)
+    return false;
+  const close = /^[ \t\r\n]*<\/(?:([A-Za-z_][\w.-]*):)?(body|tc)[ \t\r\n]*>/.exec(decoder4.decode(bytes));
+  return close?.[2] === (ownership.containerKind === "cell" ? "tc" : "body") && ownership.parentNamespaceBindings[close[1] ?? ""] === NS_W;
+}
 function readResidentReviewComponent(state, mode, sourceIds, includeCoordinates = true) {
   const review = reviews.get(state);
   if (!review || review.payload !== state.packageBytes.getPayload(review.partUri) || sourceIds.size === 0)
@@ -166074,6 +166086,7 @@ function readResidentReviewComponent(state, mode, sourceIds, includeCoordinates
   if (!ownership || ownership.parentNamespaceBindings.w !== NS_W)
     return null;
   const hasParagraphBridge = (owner2) => (owner2.xml.match(/<w:pPr\b[\s\S]*?<\/w:pPr>/g) ?? []).some((xml) => /<w:pPrChange\b|<w:rPr\b[\s\S]*?<w:(?:ins|del)\b/.test(xml));
+  const topologyBoundaryOwners = new Set;
   const neighbor = (ordinal, delta) => {
     const paragraph2 = index.entries[ordinal], adjacent = index.entries[ordinal + delta];
     if (!paragraph2 || !adjacent)
@@ -166081,13 +166094,17 @@ function readResidentReviewComponent(state, mode, sourceIds, includeCoordinates
     const adjacentOwnership = readResidentParagraphOwnership(state, adjacent.blockId);
     if (!adjacentOwnership) {
       const current2 = review.owners.get(paragraph2.blockId), other = review.owners.get(adjacent.blockId);
-      if (current2 && other && !/<(?:[\w.-]+:)?pPr\b/.test(current2.xml) && !/<(?:[\w.-]+:)?(?:ins|del|moveFrom|moveTo|pPrChange|rPrChange)\b/.test(other.xml))
+      if (current2 && other && !/<(?:[\w.-]+:)?pPr\b/.test(current2.xml) && !/<(?:[\w.-]+:)?(?:ins|del|moveFrom|moveTo|pPrChange|rPrChange)\b/.test(other.xml)) {
+        topologyBoundaryOwners.add(paragraph2.blockId);
         return ordinal;
+      }
       return null;
     }
     if (adjacentOwnership.containerId === ownership.containerId)
       return ordinal + delta;
     const current = review.owners.get(paragraph2.blockId);
+    if (adjacentOwnership.containerPath.includes(ownership.containerId))
+      topologyBoundaryOwners.add(paragraph2.blockId);
     return current && hasParagraphBridge(current) ? null : ordinal;
   };
   const previous = neighbor(first, -1), next = neighbor(last, 1);
@@ -166153,13 +166170,13 @@ function readResidentReviewComponent(state, mode, sourceIds, includeCoordinates
       return null;
     const wrapped = prefix + xml + suffix;
     const prefixBytes = new TextEncoder().encode(prefix).length;
-    const firstChar = owners[0].charStart + review.charDeltas.at(owners[0].ordinal);
+    const firstChar2 = owners[0].charStart + review.charDeltas.at(owners[0].ordinal);
     const firstTracked = owners[0].trackedStart + review.trackedDeltas.at(owners[0].ordinal);
     const analyses = [];
     let complete = true;
     for (const owner2 of owners) {
       const paragraph2 = index.entries[owner2.ordinal];
-      const charStart = prefix.length + owner2.charStart + review.charDeltas.at(owner2.ordinal) - firstChar;
+      const charStart = prefix.length + owner2.charStart + review.charDeltas.at(owner2.ordinal) - firstChar2;
       if (wrapped.slice(charStart, charStart + owner2.xml.length) !== owner2.xml)
         return null;
       let physical = owner2.physical;
@@ -166214,6 +166231,20 @@ function readResidentReviewComponent(state, mode, sourceIds, includeCoordinates
       lookupContext: createStructuralLookupContext()
     };
   }
+  const firstChar = owners[0].charStart + review.charDeltas.at(owners[0].ordinal);
+  for (const owner2 of owners) {
+    if (!topologyBoundaryOwners.has(owner2.blockId))
+      continue;
+    const charStart = prefix.length + owner2.charStart + review.charDeltas.at(owner2.ordinal) - firstChar;
+    for (const fragments2 of component.raw.byRsid.values())
+      for (const fragment3 of fragments2) {
+        if (fragment3.kind === "ins" && fragment3.byteStart >= charStart && fragment3.byteEnd <= charStart + owner2.xml.length && isEmptyTableSplitParagraph(owner2.xml, fragment3.byteStart - charStart, fragment3.byteEnd - charStart) && !paragraphEndsCertifiedContainer(state, review, index.entries[owner2.ordinal])) {
+          if (component !== cached2)
+            component.lookupContext.dispose();
+          return null;
+        }
+      }
+  }
   const modeCached = component.logicalByMode.get(mode);
   const dependencies = componentDependencies(state, component.dependencyIds);
   let logical = modeCached && componentDependenciesMatch(modeCached.dependencies, dependencies) ? modeCached.logical : null;
@@ -166906,6 +166937,7 @@ var init_resident_review = __esm(() => {
   init_resident_paragraphs();
   init_comment_anchor_index();
   init_sd_document_state();
+  init_part_payload();
   init_paragraph_index();
   init_wml_paragraph_spans();
   init_paragraph_inline_model();
@@ -166916,6 +166948,7 @@ var init_resident_review = __esm(() => {
   init_source_inventory();
   init_export_projection();
   init_resident_paragraph_ownership();
+  init_table_split_paragraph();
   init_effective_list_reference();
   init_canonical_xml_analysis_frame();
   reviews = new WeakMap;
@@ -173793,6 +173826,54 @@ function refreshTextboxExecutionBackendCapabilities(state, geometryMutationBacke
     };
   }
 }
+function captureSourceSignalPackage(state) {
+  const parts = new Map(state.partOrder.flatMap((id) => {
+    const descriptor = state.parts.get(id)?.descriptor;
+    return descriptor ? [[id, {
+      uri: descriptor.partUri,
+      contentType: descriptor.contentType,
+      kind: descriptor.kind,
+      uncompressedSize: descriptor.size.uncompressedBytes ?? 0
+    }]] : [];
+  }));
+  const payloads = state.packageBytes.detached();
+  const source = state.lazyPackagePayloadSource;
+  const sourceParts = new Set([...state.parts].flatMap(([uri, { descriptor }]) => state.sourcePartRevisions.get(uri) === descriptor.revision ? [uri] : []));
+  const fencedMain = state.mainStorySourceRangeReader?.partUri;
+  const read = (name) => {
+    const uri = normalizePartUri(name);
+    if (!parts.has(uri) || uri === fencedMain)
+      return;
+    const retained = payloads.get(uri);
+    if (retained)
+      return retained;
+    const bytes = sourceParts.has(uri) ? source?.readPayload(uri) : undefined;
+    if (bytes)
+      payloads.set(uri, bytes);
+    return bytes ?? undefined;
+  };
+  const mainDocumentPartUri = state.mainStoryId ? state.stories.get(state.mainStoryId)?.descriptor.ownerPartUri ?? null : null;
+  const relsParts = new Map;
+  const mainRelsUri = mainDocumentPartUri ? relsUriFor(mainDocumentPartUri) : null;
+  const mainRelsBytes = mainRelsUri ? read(mainRelsUri) : undefined;
+  const mainDocumentRelationships = mainDocumentPartUri && mainRelsUri && mainRelsBytes ? parseRelationshipsXml(new TextDecoder().decode(mainRelsBytes), {
+    ownerPartUri: mainDocumentPartUri,
+    relsUri: mainRelsUri,
+    resolveTarget: (target, mode) => resolveTargetUri(mainDocumentPartUri, target, mode, parts)
+  }) : null;
+  if (mainDocumentRelationships && mainRelsUri)
+    relsParts.set(mainRelsUri, mainDocumentRelationships);
+  return {
+    parts,
+    mainDocumentPartUri,
+    mainDocumentRelationships,
+    relsParts,
+    zip: { payloads: { get: read, has: (name) => {
+      const uri = normalizePartUri(name);
+      return parts.has(uri) && uri !== fencedMain && payloads.has(uri);
+    } } }
+  };
+}
 function ensurePackagePartBytes(state, partUri) {
   const normalizedPartUri = partUri.startsWith("/") ? partUri : `/${partUri}`;
   const cached2 = state.packageBytes.get(normalizedPartUri);
@@ -182415,7 +182496,14 @@ function compileParsedOverlapEdit(input, tokens, descendedEditableContainers) {
     }
     const paragraphContainsMoveWrapper = tokens.some((token) => token.kind === "unsupported" && token.foreignTrackedWrapper !== true && (token.trackedKind === "moveFrom" || token.trackedKind === "moveTo"));
     const trackedPlainCaret = (input.coordinateSpace ?? "visible") === "tracked" && tokenOwningCollapsedCaret(input, tokens)?.kind === "plain";
-    const deletedControlBoundary = input.collapsedInlineAffinity != null && tokens.some((token) => token.kind === "unsupported" && token.deletedInlineControl === true && token.visibleStart === input.rangeStart && token.visibleEnd === input.rangeStart);
+    const deletedControlBoundary = tokens.some((token) => {
+      if (token.kind !== "unsupported" || token.deletedInlineControl !== true)
+        return false;
+      if ((input.coordinateSpace ?? "visible") !== "tracked") {
+        return input.collapsedInlineAffinity != null && token.visibleStart === input.rangeStart && token.visibleEnd === input.rangeStart;
+      }
+      return token.visibleStart === input.rangeStart && input.collapsedInlineAffinity !== "downstream" || token.visibleEnd === input.rangeStart && input.collapsedInlineAffinity !== "upstream";
+    });
     if ((paragraphContainsMoveWrapper || trackedPlainCaret || deletedControlBoundary) && input.rangeStart === input.rangeEnd && input.newText.length > 0) {
       const defersExplicitUpstreamMoveBoundary = input.changeMode === "direct" && input.collapsedInlineAffinity === "upstream" && !tokens.some((token) => token.kind === "plain" && token.visibleEnd === input.rangeStart) && tokens.some((token) => token.kind === "unsupported" && token.foreignTrackedWrapper !== true && token.trackedKind === "moveFrom" && token.visibleStart === input.rangeStart && token.visibleEnd === input.rangeStart);
       if (defersExplicitUpstreamMoveBoundary) {
@@ -193158,6 +193246,92 @@ var init_closed_history_group = __esm(() => {
   preparedGroups = new WeakMap;
 });
 
+// ../../../v2/editor-core/dist/document/transactions/tracked-annotation-reconstruction.js
+function hasTrackedRemap(refs) {
+  return refs.some((remap) => remap.from.kind === "trackedChange" || remap.to.kind === "trackedChange");
+}
+function decisionKey(prepared) {
+  return JSON.stringify({
+    txId: prepared.txId,
+    source: prepared.source,
+    base: prepared.baseRevisions,
+    created: prepared.semanticDelta.createdRefs,
+    updated: prepared.semanticDelta.updatedRefs,
+    invalidated: prepared.semanticDelta.invalidatedRefs,
+    remapped: prepared.semanticDelta.remappedRefs
+  });
+}
+function captureTrackedDecisionAnnotationReconstruction(state, prepared) {
+  if (prepared.source.kind !== "trackedChangeDecide" || prepared.source !== prepared.localApplyBundle.source || !hasTrackedRemap(prepared.semanticDelta.remappedRefs))
+    return;
+  preparedDecisions.set(prepared, {
+    state,
+    documentEpoch: state.documentRef.documentId,
+    packageRevision: state.packageRevision,
+    commitSequence: state.renderCommitSequence,
+    source: prepared.source,
+    bundle: prepared.localApplyBundle,
+    key: decisionKey(prepared)
+  });
+}
+function sourceKey(commit) {
+  return JSON.stringify({
+    documentEpoch: commit.documentEpoch,
+    commitSequence: commit.commitSequence,
+    coveredCommitSequenceStart: commit.coveredCommitSequenceStart,
+    txId: commit.txId,
+    package: commit.revisions.package,
+    historyReplay: commit.historyReplay,
+    created: commit.facts.createdRefs,
+    updated: commit.facts.updatedRefs,
+    invalidated: commit.facts.invalidatedRefs,
+    remapped: commit.facts.remappedRefs
+  });
+}
+function requiresCanonicalAnnotations(commit) {
+  return commit.classification.kind === "broad" && !commit.remote && commit.trackedAnnotations == null && commit.trackedAnnotationHistory == null && commit.trackedAnnotationHistoryGroup == null && commit.trackedAnnotationSteps == null && commit.trackedAnnotationRemovals == null && commit.sourceProjectionEffect == null && commit.sourceProjectionSteps == null && (hasTrackedRemap(commit.facts.remappedRefs) || commit.historyReplay === true && commit.facts.createdRefs.some((ref3) => ref3.kind === "trackedChange"));
+}
+function issue2(state, commit) {
+  const token = Object.freeze({});
+  issued2.set(token, { state, key: sourceKey(commit) });
+  return token;
+}
+function sealTrackedDecisionAnnotationReconstruction(state, prepared, entry, result, commit) {
+  const captured = preparedDecisions.get(prepared);
+  preparedDecisions.delete(prepared);
+  if (!captured || captured.state !== state || captured.documentEpoch !== state.documentRef.documentId || captured.source !== prepared.source || captured.bundle !== prepared.localApplyBundle || captured.key !== decisionKey(prepared) || commit.historyReplay || captured.commitSequence + 1 !== result.commitSequence || captured.packageRevision !== result.previousPackageRevision || state.history.entries.get(entry.txId) !== entry || entry.txId !== prepared.txId || commit.txId !== prepared.txId || entry.forwardPatchGroup !== result.forwardPatchGroup || entry.inversePatchGroup !== result.inversePatchGroup || result.forwardPatchGroup?.source !== captured.source || result.status !== "committed" || result.documentEpoch !== captured.documentEpoch || result.documentEpoch !== commit.documentEpoch || result.commitSequence !== state.renderCommitSequence || result.commitSequence !== commit.commitSequence || result.previousPackageRevision !== commit.revisions.package.previous || result.packageRevision !== state.packageRevision || result.packageRevision !== commit.revisions.package.next || JSON.stringify({
+    created: commit.facts.createdRefs,
+    updated: commit.facts.updatedRefs,
+    invalidated: commit.facts.invalidatedRefs,
+    remapped: commit.facts.remappedRefs
+  }) !== JSON.stringify({
+    created: prepared.semanticDelta.createdRefs,
+    updated: prepared.semanticDelta.updatedRefs,
+    invalidated: prepared.semanticDelta.invalidatedRefs,
+    remapped: prepared.semanticDelta.remappedRefs
+  }) || !requiresCanonicalAnnotations(commit))
+    return null;
+  return issue2(state, commit);
+}
+function issueTrackedAnnotationReconstruction(state, entry, result, commit) {
+  if (state.history.entries.get(entry.txId) !== entry || entry.forwardPatchGroup.source.kind !== "trackedChangeDecide" || result.status !== "committed" || result.documentEpoch !== state.documentRef.documentId || result.commitSequence !== state.renderCommitSequence || result.documentEpoch !== commit.documentEpoch || result.commitSequence !== commit.commitSequence || result.previousPackageRevision !== commit.revisions.package.previous || result.packageRevision !== state.packageRevision || result.packageRevision !== commit.revisions.package.next || commit.historyReplay !== true || !requiresCanonicalAnnotations(commit))
+    return null;
+  return issue2(state, commit);
+}
+function isIssuedTrackedAnnotationReconstruction(value) {
+  return Object.isFrozen(value) && issued2.has(value);
+}
+function readIssuedTrackedAnnotationReconstruction(commit) {
+  const token = commit.trackedAnnotationReconstruction;
+  const binding = token && issued2.get(token);
+  return !!binding && Object.isFrozen(token) && binding.key === sourceKey(commit) && commit.documentEpoch === binding.state.documentRef.documentId && commit.commitSequence <= binding.state.renderCommitSequence && requiresCanonicalAnnotations(commit);
+}
+var issued2, preparedDecisions;
+var init_tracked_annotation_reconstruction = __esm(() => {
+  issued2 = new WeakMap;
+  preparedDecisions = new WeakMap;
+});
+
 // ../../../v2/editor-core/dist/document/transactions/render-commit-annotation-effect.js
 function proveAnnotationSourceEffect(input) {
   const { before, after, commentId, operation, beforeNamespaces, afterNamespaces } = input;
@@ -193264,7 +193438,7 @@ var init_comment_tracked_change_metadata = __esm(() => {
 
 // ../../../v2/editor-core/dist/document/transactions/tracked-decision-comment-metadata.js
 function readIssuedTrackedDecisionCommentMetadata(state, prepared) {
-  const group = prepared.localApplyBundle, proof = issued2.get(group.perPart);
+  const group = prepared.localApplyBundle, proof = issued3.get(group.perPart);
   if (!proof || proof.state !== state || prepared.source.kind !== "trackedChangeDecide" || prepared.baseRevisions.package !== proof.packageRevision || prepared.baseRevisions.perPart[COMMENTS_PART_URI] !== proof.commentsRevision)
     return null;
   const parts = Object.keys(group.perPart), bodyPartUri = parts.find((uri) => uri !== COMMENTS_PART_URI);
@@ -193381,7 +193555,7 @@ function applyRetiredTrackedChangeCommentMetadataCleanup(args) {
   });
   const commentsRevision = args.state.parts.get(COMMENTS_PART_URI)?.descriptor.revision;
   if (!pendingPatch && commentsRevision && updatedRefs.length)
-    issued2.set(args.perPart, {
+    issued3.set(args.perPart, {
       state: args.state,
       packageRevision: args.state.packageRevision,
       commentsRevision,
@@ -193391,14 +193565,14 @@ function applyRetiredTrackedChangeCommentMetadataCleanup(args) {
     });
   return updatedRefs;
 }
-var TD34, TE13, issued2;
+var TD34, TE13, issued3;
 var init_tracked_decision_comment_metadata = __esm(() => {
   init_comments_catalog();
   init_comment_tracked_change_metadata();
   init_patch_substrate();
   TD34 = new TextDecoder;
   TE13 = new TextEncoder;
-  issued2 = new WeakMap;
+  issued3 = new WeakMap;
 });
 
 // ../../../v2/editor-core/dist/document/transactions/tracked-decision-comment-cascade.js
@@ -193412,7 +193586,7 @@ function fingerprint2(group, updatedRefs, invalidatedRefs) {
   ], (_key, value) => value instanceof Uint8Array ? { byteLength: value.length } : value);
 }
 function readIssuedTrackedDecisionCommentCascade(state, prepared) {
-  const group = prepared.localApplyBundle, proof = issued3.get(group.perPart);
+  const group = prepared.localApplyBundle, proof = issued4.get(group.perPart);
   if (!proof || proof.state !== state || prepared.source.kind !== "trackedChangeDecide" || prepared.baseRevisions.package !== proof.packageRevision || proof.patches.some(({ partUri, index, patch, bytes }) => {
     const entry = group.perPart[partUri];
     return entry?.kind !== "modify" || entry.patches[index] !== patch || patch.bytes.length !== bytes.length || !bytes.every((byte, index2) => patch.bytes[index2] === byte);
@@ -193565,7 +193739,7 @@ function prepareBoundedTrackedDecisionCommentCascade(input) {
         patchMaps: group.patchMaps,
         retiredSourceIds: input.retiredSourceIds
       }).filter((ref3) => ref3.kind !== "comment" || !removed.has(ref3.commentId));
-      issued3.set(group.perPart, {
+      issued4.set(group.perPart, {
         state,
         packageRevision: group.baseRevisions.package,
         bodyPartUri: paragraph.partUri,
@@ -193579,7 +193753,7 @@ function prepareBoundedTrackedDecisionCommentCascade(input) {
     }
   };
 }
-var TD35, TE14, issued3;
+var TD35, TE14, issued4;
 var init_tracked_decision_comment_cascade = __esm(() => {
   init_resident_review();
   init_body_comment_anchors();
@@ -193589,7 +193763,7 @@ var init_tracked_decision_comment_cascade = __esm(() => {
   init_patch_substrate();
   TD35 = new TextDecoder;
   TE14 = new TextEncoder;
-  issued3 = new WeakMap;
+  issued4 = new WeakMap;
 });
 
 // ../../../v2/editor-core/dist/document/transactions/render-commit-inline-effect.js
@@ -194447,7 +194621,7 @@ function issueStructuralTrackedCarrierPartition(state, input) {
   });
   const afterSourceKeys = [...new Set([...sourceKeys2, ...afterCatalog.byRsid.keys()])];
   const proof = Object.freeze({ kind: "structural-tracked-carrier-partition" });
-  issued4.set(proof, {
+  issued5.set(proof, {
     state,
     txId: input.txId,
     storyId: paragraph.storyId,
@@ -194464,7 +194638,7 @@ function issueStructuralTrackedCarrierPartition(state, input) {
 }
 function proveStructuralTrackedCarrierPartition(state, prepared, originXml, resultXml) {
   const proof = prepared.backendExtensions.storySurface?.structuralTrackedCarrierPartition;
-  const record3 = proof && issued4.get(proof);
+  const record3 = proof && issued5.get(proof);
   const source = prepared.source;
   if (!record3 || record3.state !== state || record3.txId !== prepared.txId || source.kind !== "paragraphSplit" || source.target.storyId !== record3.storyId || source.target.paraId !== record3.blockId || originXml.length !== 1 || originXml[0] !== record3.beforeXml || resultXml.length !== 2 || resultXml.join("") !== record3.afterXml)
     return false;
@@ -194626,7 +194800,7 @@ function compactPayload(payload) {
   }
   return result;
 }
-var issued4;
+var issued5;
 var init_structural_tracked_carrier_partition = __esm(() => {
   init_paragraph_inline_model();
   init_resident_paragraph_ownership();
@@ -194635,7 +194809,7 @@ var init_structural_tracked_carrier_partition = __esm(() => {
   init_comment_range_invariance();
   init_xml_sax();
   init_paragraph_mark_markers();
-  issued4 = new WeakMap;
+  issued5 = new WeakMap;
 });
 
 // ../../../v2/editor-core/dist/document/transactions/tracked-annotation-history.js
@@ -194985,7 +195159,7 @@ function cloneEnvelopeValue(value) {
     return value.map((entry) => cloneEnvelopeValue(entry));
   if (value == null || typeof value !== "object")
     return value;
-  if (isIssuedTrackedAnnotationHistoryOwner(value) || isIssuedTrackedAnnotationHistoryCapsule(value) || isIssuedTrackedAnnotationHistoryGroupCapsule(value))
+  if (isIssuedTrackedAnnotationHistoryOwner(value) || isIssuedTrackedAnnotationHistoryCapsule(value) || isIssuedTrackedAnnotationHistoryGroupCapsule(value) || isIssuedTrackedAnnotationReconstruction(value))
     return value;
   const clone2 = {};
   for (const [key3, entry] of Object.entries(value)) {
@@ -197396,6 +197570,8 @@ function collapseSDRenderCommitEnvelopes(commits) {
   const last = commits[commits.length - 1];
   if (commits.some((commit) => commit.documentEpoch !== last.documentEpoch))
     return null;
+  if (commits.some((commit) => commit.trackedAnnotationReconstruction != null && !readIssuedTrackedAnnotationReconstruction(commit) || commit.trackedAnnotationSteps?.some((step2) => step2.trackedAnnotationReconstruction != null) && (commit.classification.kind !== "broad" || commit.sourceProjectionEffect != null || commit.sourceProjectionSteps != null)))
+    return null;
   const reviewReplicaCommits = collapseReviewReplicaCommitsForAggregate(commits, first, last);
   const localHistory = collapseNarrowTextHistoryCommits(commits) ?? collapseSecondaryTextHistoryCommits(commits);
   const trackedAnnotations = collapseTrackedAnnotationsForAggregate(commits);
@@ -197489,7 +197665,8 @@ function collapseTrackedAnnotationSteps(commits) {
         ...commit.trackedAnnotationRemovals != null ? { trackedAnnotationRemovals: commit.trackedAnnotationRemovals } : {},
         ...commit.trackedAnnotationHistory ? { trackedAnnotationHistory: commit.trackedAnnotationHistory } : {},
         ...commit.trackedAnnotationHistoryGroup ? { trackedAnnotationHistoryGroup: commit.trackedAnnotationHistoryGroup } : {},
-        ...commit.trackedAnnotationHistoryGroup ? { updatedRefs: commit.facts.updatedRefs } : {},
+        ...commit.trackedAnnotationReconstruction ? { trackedAnnotationReconstruction: commit.trackedAnnotationReconstruction } : {},
+        ...commit.trackedAnnotationHistoryGroup || commit.trackedAnnotationReconstruction ? { updatedRefs: commit.facts.updatedRefs } : {},
         ...commit.classification.kind === "broad" && commit.classification.reason === "tracked-annotation-unproved" && trackedAnnotations == null ? { unproved: true } : {}
       });
     }
@@ -199593,7 +199770,7 @@ function locateExactResidentBodyChild(state, storyId, partUri, byteStart, byteEn
   const matches = [];
   for (const chunk of chunks) {
     const revision = state.stories.get(storyId)?.descriptor.revision;
-    const issued5 = revision && readIssuedSourceChunkBodyChild({
+    const issued6 = revision && readIssuedSourceChunkBodyChild({
       chunk: captureSourceChunkReadSnapshot(chunk).descriptor,
       storyId,
       storyRevision: revision,
@@ -199601,8 +199778,8 @@ function locateExactResidentBodyChild(state, storyId, partUri, byteStart, byteEn
       byteStart,
       byteEnd
     });
-    if (issued5) {
-      matches.push(issued5);
+    if (issued6) {
+      matches.push(issued6);
       continue;
     }
     const cached2 = cache?.get(chunk);
@@ -199941,6 +200118,7 @@ var init_render_commit_envelope = __esm(() => {
   init_resident_paragraph_ownership();
   init_structural_tracked_carrier_partition();
   init_tracked_annotation_history();
+  init_tracked_annotation_reconstruction();
   init_paragraph_mark_markers();
   init_body_boundary_scan();
   init_comment_range_invariance();
@@ -200089,8 +200267,12 @@ function commitPreparedMutationInFrame(state, prepared, options) {
     historyEntry.renderReplay = renderCommit;
   if (historyEntry && backend.kind === "local")
     sealClosedHistoryGroupEntry(state, historyEntry);
-  if (historyEntry)
+  if (historyEntry) {
     options.pushHistory(historyEntry);
+    const authority = sealTrackedDecisionAnnotationReconstruction(state, prepared, historyEntry, applyResult, renderCommit);
+    if (authority)
+      renderCommit.trackedAnnotationReconstruction = authority;
+  }
   if (historyEntry?.renderReplay)
     rememberResidentParagraphSplit(state, renderCommit);
   attachSDRenderCommitEnvelope(receipt2, renderCommit);
@@ -200102,6 +200284,7 @@ var init_commit_prepared_mutation = __esm(() => {
   init_execution_backend();
   init_history_text_replay();
   init_closed_history_group();
+  init_tracked_annotation_reconstruction();
   init_render_commit_envelope();
 });
 
@@ -202682,7 +202865,7 @@ function commitTracked(input, view) {
       overlapEmittedRsids = [op.rsid];
       overlapTrackedTextAnnotations = spanningDeleteWIds.map((segmentWId) => ({
         changeId: op.rsid,
-        wId: String(segmentWId),
+        wId: String(segmentWId + 1),
         kind: "delete",
         author: {
           name: stamping.author.name,
@@ -235976,14 +236159,18 @@ function captureRenderSourceSnapshot(state, snapshotId, currentSections) {
   const mainCoverage = mainStoryId ? coverage.get(mainStoryId) : null;
   const mainStory = mainStoryId ? storiesById.get(mainStoryId) : null;
   const signalSnapshot = state.sourceSignals.snapshot;
-  const sections = structuredClone(currentSections ?? (signalSnapshot?.packageRevision === binding.packageRevision && mainSignals?.storyRevision === mainStory?.revision && mainSignals?.completeness.sections === "complete" && mainCoverage?.facts.status === "source-complete" && signalSnapshot.sourceCoverageRevision === mainCoverage.facts.sourceCoverageRevision ? {
+  const sectionCandidate = currentSections ?? (signalSnapshot?.packageRevision === binding.packageRevision && mainSignals?.storyRevision === mainStory?.revision && mainSignals?.completeness.sections === "complete" && mainCoverage?.facts.status === "source-complete" && signalSnapshot.sourceCoverageRevision === mainCoverage.facts.sourceCoverageRevision ? {
     packageRevision: binding.packageRevision,
     sourceCoverageRevision: signalSnapshot.sourceCoverageRevision,
     signalsRevision: signalSnapshot.signalsRevision,
     storyId: mainSignals.storyId,
     storyRevision: mainSignals.storyRevision,
     sections: mainSignals.sections
-  } : null));
+  } : null);
+  const sections = sectionCandidate && mainStory && mainCoverage && sectionCandidate.packageRevision === binding.packageRevision && sectionCandidate.storyId === mainStory.storyId && sectionCandidate.storyRevision === mainStory.revision && sectionCandidate.sourceCoverageRevision === mainCoverage.facts.sourceCoverageRevision && sectionCandidate.sections.every((section) => {
+    const anchor = section.sourceAnchor;
+    return anchor.stability === "byte-span" && section.storyId === mainStory.storyId && section.storyRevision === mainStory.revision && anchor.storyId === mainStory.storyId && anchor.storyRevision === mainStory.revision && anchor.partId === mainStory.ownerPartUri && anchor.partRevision === partsById.get(anchor.partId)?.revision;
+  }) ? structuredClone(sectionCandidate) : null;
   const lazyReads = new Map;
   const lifetime = new AbortController;
   let pendingSections = null;
@@ -238231,7 +238418,7 @@ function applyDecisionToFragment(input) {
     return { ok: false, reason: "invalid-input" };
   const inner = xml.slice(wrapper.openEnd, wrapper.closeStart);
   const visible = visibleTextLengthInWrapper(inner, fragment3.kind);
-  switch (decisionKey(decision, fragment3.kind)) {
+  switch (decisionKey2(decision, fragment3.kind)) {
     case "accept-ins":
       return {
         ok: true,
@@ -238294,7 +238481,7 @@ function applyDecisionToFragment(input) {
       return { ok: false, reason: "unsupported-context" };
   }
 }
-function decisionKey(decision, kind) {
+function decisionKey2(decision, kind) {
   return `${decision}-${kind}`;
 }
 function visibleTextLengthInWrapper(inner, _kind) {
@@ -238379,7 +238566,7 @@ function applyPartialDecisionToFragment(input) {
     postChunk = `${postOpen}${post}${wrapperClose}`;
     emittedPost = true;
   }
-  switch (decisionKey(decision, fragment3.kind)) {
+  switch (decisionKey2(decision, fragment3.kind)) {
     case "accept-ins":
       selChunk = sel;
       visibleTextDelta = 0;
@@ -244399,6 +244586,8 @@ function runTrackedChangeDecideCommitWithLookupContext(lookupContext, input, xml
       actorAttribution: { actorType: input.options.actorTag ?? "code" }
     }
   };
+  if (restoredInsertion)
+    captureTrackedDecisionAnnotationReconstruction(state, prepared);
   const receipt2 = commitPreparedMutation(state, prepared, { pushHistory: input.pushHistory });
   if (receipt2.status === "committed") {
     for (const [rsid, lineage] of pendingSplitLineage) {
@@ -247471,6 +247660,7 @@ var init_compile_tracked_change_decide = __esm(() => {
   init_revision_wid_allocator();
   init_semantic_style_dependencies();
   init_commit_prepared_mutation();
+  init_tracked_annotation_reconstruction();
   init_review_comment_dependencies();
   init_review_resource_dependencies();
   init_compile_tracked_change_decide_local();
@@ -254087,7 +254277,7 @@ function compareTrackedStampPair(input, includeParagraphProperties = false) {
 function makeCompareHunkStampSource(primary, input) {
   const usedPairs = [];
   const reservedRsids = new Set([primary.del.rsid]);
-  let issued5 = false;
+  let issued6 = false;
   let pendingRsids = [];
   let batchOrdinal = 0;
   const nextRsid = () => {
@@ -254104,8 +254294,8 @@ function makeCompareHunkStampSource(primary, input) {
     }
   };
   const next = () => {
-    if (!issued5) {
-      issued5 = true;
+    if (!issued6) {
+      issued6 = true;
       usedPairs.push(primary);
       return primary;
     }
@@ -272875,11 +273065,22 @@ function attachHistoryRenderCommit(state, entry, direction, result, exactRender,
   ensureSDRenderCommitVersion(state, result);
   const renderCommit = replayCommit ?? (exactRender ? buildSDRenderCommitEnvelope(state, exactRender.prepared, result, exactRender.origin, { dirtyBlock: exactRender.dirtyBlock, historyReplay: true }) : buildSDBroadRenderCommitEnvelope(state, `${entry.txId}:${direction}`, result, "history-replay"));
   if (renderCommit) {
-    attachSDRenderCommitEnvelope(result, {
+    const reconstructAnnotations = entry.forwardPatchGroup.source.kind === "trackedChangeDecide" && !renderCommit.trackedAnnotationHistory && !renderCommit.trackedAnnotationHistoryGroup && renderCommit.trackedAnnotations == null && (renderCommit.facts.createdRefs.some((ref3) => ref3.kind === "trackedChange") || renderCommit.facts.remappedRefs.some((remap) => remap.from.kind === "trackedChange" || remap.to.kind === "trackedChange"));
+    const replay = {
       ...renderCommit,
-      ...sourceProjectionEffect ? { sourceProjectionEffect } : {},
+      ...reconstructAnnotations ? {
+        classification: renderCommit.classification.kind === "broad" && renderCommit.classification.reason !== "history-replay" ? renderCommit.classification : { kind: "broad", reason: "tracked-annotation-unproved" },
+        sourceProjectionEffect: undefined,
+        sourceProjectionSteps: undefined
+      } : sourceProjectionEffect ? { sourceProjectionEffect } : {},
       historyReplay: true
-    });
+    };
+    if (reconstructAnnotations) {
+      const authority = issueTrackedAnnotationReconstruction(state, entry, result, replay);
+      if (authority)
+        replay.trackedAnnotationReconstruction = authority;
+    }
+    attachSDRenderCommitEnvelope(result, replay);
   }
   return result;
 }
@@ -274164,7 +274365,7 @@ async function openSDDocumentSession(options) {
   function buildReadyPartial() {
     const signalsRevision = state.revisions.signalsRevision();
     const snapshot2 = buildReadySignals({
-      pkg: openResult.packageOpen.pkg,
+      pkg: captureSourceSignalPackage(state),
       scan: openResult.bodyBoundaryScan,
       buffer: mainDocumentBuffer(openResult) ?? new Uint8Array(0),
       mainStoryId,
@@ -274532,7 +274733,7 @@ async function openSDDocumentSession(options) {
         chunkBytesProvider: fencedChunkBytesProvider,
         scan: signalsScan,
         spine: liveSourceSpine,
-        pkg: openResult.packageOpen.pkg,
+        pkg: captureSourceSignalPackage(state),
         mainStoryId,
         mainOwnerPartId: mainPartId,
         sourceCoverageRevision: revisionGuard.sourceCoverageRevision,
@@ -274752,7 +274953,7 @@ async function openSDDocumentSession(options) {
         findings: preScanned.sectFindings,
         scan: bodyBoundaryScan,
         totalBodyChildren: sourceCompleteResult.spine.bodyChildCount,
-        pkg: openResult.packageOpen.pkg,
+        pkg: captureSourceSignalPackage(state),
         mainStoryId,
         mainOwnerPartId: mainPartId,
         storyRevision: guard.storyRevision,
@@ -275303,6 +275504,7 @@ var init_sd_document_session = __esm(() => {
   init_sd_document_state();
   init_adopted_fenced_source_completion();
   init_render_commit_envelope();
+  init_tracked_annotation_reconstruction();
   init_semantic_style_dependencies();
   init_revision_wid_scan();
   init_document_background();
@@ -318308,7 +318510,7 @@ function buildVisibleSelectionTarget(story, start, end) {
     ...distinctFootnotes(start.story ?? story, end.story ?? story) ? {} : { story }
   };
 }
-function buildSelectionTarget(session, story, start, end, entries2) {
+function buildSelectionTarget(session, story, start, end, entries2, collapsed = false) {
   const hasTrackedEndpoint = start.trackedOffset != null || end.trackedOffset != null;
   if (!hasTrackedEndpoint)
     return buildVisibleSelectionTarget(story, start, end);
@@ -318325,6 +318527,9 @@ function buildSelectionTarget(session, story, start, end, entries2) {
   if (resolvedStart == null || resolvedEnd == null) {
     return null;
   }
+  if (collapsed && startEntry === endEntry && start.offset === end.offset && resolvedStart === resolvedEnd && projectsOnlyDeletedControls(startMap, resolvedStart, start.offset)) {
+    return buildVisibleSelectionTarget(story, start, end);
+  }
   const [orderedStart, orderedEnd] = start.blockId === end.blockId && resolvedEnd < resolvedStart ? [resolvedEnd, resolvedStart] : [resolvedStart, resolvedEnd];
   return {
     kind: "selection",
@@ -318334,6 +318539,24 @@ function buildSelectionTarget(session, story, start, end, entries2) {
     coordinateSpace: "tracked"
   };
 }
+function projectsOnlyDeletedControls(map3, trackedOffset, visibleOffset) {
+  let tracked = 0, visible = 0, deletedControl = false;
+  for (const leaf of map3.leaves()) {
+    if (leaf.trackedStart >= trackedOffset)
+      break;
+    const width = Math.min(leaf.trackedEnd, trackedOffset) - leaf.trackedStart;
+    if (width <= 0)
+      continue;
+    if (leaf.trackedEnd - leaf.trackedStart === leaf.visibleEnd - leaf.visibleStart) {
+      visible += width;
+    } else if (leaf.kind === "control" && leaf.deleted && (leaf.control === "tab" || leaf.control === "br" || leaf.control === "cr") && leaf.trackedEnd <= trackedOffset && leaf.visibleStart === leaf.visibleEnd) {
+      deletedControl = true;
+    } else
+      return false;
+    tracked += width;
+  }
+  return deletedControl && tracked === trackedOffset && visible === visibleOffset;
+}
 function readParagraphInlineMap(session, entry) {
   const bytes = getSDDocumentSessionInternalPartRange(session, entry.partUri, entry.byteStart, entry.byteEnd);
   if (!bytes)
@@ -318400,9 +318623,25 @@ function resolveTableCellSelectionEntries(session, story, anchorBlockId, focusBl
   if (!index || !anchorEntry || index.duplicateParaIds.has(anchorBlockId) || index.duplicateParaIds.has(focusBlockId))
     return null;
   const catalog = readTableCatalogForSession(session, anchorEntry.storyId);
-  const anchor = catalog?.byParagraphId.get(anchorBlockId);
-  const focus = catalog?.byParagraphId.get(focusBlockId);
-  if (!anchor || !focus || anchor.table !== focus.table || anchor.cell === focus.cell)
+  const owner = (blockId) => {
+    const entry = index.byParaId(blockId), enclosing = catalog?.byParagraphId.get(blockId);
+    if (!entry || !enclosing)
+      return null;
+    const table = tableForParagraph({ session }, anchorEntry.storyId, enclosing.table, entry);
+    if (table === enclosing.table)
+      return enclosing;
+    for (const row of table.rows)
+      for (const cell of row.cells) {
+        if (entry.byteStart < cell.bodyByteStart || entry.byteEnd > cell.bodyByteEnd)
+          continue;
+        const paragraph2 = cell.paragraphs.find((candidate2) => candidate2.paragraphId === blockId && candidate2.byteStart === entry.byteStart && candidate2.byteEnd === entry.byteEnd);
+        if (paragraph2)
+          return { table, row, cell, paragraph: paragraph2 };
+      }
+    return null;
+  };
+  const anchor = owner(anchorBlockId), focus = owner(focusBlockId);
+  if (!anchor || !focus || anchor.table.tableNodeId !== focus.table.tableNodeId || anchor.table.tableByteStart !== focus.table.tableByteStart || anchor.table.tableByteEnd !== focus.table.tableByteEnd || anchor.cell.cellNodeId === focus.cell.cellNodeId)
     return null;
   for (const endpoint of [anchor, focus]) {
     if (endpoint.paragraph.isDirectCellChild)
@@ -318512,7 +318751,7 @@ function resolveBrowserLiveSelectionForSession(session, input, options = {}) {
   const resolved = resolveEntries(session, input);
   if (!resolved)
     return null;
-  const selectionTarget = buildSelectionTarget(session, input.story, resolved.start, resolved.end, resolved.entries);
+  const selectionTarget = buildSelectionTarget(session, input.story, resolved.start, resolved.end, resolved.entries, input.collapsed === true);
   if (!selectionTarget)
     return null;
   const contiguous = resolved.entries.every((entry, i2) => i2 === 0 || entry.ordinal === resolved.entries[i2 - 1].ordinal + 1);
@@ -318541,7 +318780,7 @@ function resolveBrowserLiveSelectionForSession(session, input, options = {}) {
 }
 function resolveBrowserSelectionReviewIdsForSession(session, input, options = {}) {
   const resolved = resolveEntries(session, input);
-  if (!resolved || !buildSelectionTarget(session, input.story, resolved.start, resolved.end, resolved.entries))
+  if (!resolved || !buildSelectionTarget(session, input.story, resolved.start, resolved.end, resolved.entries, input.collapsed === true))
     return null;
   return readActiveReviewIds(session, resolved.entries, resolved.target.segments, options);
 }
@@ -318942,6 +319181,7 @@ var TEXT_DECODER7, ACTIVE_MARK_ORDER;
 var init_live_selection = __esm(() => {
   init_sd_document_session_internal();
   init_sd_document_session_internal();
+  init_xml3();
   init_footnote_range();
   TEXT_DECODER7 = new TextDecoder;
   ACTIVE_MARK_ORDER = ["bold", "italic", "underline", "strikethrough"];
@@ -376707,6 +376947,15 @@ class V2TrackedChangesAdapter {
     const residentViews = new Map;
     let fullView;
     const storyFilter = story ? resolveStoryFilter(story, this.context.session) : undefined;
+    const structuralScope = source?.structuralOwner ? resolveReviewSnapshotStructuralScope(this.context, source, storyFilter) : undefined;
+    if (source?.structuralOwner && !structuralScope)
+      return {
+        requestedIds: [...new Set(requestedIds)],
+        canonicalIds: [],
+        items: [],
+        unresolvedTrackedChangeIds: [...new Set(requestedIds)]
+      };
+    const sourceFilter = source && { ...source, structuralScope: structuralScope ?? undefined };
     const resolveSession = createTrackedChangeFragmentResolveSession();
     const seenInput = new Set;
     const seenCanonical = new Set;
@@ -376725,7 +376974,7 @@ class V2TrackedChangesAdapter {
         if (resident) {
           view = resident;
           for (const requested of requestedIds) {
-            if (resolveReviewSnapshotTrackedChangeId(resident, requested, storyFilter, source))
+            if (resolveReviewSnapshotTrackedChangeId(resident, requested, storyFilter, sourceFilter))
               residentViews.set(requested, resident);
           }
         } else
@@ -376733,7 +376982,7 @@ class V2TrackedChangesAdapter {
       }
       const { logical } = view;
       const localEntry = getLocalTrackedTextEntry(this.context, id);
-      const entry = localEntry && (!storyFilter || logicalEntryMatchesStoryFilter(localEntry, storyFilter)) && reviewSnapshotEntryMatchesSource(localEntry, source) ? localEntry : resolveReviewSnapshotTrackedChangeId(view, id, storyFilter, source);
+      const entry = localEntry && (!storyFilter || logicalEntryMatchesStoryFilter(localEntry, storyFilter)) && reviewSnapshotEntryMatchesSource(localEntry, sourceFilter, id) ? localEntry : resolveReviewSnapshotTrackedChangeId(view, id, storyFilter, sourceFilter);
       if (!entry) {
         unresolvedTrackedChangeIds.push(id);
         continue;
@@ -376744,6 +376993,13 @@ class V2TrackedChangesAdapter {
       seenCanonical.add(entry.id);
       items.push(buildDiscoveryItem2(entry, this.context, logical, undefined, resolveSession));
     }
+    if (source?.structuralOwner && !reviewSnapshotSourceIsCurrent(this.context, source.structuralOwner))
+      return {
+        requestedIds: orderedRequestedIds,
+        canonicalIds: [],
+        items: [],
+        unresolvedTrackedChangeIds: orderedRequestedIds
+      };
     return { requestedIds: orderedRequestedIds, canonicalIds, items, unresolvedTrackedChangeIds };
   }
   moveFragmentWordIds(requestedIds) {
@@ -379455,6 +379711,26 @@ function addReviewGroupChildRefs(args) {
 function projectFormattingDeltaSummary(entry) {
   if (entry.type !== "formatting")
     return null;
+  const delta = entry.formattingDelta;
+  if (entry.subtype === "run-formatting" && delta) {
+    const value2 = (input) => {
+      if (input === undefined)
+        return "∅";
+      if (input === true)
+        return "on";
+      if (input === false || input === null)
+        return "off";
+      return typeof input === "object" ? JSON.stringify(input) : String(input);
+    };
+    const keys = new Set([...Object.keys(delta.beforeProperties), ...Object.keys(delta.afterProperties)]);
+    const differences = [];
+    for (const key3 of keys) {
+      const before = delta.beforeProperties[key3], after = delta.afterProperties[key3];
+      if (JSON.stringify(before) !== JSON.stringify(after))
+        differences.push(`${key3}: ${value2(before)} → ${value2(after)}`);
+    }
+    return differences.length ? `run formatting revision: ${differences.join(", ")}` : "run formatting revision";
+  }
   return entry.excerpt || null;
 }
 function projectSourceIds(entry) {
@@ -379606,7 +379882,7 @@ function logicalEntriesForSourceAlias(logical, alias) {
 function resolveReviewSnapshotTrackedChangeId(view, requestedId, storyFilter, source) {
   const matches = new Map;
   const add = (entry) => {
-    if (!reviewSnapshotEntryMatchesSource(entry, source))
+    if (!reviewSnapshotEntryMatchesSource(entry, source, requestedId))
       return;
     const canonical = resolveReviewSnapshotOwner(view.logical, entry);
     if (!canonical)
@@ -379639,16 +379915,51 @@ function resolveReviewSnapshotOwner(logical, entry) {
   let current = entry;
   while (!seen.has(current.id)) {
     seen.add(current.id);
-    const parent = resolveSubsumedLogicalChange(logical, current);
+    const reviewParentId = reviewGroupDisplayParentId(current);
+    const parent = reviewParentId ? logical.byId.get(reviewParentId) : resolveSubsumedLogicalChange(logical, current);
+    if (!parent)
+      return null;
     if (parent.id === current.id)
-      return current;
+      return isVisibleLogicalTrackedChange(current) ? current : null;
+    if (parent.storyId !== current.storyId || parent.partUri !== current.partUri)
+      return null;
+    if (reviewParentId && (parent.reviewGroup?.role !== "parent" || parent.reviewGroup.kind !== current.reviewGroup?.kind || !parent.reviewGroup.ownedChildIds.includes(current.id)))
+      return null;
     current = parent;
   }
   return null;
 }
-function reviewSnapshotEntryMatchesSource(entry, source) {
+function reviewSnapshotEntryMatchesSource(entry, source, requestedId) {
   if (source?.partUri && entry.partUri !== source.partUri)
     return false;
+  if (source?.structuralScope) {
+    const scope = source.structuralScope;
+    const aliases = requestedId ? reviewSnapshotRequestedIdAliases(requestedId) : [];
+    const structural = entry.structuralFragments.some((fragment4) => {
+      if (fragment4.partUri !== scope.partUri || fragment4.storyId !== scope.storyId || requestedId !== entry.id && ![fragment4.wId, fragment4.entityKey, fragment4.rsid, fragment4.enclosingParagraphRsid].some((alias) => alias != null && aliases.includes(alias)))
+        return false;
+      if (source.structuralOwner?.author != null && fragment4.author.name !== source.structuralOwner.author || source.structuralOwner?.date != null && fragment4.date !== source.structuralOwner.date)
+        return false;
+      if (!fragment4.structuralKind.startsWith(`${scope.kind}-`))
+        return false;
+      if (source.kind === "insert" && !fragment4.structuralKind.endsWith("-insertion") || source.kind === "delete" && !fragment4.structuralKind.endsWith("-deletion") || source.kind === "format" && /-(?:insertion|deletion)$/.test(fragment4.structuralKind))
+        return false;
+      const { sourceByteStart: start, sourceByteEnd: end } = fragment4;
+      if (start == null || end == null || !Number.isSafeInteger(start) || !Number.isSafeInteger(end) || end <= start)
+        return false;
+      return start >= scope.start && end <= scope.propertiesEnd || start <= scope.start && end >= scope.end;
+    });
+    const properties2 = scope.kind === "cell" && source.kind !== "insert" && source.kind !== "delete" && entry.formattingFragments.some((fragment4) => {
+      if (fragment4.subtype !== "cell" || fragment4.partUri !== scope.partUri || fragment4.storyId !== scope.storyId || requestedId !== entry.id && ![fragment4.wId, fragment4.entityKey].some((alias) => alias != null && aliases.includes(alias)))
+        return false;
+      if (source.structuralOwner?.author != null && fragment4.author.name !== source.structuralOwner.author || source.structuralOwner?.date != null && fragment4.date !== source.structuralOwner.date)
+        return false;
+      const { sourceByteStart: start, sourceByteEnd: end } = fragment4;
+      return start != null && end != null && Number.isSafeInteger(start) && Number.isSafeInteger(end) && start >= scope.start && end > start && end <= scope.propertiesEnd;
+    });
+    if (entry.storyId !== scope.storyId || entry.partUri !== scope.partUri || !structural && !properties2)
+      return false;
+  }
   if (!source?.kind)
     return true;
   if (source.kind === "format")
@@ -379656,6 +379967,31 @@ function reviewSnapshotEntryMatchesSource(entry, source) {
   const insertion = source.kind === "insert";
   return entry.fragments.some((fragment4) => insertion ? fragment4.kind === "ins" || fragment4.kind === "moveTo" : fragment4.kind === "del" || fragment4.kind === "moveFrom") || entry.structuralFragments.some((fragment4) => fragment4.structuralKind.endsWith(insertion ? "-insertion" : "-deletion"));
 }
+function reviewSnapshotSourceIsCurrent(context, owner) {
+  const current = getSDDocumentSessionInternalSourceCommit(context.session);
+  return current.documentEpoch === owner.documentEpoch && current.commitSequence === owner.commitSequence && String(getSDDocumentSessionInternalPackageRevision(context.session)) === owner.packageRevision;
+}
+function resolveReviewSnapshotStructuralScope(context, source, story) {
+  const owner = source.structuralOwner;
+  if (!owner || !source.partUri || !reviewSnapshotSourceIsCurrent(context, owner) || !owner.tableNodeId || !Number.isSafeInteger(owner.commitSequence) || owner.commitSequence < 0 || !Number.isSafeInteger(owner.rowIndex) || owner.rowIndex < 0 || owner.cellIndex != null && (!Number.isSafeInteger(owner.cellIndex) || owner.cellIndex < 0))
+    return null;
+  const matches = listSDDocumentSessionInternalStories(context.session).flatMap((candidate2) => {
+    const { storyId, partUri: partUri2 } = candidate2;
+    if (partUri2 !== source.partUri || story?.kind === "body-only" && !isBodyStoryId2(storyId) || story?.kind === "specific" && !story.storyIds?.has(storyId))
+      return [];
+    const catalog = readTableCatalogForSession(context.session, storyId);
+    return (catalog?.tables ?? []).filter((table2) => table2.tableNodeId === owner.tableNodeId).map((table2) => ({ table: table2, partUri: partUri2 }));
+  });
+  if (matches.length !== 1)
+    return null;
+  const { table, partUri } = matches[0];
+  const row = table.rows[owner.rowIndex];
+  const cell = owner.cellIndex != null ? row?.cells[owner.cellIndex] : undefined;
+  if (!row || owner.cellIndex != null && !cell)
+    return null;
+  const common = { storyId: table.storyId, partUri };
+  return cell ? { ...common, kind: "cell", start: cell.cellByteStart, end: cell.cellByteEnd, propertiesEnd: cell.bodyByteStart } : { ...common, kind: "row", start: row.rowByteStart, end: row.rowByteEnd, propertiesEnd: row.cells[0]?.cellByteStart ?? row.rowBodyByteEnd };
+}
 function resolveWordSourceTrackedChangeId(view, requestedId) {
   const matches = new Map;
   for (const alias of reviewSnapshotRequestedIdAliases(requestedId)) {
@@ -462708,6 +463044,33 @@ function emissionContext(owner, xml) {
   return cached2.context;
 }
 function materializeProjection(input) {
+  return materializeProjectionInternal(input);
+}
+function materializeDeletedTableSourceProjection(input) {
+  const manifest = readRoomManifest(input.rootDoc);
+  if (!manifest.snapshot || manifest.diagnostics.length)
+    throw new Error("deleted-table source requires its valid room manifest");
+  for (const handle of input.shardRegistry.listStories()) {
+    if (handle.rootDoc !== input.rootDoc || input.rootDoc.getMap("content").get(handle.shardId) !== handle.scope || handle.bootstrap?.sourcePackageSha256 !== manifest.snapshot.meta.createdFrom.sha256Zip) {
+      throw new Error("deleted-table source does not belong to this room and original package");
+    }
+  }
+  const recovery = { count: 0 };
+  const output = materializeProjectionInternal({ ...input, previousRecord: null }, recovery);
+  if (recovery.count === 0)
+    throw new Error("no recoverable deleted-table source");
+  for (const story of output.record.stories) {
+    const parsed = collectXmlElementRanges(story.xml);
+    const handle = input.shardRegistry.listStories().find((handle2) => snapshotStoryShard(shardReadTarget(handle2)).meta.storyId === story.storyId);
+    const live = handle ? snapshotStoryShard(shardReadTarget(handle)).blocks.map((block) => block.blockId) : [];
+    const ids = parsed.ranges.filter((range) => range.tag.namespaceUri === WORD_NAMESPACE10 && range.tag.localName === "p").map((range) => range.tag.attributes.find((attribute3) => attribute3.namespaceUri === "http://schemas.microsoft.com/office/word/2010/wordml" && attribute3.localName === "paraId")?.value);
+    if (parsed.errors.length || ids.length !== live.length || ids.some((id2, index2) => id2 !== live[index2])) {
+      throw new Error("deleted-table source does not preserve the complete current paragraph order");
+    }
+  }
+  return output;
+}
+function materializeProjectionInternal(input, recovery) {
   const readStorySnapshot = input.readStorySnapshot ?? snapshotStoryShard;
   const previousById = new Map;
   const previousByPartUri = new Map;
@@ -462836,7 +463199,11 @@ function materializeProjection(input) {
       continue;
     }
     const sourceXmlByteAligned = isByteAlignedSourceXml(bootstrap);
-    const tableReplacements = readTableStructuralReplacements(readTarget);
+    let tableReplacements = readTableStructuralReplacements(readTarget);
+    if (recovery && tableReplacements.some((table) => table.tableNodeId !== table.entryKey)) {
+      tableReplacements = recoverDeletedTableReplacements(handle, bootstrap, tableReplacements);
+      recovery.count += 1;
+    }
     const previousBlockIndex = previous3 ? blockDigestIndex(previous3.blockDigests) : null;
     const insertedBlockHint = previousBlockIndex && [...dirtyStoryBlocks.get(handle.shardId) ?? []].some((blockId) => !previousBlockIndex.has(blockId));
     const structuralSnapshot = previous3 && (wholeStoryDirtyShardIds.has(handle.shardId) || insertedBlockHint || tableReplacements.length === 0 && input.dirty.some((record4) => record4.shardId === handle.shardId && record4.kind === PROJECTION_DIRTY_KIND.storyBlocks)) ? readStorySnapshot(readTarget) : null;
@@ -464110,6 +464477,73 @@ function remapTableStructuralOverlaysAfterStoryXmlPatch(input) {
     };
   });
 }
+function recoverDeletedTableReplacements(handle, bootstrap, replacements) {
+  const source = bootstrap?.sourceXml;
+  if (!source)
+    throw new Error("deleted-table source requires its original package");
+  const parsed = collectXmlElementRanges(source);
+  if (parsed.errors.length)
+    throw new Error("deleted-table source has invalid original XML");
+  const target = shardReadTarget(handle);
+  const snapshot3 = snapshotStoryShard(target);
+  const live = new Set(snapshot3.blocks.map((block) => block.blockId));
+  const tables2 = getStoryTablesMap(target);
+  if (tables2.size !== replacements.length || live.size !== snapshot3.blocks.length) {
+    throw new Error("deleted-table source has ambiguous owners");
+  }
+  const allowedKeys = new Set([
+    "tableNodeId",
+    "storyId",
+    "partUri",
+    "lastPreparedTxId",
+    "lastDeltaKind",
+    "xml",
+    "sourceXmlStart",
+    "sourceXmlEnd",
+    "sourceByteStart",
+    "sourceByteEnd",
+    "affectedRows",
+    "affectedCells",
+    "affectedBlocks",
+    "tableBlocks",
+    "nonTableAffectedBlocks"
+  ]);
+  const entries4 = replacements.map((table) => {
+    const raw = tables2.get(table.entryKey);
+    const span = findUniqueTableSpanFromTableNodeId(source, table.entryKey);
+    if (!isYMap(raw) || !span || [...raw.keys()].some((key3) => !allowedKeys.has(key3)) || raw.get("storyId") !== snapshot3.meta.storyId || raw.get("partUri") !== snapshot3.meta.sourcePartUri || table.deltaKind !== "table.rewrite" || table.xml !== "" || !table.lastPreparedTxId || table.tableBlockIds.length || table.nonTableAffectedBlockIds.length) {
+      throw new Error("deleted-table source has an unsupported tombstone");
+    }
+    for (const key3 of ["affectedRows", "affectedCells", "affectedBlocks", "tableBlocks", "nonTableAffectedBlocks"]) {
+      const membership = raw.get(key3);
+      if (!(membership instanceof YArray))
+        throw new Error("deleted-table source has malformed membership");
+      const values2 = membership.toArray();
+      if (values2.some((value2) => typeof value2 !== "string" || value2.length === 0) || new Set(values2).size !== values2.length) {
+        throw new Error("deleted-table source has malformed membership");
+      }
+    }
+    const paragraphs2 = parsed.ranges.filter((range) => range.tag.namespaceUri === WORD_NAMESPACE10 && range.tag.localName === "p" && range.start > span.start && range.end < span.end);
+    const ids = paragraphs2.map((paragraph4) => paragraph4.tag.attributes.find((attribute3) => attribute3.namespaceUri === "http://schemas.microsoft.com/office/word/2010/wordml" && attribute3.localName === "paraId")?.value);
+    const affected = new Set(table.affectedBlockIds);
+    if (!ids.length || ids.some((id2) => !id2 || !affected.has(id2) || live.has(id2)) || new Set(ids).size !== ids.length || affected.size !== ids.length || affected.size !== table.affectedBlockIds.length || snapshot3.blocks.some((block) => block.structuralRefs.tableNodeId === table.entryKey)) {
+      throw new Error("deleted-table source does not prove complete removed membership");
+    }
+    return { table, raw, span };
+  }).sort((a, b) => a.span.start - b.span.start);
+  let removedBytes = 0;
+  let previousEnd = 0;
+  return entries4.map(({ table, raw, span }) => {
+    const start = UTF8_ENCODER3.encode(source.slice(0, span.start)).length - removedBytes;
+    const length3 = UTF8_ENCODER3.encode(source.slice(span.start, span.end)).length;
+    if (span.start < previousEnd || raw.get("sourceByteStart") !== start || raw.get("sourceByteEnd") !== start + length3) {
+      throw new Error("deleted-table source byte ownership does not match its serial deletions");
+    }
+    previousEnd = span.end;
+    removedBytes += length3;
+    return { ...table, tableNodeId: table.entryKey, sourceXmlStart: span.start, sourceXmlEnd: span.end };
+  });
+}
 function removeRedundantSplitSeparators(projection, redundantBlockIds) {
   const entries4 = [...projection.blockDigests];
   const changedIndices = [];
@@ -465578,7 +466012,7 @@ function readTableSplitChildren(table) {
 function readTableStructuralReplacements(target) {
   const out = [];
   let liveBlockIds;
-  getStoryTablesMap(target).forEach((value2) => {
+  getStoryTablesMap(target).forEach((value2, entryKey2) => {
     if (!isYMap(value2))
       return;
     const tableNodeId = value2.get("tableNodeId");
@@ -465628,6 +466062,7 @@ function readTableStructuralReplacements(target) {
         return;
     }
     out.push({
+      entryKey: entryKey2,
       tableNodeId,
       lastPreparedTxId,
       sourceXmlStart: start,
@@ -466867,6 +467302,7 @@ var init_materialize = __esm(() => {
   init_content_control_groups();
   init_scope3();
   init_safety();
+  init_read2();
   init_canonical();
   init_package_xml();
   init_reorder_story_owners();
@@ -467172,6 +467608,7 @@ var init_freshness = __esm(() => {
         "selection.extractOoxml",
         "search",
         "blocks.list",
+        "render.source",
         "lists.getState",
         "tables.list",
         "tables.get",
@@ -467468,6 +467905,24 @@ function createCollabV2ProjectionRuntime(options) {
     diagnostics = [];
     return snapshot3();
   }
+  function recoverDeletedTableSource() {
+    ensureNotDisposed();
+    const token = captureProjectionSnapshot({
+      rootDoc: options.rootDoc,
+      shardRegistry: options.shardRegistry,
+      journalAcceptsMinor: options.journalAcceptsMinor,
+      blobCompletenessProbe: options.blobCompletenessProbe
+    });
+    if (token.journalCompleteness !== "ok" || options.shardRegistry.requiredShardIds().some((id2) => !options.shardRegistry.get(id2))) {
+      throw new Error("deleted-table source requires complete current collaboration owners");
+    }
+    return materializeDeletedTableSourceProjection({
+      snapshotToken: token,
+      rootDoc: options.rootDoc,
+      shardRegistry: options.shardRegistry,
+      dirty: pendingDirty
+    }).record;
+  }
   async function runBarrier(request) {
     ensureNotDisposed();
     const capturedToken = captureProjectionSnapshot({
@@ -467673,6 +468128,7 @@ function createCollabV2ProjectionRuntime(options) {
       addDirty(dirtyScopesFromPackageBatch(batch2));
     },
     refresh,
+    recoverDeletedTableSource,
     runBarrier,
     markCollabMutation() {
       hasCollabMutation = true;
@@ -470476,12 +470932,7 @@ function trackedStoryTextRequiresMergedCarrierSync(validation) {
   const authorsText = validation.trackedInsert != null || validation.trackedInsertContinuation === true || (validation.trackedRefinement?.metadata.insertedText.length ?? 0) > 0;
   if (!authorsText && validation.trackedRefinement?.usesMergedCarrier !== true)
     return false;
-  const ordered = listOrderedBlocks(validation.target.scope);
-  const index2 = ordered.findIndex((entry) => entry.blockId === validation.target.blockId);
-  const head = ordered[index2]?.block;
-  if (!head || head.get(BLOCK_KEY.mergedIntoBlockId))
-    return false;
-  return ordered[index2 + 1]?.block.get(BLOCK_KEY.mergedIntoBlockId) === validation.target.blockId;
+  return readLogicalBlockChain(validation.target.scope, validation.target.blockId).length > 1;
 }
 function createStorySurfaceExecutionBackend(options) {
   const delegate = options.delegate;
@@ -471945,12 +472396,26 @@ function tryMirrorStoryText(prepared, extension2, options, admitted) {
         const trackedInsert = validation.trackedInsert;
         if (!trackedInsert) {
           if (validation.trackedInsertContinuation) {
+            const span = validation.trackedInsertContinuationSpan;
+            if (!span)
+              throw new Error("tracked continuation is missing its owning insertion");
+            const start = getBlockAtoms(target.block).toArray().find((atom) => atom.get(ATOM_KEY.id) === span.startAtomId);
+            if (!start)
+              throw new Error("tracked continuation lost its owning insertion");
+            const offset = validation.trackedInsertOffset ?? source.on.startOffset;
             insertTextAtResolvedTarget({
               target,
-              offset: validation.trackedInsertOffset ?? source.on.startOffset,
+              offset,
               text: source.newText,
               origin: STORY_SURFACE_BACKEND_ORIGIN
             });
+            if (offset === span.startOffset) {
+              start.set(ATOM_KEY.visibleOffset, offset);
+              getBlockAnchors(target.block).forEach((anchor) => {
+                if (anchor.get(ANCHOR_KEY.id) === span.startAtomId)
+                  anchor.set(ANCHOR_KEY.visibleOffset, offset);
+              });
+            }
             return;
           }
           throw new Error("tracked storyText mirror missing typed insert metadata");
@@ -472250,7 +472715,7 @@ function validateDirectStoryText(prepared, extension2, options) {
       return { ok: false, failureReason: atomFailureReason };
     }
   }
-  return {
+  const validation = {
     ok: true,
     source,
     doc: doc2,
@@ -472264,6 +472729,19 @@ function validateDirectStoryText(prepared, extension2, options) {
     ...validatedTrackedRefinement ? { trackedRefinement: validatedTrackedRefinement } : {},
     ...trackedEdit?.ok ? { trackedEdit: trackedEdit.trackedEdit } : {}
   };
+  if (trackedInsertContinuation && !trackedStoryTextRequiresMergedCarrierSync(validation)) {
+    const updated = prepared.semanticDelta.updatedRefs.filter((ref5) => ref5.kind === "trackedChange");
+    if (updated.length !== 1 || String(updated[0].storyId) !== sourceStoryId) {
+      return { ok: false, failureReason: "tracked continuation requires one updated insertion identity" };
+    }
+    const offset = trackedInsertOffset ?? source.on.startOffset;
+    const spans = collectLiveTrackedTextSpansInBlock(hydratedBlock, updated[0].entityId, "ins").filter((span) => span.startOffset <= offset && offset <= span.endOffset);
+    if (spans.length !== 1) {
+      return { ok: false, failureReason: "tracked continuation could not resolve its owning insertion" };
+    }
+    return { ...validation, trackedInsertContinuationSpan: spans[0] };
+  }
+  return validation;
 }
 function storyIdsRequiringShards(prepared, extension2, resolveStoryShard) {
   if (extension2.family === "storyText" && prepared.source.kind === "editText") {
@@ -474015,7 +474493,14 @@ function createCollabV2SessionProjectionController(options) {
         return { ok: true };
       return remoteProjectionPending ? refreshCleanRecord() : synchronizeSessionFromRuntime();
     }
-    return refreshCleanRecord();
+    const result = refreshCleanRecord();
+    if (result.ok || operationId !== "render.source")
+      return result;
+    try {
+      return synchronizeSessionFromRuntime({ sourceRecord: runtime.recoverDeletedTableSource() });
+    } catch {
+      return result;
+    }
   }
   function ingestRoomAuthoritativeInitialDirty() {
     for (const handle of options.projectionRegistry.listStories()) {
@@ -474040,10 +474525,10 @@ function createCollabV2SessionProjectionController(options) {
       };
     }
     const state = runtime.state;
-    if (state.freshness !== "clean") {
+    if (!input.sourceRecord && state.freshness !== "clean") {
       return projectionStateFailure(state.blockingReason);
     }
-    const record3 = runtime.lastCleanRecord();
+    const record3 = input.sourceRecord ?? runtime.lastCleanRecord();
     if (!record3) {
       return {
         ok: false,
@@ -480252,6 +480737,7 @@ async function buildCanonicalShardGraph(input) {
     shardId: storyShardId2(input.runtime.rootId, story.storyKind, story.partUri),
     bytes: readCompletePartBytes(input.session, sourceOpen, story.partUri)
   }));
+  const sourcePackageSha256 = sha256Hex2(input.sourceBuffer);
   for (const { story, shardId, bytes } of stories) {
     let unit;
     if (maySeedStoryShardsFromLocalSource && bytes) {
@@ -480283,7 +480769,7 @@ async function buildCanonicalShardGraph(input) {
       doc: rootDoc,
       rootDoc,
       scope: unit.scope,
-      ...storyBootstrap ? { bootstrap: storyBootstrap } : {}
+      ...storyBootstrap ? { bootstrap: { ...storyBootstrap, sourcePackageSha256 } } : {}
     };
     storyHandles.set(shardId, handle);
     storyHandlesByStoryId.set(story.storyId, handle);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.9.0-next.5",
+  "version": "1.9.0-next.6",
   "description": "Model Context Protocol server for SuperDoc, giving an AI agent tools to read and edit .docx files.",
   "type": "module",
   "license": "AGPL-3.0",
@@ -24,13 +24,13 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@superdoc/sdk": "2.22.0-next.5",
+    "@superdoc/sdk": "2.22.0-next.6",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.25.0-next.5",
-    "@superdoc/docx-engine": "0.24.0-next.5",
+    "superdoc": "2.25.0-next.6",
+    "@superdoc/docx-engine": "0.24.0-next.6",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",