@beyondwork/docx-react-component 1.0.135 → 1.0.137

package/dist/index.cjs

@@ -24380,6 +24380,106 @@ function setStartOverride(catalog, numberingInstanceId, level, startAt) {
     overrides: mergeOverride(instance.overrides, { level, startAt })
   };
 }
+function mergeFragmentNumberingCatalog(target, fragment) {
+  const catalog = cloneNumberingCatalog(target);
+  const abstractIdMap = /* @__PURE__ */ new Map();
+  const instanceIdMap = /* @__PURE__ */ new Map();
+  const picBulletIdMap = /* @__PURE__ */ new Map();
+  if (!fragment) {
+    return { catalog, abstractIdMap, instanceIdMap, picBulletIdMap };
+  }
+  for (const [picBulletId, entry] of Object.entries(fragment.numPicBullets ?? {})) {
+    const mappedId = mapPicBulletId(catalog, picBulletId, entry);
+    picBulletIdMap.set(picBulletId, mappedId);
+  }
+  for (const [abstractId, definition] of Object.entries(fragment.abstractDefinitions)) {
+    const mappedId = mapAbstractDefinition(catalog, definition, picBulletIdMap);
+    abstractIdMap.set(abstractId, mappedId);
+  }
+  for (const [instanceId, instance] of Object.entries(fragment.instances)) {
+    const mappedAbstractId = abstractIdMap.get(instance.abstractNumberingId) ?? instance.abstractNumberingId;
+    const mappedId = mapNumberingInstance(
+      catalog,
+      instance,
+      mappedAbstractId,
+      picBulletIdMap
+    );
+    instanceIdMap.set(instanceId, mappedId);
+  }
+  return { catalog, abstractIdMap, instanceIdMap, picBulletIdMap };
+}
+function mapPicBulletId(catalog, picBulletId, entry) {
+  const existing = catalog.numPicBullets?.[picBulletId];
+  if (existing && existing.rawXml === entry.rawXml) return picBulletId;
+  const mappedId = existing ? nextNumericString(Object.keys(catalog.numPicBullets ?? {})) : picBulletId;
+  const numPicBullets = { ...catalog.numPicBullets ?? {} };
+  numPicBullets[mappedId] = {
+    ...stripSourceRef(structuredClone(entry)),
+    numPicBulletId: mappedId
+  };
+  catalog.numPicBullets = numPicBullets;
+  return mappedId;
+}
+function mapAbstractDefinition(catalog, definition, picBulletIdMap) {
+  const existing = catalog.abstractDefinitions[definition.abstractNumberingId];
+  if (existing && sameJson(comparableAbstract(existing), comparableAbstract(definition))) {
+    return definition.abstractNumberingId;
+  }
+  const mappedId = existing ? nextCanonicalNumericId("abstract-num:", Object.keys(catalog.abstractDefinitions)) : definition.abstractNumberingId;
+  catalog.abstractDefinitions[mappedId] = {
+    ...stripSourceRef(structuredClone(definition)),
+    abstractNumberingId: mappedId,
+    nsid: freshLongHex(catalog, mappedId, "nsid"),
+    tplc: freshLongHex(catalog, mappedId, "tmpl"),
+    levels: definition.levels.map((level) => remapLevelPicBullet(level, picBulletIdMap))
+  };
+  return mappedId;
+}
+function mapNumberingInstance(catalog, instance, abstractNumberingId, picBulletIdMap) {
+  const existing = catalog.instances[instance.numberingInstanceId];
+  const candidate = {
+    ...instance,
+    abstractNumberingId,
+    overrides: instance.overrides.map(
+      (override) => remapOverridePicBullet(override, picBulletIdMap)
+    )
+  };
+  if (existing && sameJson(comparableInstance(existing), comparableInstance(candidate))) {
+    return instance.numberingInstanceId;
+  }
+  const mappedId = existing ? nextCanonicalNumericId("num:", Object.keys(catalog.instances)) : instance.numberingInstanceId;
+  catalog.instances[mappedId] = {
+    ...stripSourceRef(structuredClone(instance)),
+    overrides: candidate.overrides.map((override) => stripOverrideSourceRefs(override)),
+    numberingInstanceId: mappedId,
+    abstractNumberingId
+  };
+  return mappedId;
+}
+function remapLevelPicBullet(level, picBulletIdMap) {
+  const cloned = stripSourceRef(structuredClone(level));
+  if (!level.picBulletId) return cloned;
+  return {
+    ...cloned,
+    picBulletId: picBulletIdMap.get(level.picBulletId) ?? level.picBulletId
+  };
+}
+function remapOverridePicBullet(override, picBulletIdMap) {
+  const cloned = stripOverrideSourceRefs(structuredClone(override));
+  if (!override.levelDefinition) return cloned;
+  return {
+    ...cloned,
+    levelDefinition: remapLevelPicBullet(override.levelDefinition, picBulletIdMap)
+  };
+}
+function stripOverrideSourceRefs(override) {
+  const cloned = stripSourceRef(override);
+  if (!override.levelDefinition) return cloned;
+  return {
+    ...cloned,
+    levelDefinition: stripSourceRef(override.levelDefinition)
+  };
+}
 function mergeOverride(overrides, nextOverride) {
   return [
     ...overrides.filter((override) => override.level !== nextOverride.level),
@@ -24451,6 +24551,28 @@ function hashLongHex(input) {
   }
   return hash.toString(16).toUpperCase().padStart(8, "0").slice(-8);
 }
+function stripSourceRef(value) {
+  const { sourceRef: _sourceRef, ...rest } = value;
+  return rest;
+}
+function comparableAbstract(definition) {
+  return {
+    ...stripSourceRef(definition),
+    levels: definition.levels.map((level) => stripSourceRef(level))
+  };
+}
+function comparableInstance(instance) {
+  return {
+    ...stripSourceRef(instance),
+    overrides: instance.overrides.map((override) => ({
+      ...stripSourceRef(override),
+      ...override.levelDefinition ? { levelDefinition: stripSourceRef(override.levelDefinition) } : {}
+    }))
+  };
+}
+function sameJson(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}
 
 // src/core/commands/list-commands.ts
 function toggleNumberedList(document2, paragraphIndexes, context, options = {}) {
@@ -24498,7 +24620,7 @@ function splitListParagraph(document2, paragraphIndex, paragraphIsEmpty, context
       action: "split"
     };
   }
-  const target = paragraphs[resolvedParagraphIndex];
+  const target = paragraphs[resolvedParagraphIndex]?.paragraph;
   if (!target?.numbering) {
     return {
       document: working,
@@ -24550,7 +24672,7 @@ function backspaceAtListStart(document2, paragraphIndex, context, options = {})
       handled: false
     };
   }
-  const target = paragraphs[resolvedParagraphIndex];
+  const target = paragraphs[resolvedParagraphIndex]?.paragraph;
   if (!target?.numbering) {
     return {
       document: working,
@@ -24596,7 +24718,7 @@ function restartNumbering(document2, paragraphIndex, context, startAt = 1, optio
       affectedParagraphIndexes: []
     };
   }
-  const target = paragraphs[resolvedParagraphIndex];
+  const target = paragraphs[resolvedParagraphIndex]?.paragraph;
   if (!target?.numbering) {
     return {
       document: working,
@@ -24618,8 +24740,13 @@ function restartNumbering(document2, paragraphIndex, context, startAt = 1, optio
   );
   setStartOverride(catalog, numberingInstanceId, target.numbering.level, startAt);
   const affectedParagraphIndexes = [];
+  const targetStoryKey = paragraphs[resolvedParagraphIndex]?.storyKey;
   for (let index = resolvedParagraphIndex; index < paragraphs.length; index += 1) {
-    const paragraph = paragraphs[index];
+    const entry = paragraphs[index];
+    if (entry?.storyKey !== targetStoryKey) {
+      break;
+    }
+    const paragraph = entry.paragraph;
     if (!paragraph?.numbering) {
       break;
     }
@@ -24663,7 +24790,7 @@ function continueNumbering(document2, paragraphIndex, context, options = {}) {
       affectedParagraphIndexes: []
     };
   }
-  const target = paragraphs[resolvedParagraphIndex];
+  const target = paragraphs[resolvedParagraphIndex]?.paragraph;
   if (!target?.numbering) {
     return {
       document: working,
@@ -24692,8 +24819,13 @@ function continueNumbering(document2, paragraphIndex, context, options = {}) {
     };
   }
   const affectedParagraphIndexes = [];
+  const targetStoryKey = paragraphs[resolvedParagraphIndex]?.storyKey;
   for (let index = resolvedParagraphIndex; index < paragraphs.length; index += 1) {
-    const paragraph = paragraphs[index];
+    const entry = paragraphs[index];
+    if (entry?.storyKey !== targetStoryKey) {
+      break;
+    }
+    const paragraph = entry.paragraph;
     if (!paragraph?.numbering) {
       break;
     }
@@ -24739,12 +24871,13 @@ function toggleListKind(document2, paragraphIndexes, kind, context, options) {
   }
   const catalog = cloneNumberingCatalog(working.numbering);
   const allAlreadyKind = normalizedIndexes.every((index) => {
-    const paragraph = paragraphs[index];
-    return paragraph.numbering ? getListKind(catalog, paragraph.numbering.numberingInstanceId) === kind : false;
+    const paragraph = paragraphs[index]?.paragraph;
+    return paragraph?.numbering ? getListKind(catalog, paragraph.numbering.numberingInstanceId) === kind : false;
   });
   if (allAlreadyKind) {
     for (const index of normalizedIndexes) {
-      delete paragraphs[index].numbering;
+      const paragraph = paragraphs[index]?.paragraph;
+      if (paragraph) delete paragraph.numbering;
     }
     working.numbering = catalog;
     return {
@@ -24754,7 +24887,8 @@ function toggleListKind(document2, paragraphIndexes, kind, context, options) {
   }
   const numberingInstanceId = findAdjacentCompatibleInstance(paragraphs, catalog, normalizedIndexes[0], kind) ?? ensureDefaultListInstance(catalog, kind);
   for (const index of normalizedIndexes) {
-    const paragraph = paragraphs[index];
+    const paragraph = paragraphs[index]?.paragraph;
+    if (!paragraph) continue;
     paragraph.numbering = {
       numberingInstanceId,
       level: clampLevel(paragraph.numbering?.level ?? 0)
@@ -24785,10 +24919,11 @@ function adjustListLevels(document2, paragraphIndexes, delta, context, options)
     };
   }
   const affectedParagraphIndexes = resolved.paragraphIndexes.filter(
-    (index) => Boolean(paragraphs[index]?.numbering)
+    (index) => Boolean(paragraphs[index]?.paragraph.numbering)
   );
   for (const index of affectedParagraphIndexes) {
-    const paragraph = paragraphs[index];
+    const paragraph = paragraphs[index]?.paragraph;
+    if (!paragraph) continue;
     if (!paragraph.numbering) {
       continue;
     }
@@ -24808,17 +24943,21 @@ function normalizeListCommandTargets(options) {
 }
 function resolveListCommandParagraphIndexes(document2, paragraphs, paragraphIndexes, context, editableTargets) {
   if (editableTargets.length === 0) {
-    return { paragraphIndexes: normalizeParagraphIndexes(paragraphs, paragraphIndexes) };
+    return {
+      paragraphIndexes: normalizeParagraphIndexesForStory(
+        paragraphs,
+        paragraphIndexes,
+        context.activeStoryKey
+      )
+    };
   }
   const currentTargets = collectEditableTargetRefs(document2, context.editableTargetCache);
-  const paragraphIndexByTargetKey = /* @__PURE__ */ new Map();
-  let paragraphIndex = 0;
-  for (const target of currentTargets) {
-    if (!isParagraphTextTarget(target)) continue;
-    if (!paragraphIndexByTargetKey.has(target.targetKey)) {
-      paragraphIndexByTargetKey.set(target.targetKey, paragraphIndex);
-      paragraphIndex += 1;
-    }
+  const paragraphIndexByAddress = /* @__PURE__ */ new Map();
+  for (let index = 0; index < paragraphs.length; index += 1) {
+    const entry = paragraphs[index];
+    if (!entry) continue;
+    paragraphIndexByAddress.set(`${entry.storyKey}
+${entry.blockPath}`, index);
   }
   const resolvedIndexes = [];
   for (const target of editableTargets) {
@@ -24843,7 +24982,8 @@ function resolveListCommandParagraphIndexes(document2, paragraphs, paragraphInde
         }
       };
     }
-    const currentIndex = paragraphIndexByTargetKey.get(current.targetKey);
+    const currentIndex = paragraphIndexByAddress.get(`${current.storyKey}
+${current.blockPath}`);
     if (currentIndex === void 0) {
       return {
         paragraphIndexes: [],
@@ -24918,18 +25058,28 @@ function sortJson(value) {
   return value;
 }
 function findAdjacentCompatibleInstance(paragraphs, catalog, fromIndex, kind) {
+  const current = paragraphs[fromIndex];
   const previous = paragraphs[fromIndex - 1];
-  if (previous?.numbering) {
-    const previousKind = getListKind(catalog, previous.numbering.numberingInstanceId);
+  if (previous?.storyKey !== current?.storyKey) {
+    return void 0;
+  }
+  const previousParagraph = previous?.paragraph;
+  if (previousParagraph?.numbering) {
+    const previousKind = getListKind(catalog, previousParagraph.numbering.numberingInstanceId);
     if (previousKind === kind) {
-      return previous.numbering.numberingInstanceId;
+      return previousParagraph.numbering.numberingInstanceId;
     }
   }
   return void 0;
 }
 function findPreviousCompatibleInstance(paragraphs, catalog, fromIndex, kind) {
+  const storyKey2 = paragraphs[fromIndex]?.storyKey;
   for (let index = fromIndex - 1; index >= 0; index -= 1) {
-    const paragraph = paragraphs[index];
+    const entry = paragraphs[index];
+    if (entry?.storyKey !== storyKey2) {
+      break;
+    }
+    const paragraph = entry.paragraph;
     if (!paragraph?.numbering) {
       continue;
     }
@@ -24948,7 +25098,14 @@ function cloneEnvelope(document2, timestamp) {
 function captureEditableParagraphs(document2) {
   if (isDocumentRoot(document2.content)) {
     const paragraphs = [];
-    collectEditableParagraphs(document2.content.children, paragraphs);
+    for (const context of collectStoryBlockContexts(document2)) {
+      collectEditableParagraphs(
+        context.blocks,
+        paragraphs,
+        context.storyKey,
+        context.basePath
+      );
+    }
     return paragraphs;
   }
   const fallback = {
@@ -24956,23 +25113,39 @@ function captureEditableParagraphs(document2) {
     children: [{ type: "paragraph", children: [] }]
   };
   document2.content = fallback;
-  return fallback.children;
+  return [{
+    paragraph: fallback.children[0],
+    storyKey: "main",
+    blockPath: "main/block[0]"
+  }];
 }
-function collectEditableParagraphs(blocks, output) {
-  for (const block of blocks) {
+function collectEditableParagraphs(blocks, output, storyKey2, basePath) {
+  for (let blockIndex = 0; blockIndex < blocks.length; blockIndex += 1) {
+    const block = blocks[blockIndex];
+    if (!block) continue;
+    const blockPath = `${basePath}/block[${blockIndex}]`;
     switch (block.type) {
       case "paragraph":
-        output.push(block);
+        output.push({ paragraph: block, storyKey: storyKey2, blockPath });
         break;
       case "table":
-        for (const row2 of block.rows) {
-          for (const cell of row2.cells) {
-            collectEditableParagraphs(cell.children, output);
+        for (let rowIndex = 0; rowIndex < block.rows.length; rowIndex += 1) {
+          const row2 = block.rows[rowIndex];
+          if (!row2) continue;
+          for (let cellIndex = 0; cellIndex < row2.cells.length; cellIndex += 1) {
+            const cell = row2.cells[cellIndex];
+            if (!cell) continue;
+            collectEditableParagraphs(
+              cell.children,
+              output,
+              storyKey2,
+              `${blockPath}/row[${rowIndex}]/cell[${cellIndex}]`
+            );
           }
         }
         break;
       case "sdt":
-        collectEditableParagraphs(block.children, output);
+        collectEditableParagraphs(block.children, output, storyKey2, blockPath);
         break;
       case "custom_xml":
         break;
@@ -24984,6 +25157,18 @@ function collectEditableParagraphs(blocks, output) {
 function normalizeParagraphIndexes(paragraphs, paragraphIndexes) {
   return [...new Set(paragraphIndexes)].filter((index) => Number.isInteger(index) && index >= 0 && index < paragraphs.length).sort((left, right) => left - right);
 }
+function normalizeParagraphIndexesForStory(paragraphs, paragraphIndexes, storyKey2) {
+  if (storyKey2 === void 0) {
+    return normalizeParagraphIndexes(paragraphs, paragraphIndexes);
+  }
+  const storyParagraphIndexes = [];
+  for (let index = 0; index < paragraphs.length; index += 1) {
+    if (paragraphs[index]?.storyKey === storyKey2) {
+      storyParagraphIndexes.push(index);
+    }
+  }
+  return [...new Set(paragraphIndexes)].filter((index) => Number.isInteger(index) && index >= 0 && index < storyParagraphIndexes.length).map((index) => storyParagraphIndexes[index]).sort((left, right) => left - right);
+}
 function clampLevel(level) {
   return Math.max(0, Math.min(8, level));
 }
@@ -31279,9 +31464,9 @@ function findTableStructureTargetForSelection(document2, descriptor, operation2,
   if (descriptor.editability === "non-editable" && descriptor.nonEditableReason !== "nested-table-not-editable") {
     return null;
   }
-  const activeStoryKey = editableTargetStoryKey(activeStory);
+  const activeStoryKey2 = editableTargetStoryKey(activeStory);
   const targets = collectEditableTargetRefs(document2).filter(
-    (target) => target.commandFamily === "table-structure" && target.table !== void 0 && target.storyKey === activeStoryKey && tableStructureTargetMatchesDescriptor2(target, descriptor)
+    (target) => target.commandFamily === "table-structure" && target.table !== void 0 && target.storyKey === activeStoryKey2 && tableStructureTargetMatchesDescriptor2(target, descriptor)
   );
   const scope = preferredTableStructureScope(operation2);
   return targets.find((target) => {
@@ -36544,8 +36729,9 @@ function applyFragmentInsert(document2, selection, fragment, context) {
     workingDocument = collapseResult.document;
     workingSelection = collapseResult.selection;
     if (context.textTarget?.kind === "table-paragraph" || context.textTarget?.kind === "text-leaf") {
+      const { precomputedSurface: _precomputedSurface, ...contextWithoutPrecomputedSurface } = context;
       workingContext = {
-        ...context,
+        ...contextWithoutPrecomputedSurface,
         textTarget: {
           ...context.textTarget,
           paragraphEnd: Math.max(
@@ -36557,7 +36743,11 @@ function applyFragmentInsert(document2, selection, fragment, context) {
     }
   }
   const splitResult = splitParagraph(workingDocument, workingSelection, workingContext);
-  const splitRoot = splitResult.document.content;
+  const preparedFragment = prepareFragmentNumberingForInsertion(
+    splitResult.document,
+    fragment
+  );
+  const splitRoot = preparedFragment.document.content;
   if (!splitRoot || splitRoot.type !== "doc") {
     return {
       changed: false,
@@ -36568,9 +36758,9 @@ function applyFragmentInsert(document2, selection, fragment, context) {
   const targetedBlockPath = workingContext.textTarget?.kind === "table-paragraph" || workingContext.textTarget?.kind === "text-leaf" ? workingContext.textTarget.blockPath : void 0;
   if (targetedBlockPath) {
     const targeted = insertFragmentBlocksAfterPath(
-      splitResult.document,
+      preparedFragment.document,
       targetedBlockPath,
-      fragment.blocks
+      preparedFragment.blocks
     );
     if (targeted) {
       return {
@@ -36602,7 +36792,7 @@ function applyFragmentInsert(document2, selection, fragment, context) {
   const rightHalfIndex = scope.blockIndex + 1;
   const splicedChildren = [
     ...splitRoot.children.slice(0, rightHalfIndex),
-    ...fragment.blocks.map((block) => cloneBlock(block)),
+    ...preparedFragment.blocks.map((block) => cloneBlock(block)),
     ...splitRoot.children.slice(rightHalfIndex)
   ];
   const nextRoot = {
@@ -36610,7 +36800,7 @@ function applyFragmentInsert(document2, selection, fragment, context) {
     children: splicedChildren
   };
   const nextDocument = {
-    ...splitResult.document,
+    ...preparedFragment.document,
     updatedAt: context.timestamp,
     content: nextRoot
   };
@@ -36622,14 +36812,47 @@ function applyFragmentInsert(document2, selection, fragment, context) {
     mapping: createEmptyMapping()
   };
 }
-function cloneBlock(block) {
-  if (block.type === "paragraph") {
-    return {
-      ...block,
-      children: block.children.map((child) => ({ ...child }))
+function prepareFragmentNumberingForInsertion(document2, fragment) {
+  if (!fragment.numbering) {
+    return { document: document2, blocks: fragment.blocks };
+  }
+  const merged = mergeFragmentNumberingCatalog(document2.numbering, fragment.numbering);
+  return {
+    document: {
+      ...document2,
+      numbering: merged.catalog
+    },
+    blocks: fragment.blocks.map((block) => cloneBlock(block, merged.instanceIdMap))
+  };
+}
+function cloneBlock(block, numberingInstanceIdMap) {
+  const cloned = structuredClone(block);
+  remapNumberingReferences(cloned, numberingInstanceIdMap);
+  return cloned;
+}
+function remapNumberingReferences(value, numberingInstanceIdMap) {
+  if (!numberingInstanceIdMap?.size || !value || typeof value !== "object") {
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const entry of value) {
+      remapNumberingReferences(entry, numberingInstanceIdMap);
+    }
+    return;
+  }
+  const record = value;
+  if (record.numbering?.numberingInstanceId) {
+    const mappedId = numberingInstanceIdMap.get(record.numbering.numberingInstanceId) ?? record.numbering.numberingInstanceId;
+    record.numbering = {
+      ...record.numbering,
+      numberingInstanceId: mappedId
     };
   }
-  return JSON.parse(JSON.stringify(block));
+  remapNumberingReferences(record.children, numberingInstanceIdMap);
+  remapNumberingReferences(record.rows, numberingInstanceIdMap);
+  remapNumberingReferences(record.cells, numberingInstanceIdMap);
+  remapNumberingReferences(record.txbxBlocks, numberingInstanceIdMap);
+  remapNumberingReferences(record.content, numberingInstanceIdMap);
 }
 function insertFragmentBlocksAfterPath(document2, blockPath, fragmentBlocks) {
   const tokens = parseCanonicalBlockPath2(blockPath);
@@ -50035,13 +50258,32 @@ function storyKeyFromHandle(handle) {
 function textLeafEditableTargetHint(entry, semanticBlockRange) {
   const storyKey2 = storyKeyFromHandle(entry.handle);
   if (!storyKey2) return void 0;
+  const semanticBlockPath = textLeafBlockPathFromSemanticPath(entry.handle.semanticPath, storyKey2);
   return {
     kind: "text-leaf",
     storyKey: storyKey2,
-    blockPath: `${storyKey2}/block[${entry.blockIndex}]`,
+    blockPath: semanticBlockPath ?? `${storyKey2}/block[${entry.blockIndex}]`,
     semanticBlockRange
   };
 }
+function textLeafBlockPathFromSemanticPath(semanticPath, storyKey2) {
+  if (!semanticPath) return null;
+  const tableIndex = semanticPath.indexOf("table");
+  const rowIndex = semanticPath.indexOf("row", tableIndex + 1);
+  const cellIndex = semanticPath.indexOf("cell", rowIndex + 1);
+  const paragraphIndex = semanticPath.indexOf("paragraph", cellIndex + 1);
+  if (tableIndex < 0 || rowIndex < 0 || cellIndex < 0 || paragraphIndex < 0) {
+    return null;
+  }
+  const table = Number(semanticPath[tableIndex + 1]);
+  const row2 = Number(semanticPath[rowIndex + 1]);
+  const cell = Number(semanticPath[cellIndex + 1]);
+  const paragraph = Number(semanticPath[paragraphIndex + 1]);
+  if (!Number.isInteger(table) || !Number.isInteger(row2) || !Number.isInteger(cell) || !Number.isInteger(paragraph)) {
+    return null;
+  }
+  return `${storyKey2}/block[${table}]/row[${row2}]/cell[${cell}]/block[${paragraph}]`;
+}
 function compileParagraphReplacement(entry, proposed, options) {
   if (proposed.operation !== "replace" && proposed.operation !== "insert-before" && proposed.operation !== "insert-after") {
     return null;
@@ -56476,6 +56718,16 @@ function coerceIssueValue2(value) {
 function insertScopeMarkers(document2, params) {
   const { scopeId } = params;
   const root = document2.content;
+  if (!Number.isFinite(params.from) || !Number.isFinite(params.to)) {
+    const from = Number.isFinite(params.from) ? params.from : 0;
+    const to = Number.isFinite(params.to) ? params.to : from;
+    return {
+      status: "non-finite-range",
+      scopeId,
+      from,
+      to
+    };
+  }
   const normalizedFrom = Math.min(params.from, params.to);
   const normalizedTo = Math.max(params.from, params.to);
   if (!root || root.type !== "doc" || root.children.length === 0) {
@@ -56928,6 +57180,14 @@ function isRecord3(value) {
 }
 
 // src/runtime/workflow/coordinator.ts
+function createScopeMarkerMutationMapping() {
+  return {
+    steps: [],
+    metadata: {
+      layoutNeutralScopeMarkers: true
+    }
+  };
+}
 var MODE_RESTRICTIVENESS = {
   edit: 0,
   suggest: 1,
@@ -57119,12 +57379,12 @@ function createWorkflowCoordinator(deps) {
   function getCachedInteractionGuardSnapshot() {
     const state = deps.getState();
     const activeStory = deps.getActiveStory();
-    const activeStoryKey = storyTargetKey(activeStory);
+    const activeStoryKey2 = storyTargetKey(activeStory);
     const protectionSnapshot = deps.getProtectionSnapshot();
     const documentMode = deps.getDocumentMode();
     const overlay = overlayStore.getOverlay();
     const sharedWorkflowState = overlayStore.getSharedWorkflowState();
-    if (cachedInteractionGuardSnapshot && cachedInteractionGuardSnapshot.activeStoryKey === activeStoryKey && cachedInteractionGuardSnapshot.selection === state.selection && cachedInteractionGuardSnapshot.readOnly === state.readOnly && cachedInteractionGuardSnapshot.documentMode === documentMode && cachedInteractionGuardSnapshot.protectionSnapshot === protectionSnapshot && cachedInteractionGuardSnapshot.overlay === overlay && cachedInteractionGuardSnapshot.sharedWorkflowState === sharedWorkflowState) {
+    if (cachedInteractionGuardSnapshot && cachedInteractionGuardSnapshot.activeStoryKey === activeStoryKey2 && cachedInteractionGuardSnapshot.selection === state.selection && cachedInteractionGuardSnapshot.readOnly === state.readOnly && cachedInteractionGuardSnapshot.documentMode === documentMode && cachedInteractionGuardSnapshot.protectionSnapshot === protectionSnapshot && cachedInteractionGuardSnapshot.overlay === overlay && cachedInteractionGuardSnapshot.sharedWorkflowState === sharedWorkflowState) {
       return cachedInteractionGuardSnapshot.snapshot;
     }
     const blockedReasons = evaluateBlockedReasons(state.selection);
@@ -57165,7 +57425,7 @@ function createWorkflowCoordinator(deps) {
       blockedReasons
     };
     cachedInteractionGuardSnapshot = {
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       selection: state.selection,
       readOnly: state.readOnly,
       documentMode,
@@ -57194,13 +57454,13 @@ function createWorkflowCoordinator(deps) {
   function getCachedWorkflowMarkupSnapshot() {
     const state = deps.getState();
     const activeStory = deps.getActiveStory();
-    const activeStoryKey = storyTargetKey(activeStory);
+    const activeStoryKey2 = storyTargetKey(activeStory);
     const protectionSnapshot = deps.getProtectionSnapshot();
     const preservation = deps.getDocument().preservation;
     const overlay = overlayStore.getOverlay();
     const metadataDefinitions = overlayStore.getMetadataDefinitions();
     const metadataEntries = overlayStore.getMetadataEntries();
-    if (cachedWorkflowMarkupSnapshot && cachedWorkflowMarkupSnapshot.activeStoryKey === activeStoryKey && cachedWorkflowMarkupSnapshot.protectionSnapshot === protectionSnapshot && cachedWorkflowMarkupSnapshot.preservation === preservation && cachedWorkflowMarkupSnapshot.overlay === overlay && cachedWorkflowMarkupSnapshot.metadataDefinitions === metadataDefinitions && cachedWorkflowMarkupSnapshot.metadataEntries === metadataEntries) {
+    if (cachedWorkflowMarkupSnapshot && cachedWorkflowMarkupSnapshot.activeStoryKey === activeStoryKey2 && cachedWorkflowMarkupSnapshot.protectionSnapshot === protectionSnapshot && cachedWorkflowMarkupSnapshot.preservation === preservation && cachedWorkflowMarkupSnapshot.overlay === overlay && cachedWorkflowMarkupSnapshot.metadataDefinitions === metadataDefinitions && cachedWorkflowMarkupSnapshot.metadataEntries === metadataEntries) {
       return cachedWorkflowMarkupSnapshot.snapshot;
     }
     const snapshot = collectWorkflowMarkupSnapshot({
@@ -57211,7 +57471,7 @@ function createWorkflowCoordinator(deps) {
       workflowMetadataSnapshot: overlayStore.getMetadataSnapshot()
     });
     cachedWorkflowMarkupSnapshot = {
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       protectionSnapshot,
       preservation,
       overlay,
@@ -57235,6 +57495,60 @@ function createWorkflowCoordinator(deps) {
       activeStory: deps.getActiveStory()
     };
   }
+  function createPlantFailureResult(input) {
+    const { scopeId, anchor, assoc, plantResult } = input;
+    return {
+      scopeId: "",
+      anchor: {
+        kind: "range",
+        from: anchor.from,
+        to: anchor.to,
+        assoc
+      },
+      plantStatus: {
+        planted: false,
+        reason: plantResult.status,
+        ...plantResult.status === "non-paragraph-target" ? {
+          blockIndex: plantResult.blockIndex,
+          blockKind: plantResult.blockKind
+        } : {},
+        ...plantResult.status === "range-out-of-bounds" ? { storyLength: plantResult.storyLength } : {},
+        requestedFrom: plantResult.from,
+        requestedTo: plantResult.to
+      }
+    };
+  }
+  function buildWorkflowScope(input) {
+    const { params, scopeId, publicAnchor } = input;
+    return {
+      scopeId,
+      mode: params.mode ?? "comment",
+      anchor: publicAnchor,
+      ...params.storyTarget ? { storyTarget: params.storyTarget } : {},
+      ...params.label ? { label: params.label } : {},
+      ...params.visibility ? { visibility: params.visibility } : {},
+      ...params.guardPolicy ? { guardPolicy: params.guardPolicy } : {},
+      ...params.scopeMetadataFields && params.scopeMetadataFields.length > 0 ? { metadata: [...params.scopeMetadataFields] } : {}
+    };
+  }
+  function buildWorkflowMetadataEntry(input) {
+    const { params, scopeId, publicAnchor } = input;
+    if (!params.persistence || params.persistence === "runtime-only") return null;
+    const requestedMetadata = params.metadata ?? {};
+    const entryPersistence = requestedMetadata.metadataPersistence ?? (params.persistence === "session" ? "external" : "internal");
+    return {
+      entryId: requestedMetadata.entryId ?? `scope-metadata-${scopeId}`,
+      metadataId: requestedMetadata.metadataId ?? "workflow.scope",
+      anchor: publicAnchor,
+      ...params.storyTarget ? { storyTarget: params.storyTarget } : {},
+      scopeId,
+      ...requestedMetadata.workItemId ? { workItemId: requestedMetadata.workItemId } : {},
+      ...requestedMetadata.value !== void 0 ? { value: requestedMetadata.value } : params.persistence === "document-metadata" && params.label ? { value: { label: params.label } } : {},
+      metadataPersistence: entryPersistence,
+      ...requestedMetadata.storageRef !== void 0 ? { storageRef: requestedMetadata.storageRef } : {},
+      ...requestedMetadata.metadataVersion !== void 0 ? { metadataVersion: requestedMetadata.metadataVersion } : {}
+    };
+  }
   function addScope(params) {
     const state = deps.getState();
     const scopeId = params.scopeId ?? `scope-${clock().replace(/[^0-9]/gu, "")}-${Math.floor(Math.random() * 1e6)}`;
@@ -57277,6 +57591,7 @@ function createWorkflowCoordinator(deps) {
     deps.dispatch({
       type: "document.replace",
       document: nextDocument,
+      mapping: createScopeMarkerMutationMapping(),
       origin: { source: "api", at: clock() }
     });
     const callerAssoc = params.anchor.kind === "range" ? params.anchor.assoc : { start: -1, end: 1 };
@@ -57333,6 +57648,86 @@ function createWorkflowCoordinator(deps) {
     }
     return { scopeId, anchor: publicAnchor };
   }
+  function addScopes(paramsList) {
+    if (paramsList.length === 0) return [];
+    return deps.runInRuntimeBatch("workflow.addScopes", () => {
+      let nextDocument = deps.getDocument();
+      let documentChanged = false;
+      const results = [];
+      const scopesToAdd = [];
+      const metadataEntriesToAdd = [];
+      const newScopeIds = /* @__PURE__ */ new Set();
+      for (const params of paramsList) {
+        const scopeId = params.scopeId ?? `scope-${clock().replace(/[^0-9]/gu, "")}-${Math.floor(Math.random() * 1e6)}`;
+        const anchor = params.anchor.kind === "range" ? { from: params.anchor.from, to: params.anchor.to } : null;
+        if (!anchor) {
+          results.push({ scopeId, anchor: params.anchor });
+          continue;
+        }
+        const callerAssoc = params.anchor.kind === "range" ? params.anchor.assoc : { start: -1, end: 1 };
+        const plantResult = insertScopeMarkers(nextDocument, {
+          scopeId,
+          from: anchor.from,
+          to: anchor.to
+        });
+        if (plantResult.status !== "planted") {
+          results.push(
+            createPlantFailureResult({
+              scopeId,
+              anchor,
+              assoc: callerAssoc,
+              plantResult
+            })
+          );
+          continue;
+        }
+        nextDocument = plantResult.document;
+        documentChanged = true;
+        const publicAnchor = {
+          kind: "range",
+          from: plantResult.plantedRange.from,
+          to: plantResult.plantedRange.to,
+          assoc: callerAssoc
+        };
+        newScopeIds.add(scopeId);
+        scopesToAdd.push(buildWorkflowScope({ params, scopeId, publicAnchor }));
+        const entry = buildWorkflowMetadataEntry({ params, scopeId, publicAnchor });
+        if (entry) metadataEntriesToAdd.push(entry);
+        results.push({ scopeId, anchor: publicAnchor });
+      }
+      if (documentChanged) {
+        deps.dispatch({
+          type: "document.replace",
+          document: nextDocument,
+          mapping: createScopeMarkerMutationMapping(),
+          origin: { source: "api", at: clock() }
+        });
+      }
+      if (scopesToAdd.length > 0) {
+        const currentOverlay = overlayStore.getOverlay() ?? {
+          overlayVersion: "workflow-overlay/1",
+          scopes: []
+        };
+        const existingScopes = currentOverlay.scopes.filter(
+          (existing) => !newScopeIds.has(existing.scopeId)
+        );
+        deps.dispatch({
+          type: "workflow.set-overlay",
+          overlay: { ...currentOverlay, scopes: [...existingScopes, ...scopesToAdd] },
+          origin: { source: "api", at: clock() }
+        });
+      }
+      if (metadataEntriesToAdd.length > 0) {
+        const priorEntries = overlayStore.getMetadataEntries();
+        deps.dispatch({
+          type: "workflow.set-metadata-entries",
+          entries: [...priorEntries, ...metadataEntriesToAdd],
+          origin: { source: "api", at: clock() }
+        });
+      }
+      return results;
+    });
+  }
   function removeScope(scopeId) {
     const overlay = overlayStore.getOverlay();
     if (overlay) {
@@ -57350,6 +57745,7 @@ function createWorkflowCoordinator(deps) {
       deps.dispatch({
         type: "document.replace",
         document: nextDocument,
+        mapping: createScopeMarkerMutationMapping(),
         origin: { source: "api", at: clock() }
       });
     }
@@ -57743,6 +58139,7 @@ function createWorkflowCoordinator(deps) {
   }
   return {
     addScope,
+    addScopes,
     removeScope,
     addInvisibleScope,
     setScopeVisibility,
@@ -69724,8 +70121,8 @@ function resolveEditableTextTarget(input) {
       `Editable target ref is malformed: ${shapeIssues[0]?.path ?? "$"}.`
     );
   }
-  const activeStoryKey = input.activeStoryKey ?? "main";
-  if (input.target.storyKey !== activeStoryKey) {
+  const activeStoryKey2 = input.activeStoryKey ?? "main";
+  if (input.target.storyKey !== activeStoryKey2) {
     return reject(
       "editable_target_wrong_story",
       "Editable target ref does not belong to the active story."
@@ -69821,8 +70218,8 @@ function resolveEditableCommandTarget(input) {
       `Editable target ref is malformed: ${shapeIssues[0]?.path ?? "$"}.`
     );
   }
-  const activeStoryKey = input.activeStoryKey ?? input.target.storyKey;
-  if (input.target.storyKey !== activeStoryKey) {
+  const activeStoryKey2 = input.activeStoryKey ?? input.target.storyKey;
+  if (input.target.storyKey !== activeStoryKey2) {
     return rejectCommand(
       "editable_target_wrong_story",
       "Editable target ref does not belong to the active story."
@@ -70237,8 +70634,8 @@ function resolveEditableTableStructureTarget(input) {
       `Editable target ref is malformed: ${shapeIssues[0]?.path ?? "$"}.`
     );
   }
-  const activeStoryKey = input.activeStoryKey ?? input.target.storyKey;
-  if (input.target.storyKey !== activeStoryKey) {
+  const activeStoryKey2 = input.activeStoryKey ?? input.target.storyKey;
+  if (input.target.storyKey !== activeStoryKey2) {
     return reject2(
       "editable_target_wrong_story",
       "Editable target ref does not belong to the active story."
@@ -70480,6 +70877,10 @@ function createDocumentRuntime(options) {
   const sessionId = createSessionId(options.documentId, clock());
   const listeners = /* @__PURE__ */ new Set();
   const eventListeners = /* @__PURE__ */ new Set();
+  let runtimeNotificationBatchDepth = 0;
+  let pendingRuntimeListenerNotify = false;
+  let pendingRenderSnapshotRefresh = false;
+  const pendingRuntimeEvents = [];
   const loadScheduler = options.loadScheduler ?? createLoadScheduler({ backendOverride: "sync" });
   let effectiveMarkupModeProvider;
   const perfCounters = new PerfCounters();
@@ -70853,7 +71254,7 @@ function createDocumentRuntime(options) {
     if (cached) {
       return cached;
     }
-    const activeStoryKey = storyTargetKey(nextActiveStory);
+    const activeStoryKey2 = storyTargetKey(nextActiveStory);
     const snapshot = createEditorSurfaceSnapshot(document2, state.selection, nextActiveStory, {
       viewportBlockRanges: null,
       editableTargetsByBlockPath: getEditableTargetsByBlockPath(document2),
@@ -70871,31 +71272,31 @@ function createDocumentRuntime(options) {
       preservation: document2.preservation,
       review: document2.review,
       effectiveMarkupModeProvider,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       snapshot
     };
     return snapshot;
   }
   function getReusableCachedFullSurface(document2, nextActiveStory) {
-    const activeStoryKey = storyTargetKey(nextActiveStory);
-    if (cachedFullSurface && cachedFullSurface.content === document2.content && cachedFullSurface.subParts === document2.subParts && cachedFullSurface.styles === document2.styles && cachedFullSurface.numbering === document2.numbering && cachedFullSurface.media === document2.media && cachedFullSurface.preservation === document2.preservation && cachedFullSurface.review === document2.review && cachedFullSurface.effectiveMarkupModeProvider === effectiveMarkupModeProvider && cachedFullSurface.activeStoryKey === activeStoryKey) {
+    const activeStoryKey2 = storyTargetKey(nextActiveStory);
+    if (cachedFullSurface && cachedFullSurface.content === document2.content && cachedFullSurface.subParts === document2.subParts && cachedFullSurface.styles === document2.styles && cachedFullSurface.numbering === document2.numbering && cachedFullSurface.media === document2.media && cachedFullSurface.preservation === document2.preservation && cachedFullSurface.review === document2.review && cachedFullSurface.effectiveMarkupModeProvider === effectiveMarkupModeProvider && cachedFullSurface.activeStoryKey === activeStoryKey2) {
       return cachedFullSurface.snapshot;
     }
     return void 0;
   }
   function getCachedSurface(document2, nextActiveStory, options2 = {}) {
-    const activeStoryKey = storyTargetKey(nextActiveStory);
+    const activeStoryKey2 = storyTargetKey(nextActiveStory);
     const surfaceViewportRanges = "viewportBlockRangesOverride" in options2 ? options2.viewportBlockRangesOverride ?? null : viewportBlockRanges;
     const surfaceViewportRangesKey = "viewportBlockRangesOverride" in options2 ? serializeViewportRanges(surfaceViewportRanges) : viewportRangesKey;
     const surfaceCacheKey = options2.enrichCulledPlaceholders === false ? `${surfaceViewportRangesKey}|raw-placeholders` : surfaceViewportRangesKey;
-    if (cachedSurface && cachedSurface.content === document2.content && cachedSurface.subParts === document2.subParts && cachedSurface.styles === document2.styles && cachedSurface.numbering === document2.numbering && cachedSurface.media === document2.media && cachedSurface.preservation === document2.preservation && cachedSurface.review === document2.review && cachedSurface.effectiveMarkupModeProvider === effectiveMarkupModeProvider && cachedSurface.activeStoryKey === activeStoryKey && cachedSurface.viewportRangesKey === surfaceCacheKey) {
+    if (cachedSurface && cachedSurface.content === document2.content && cachedSurface.subParts === document2.subParts && cachedSurface.styles === document2.styles && cachedSurface.numbering === document2.numbering && cachedSurface.media === document2.media && cachedSurface.preservation === document2.preservation && cachedSurface.review === document2.review && cachedSurface.effectiveMarkupModeProvider === effectiveMarkupModeProvider && cachedSurface.activeStoryKey === activeStoryKey2 && cachedSurface.viewportRangesKey === surfaceCacheKey) {
       return cachedSurface.snapshot;
     }
     const snapshot = createEditorSurfaceSnapshot(document2, state.selection, nextActiveStory, {
       viewportBlockRanges: surfaceViewportRanges,
       editableTargetsByBlockPath: options2.editableTargetsByBlockPathOverride ?? getEditableTargetsByBlockPathForRanges(
         document2,
-        activeStoryKey,
+        activeStoryKey2,
         surfaceViewportRanges
       ),
       paragraphCascadeCache: ensureParagraphCascadeCacheForStyles(document2.styles),
@@ -70918,7 +71319,7 @@ function createDocumentRuntime(options) {
         preservation: document2.preservation,
         review: document2.review,
         effectiveMarkupModeProvider,
-        activeStoryKey,
+        activeStoryKey: activeStoryKey2,
         snapshot: enrichedSnapshot
       };
     }
@@ -70931,11 +71332,11 @@ function createDocumentRuntime(options) {
       preservation: document2.preservation,
       review: document2.review,
       effectiveMarkupModeProvider,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       viewportRangesKey: surfaceCacheKey,
       snapshot: enrichedSnapshot
     };
-    cachedSurfaceFingerprint = `${activeStoryKey}|${surfaceCacheKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
+    cachedSurfaceFingerprint = `${activeStoryKey2}|${surfaceCacheKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
     return enrichedSnapshot;
   }
   function getSelectionCorridorViewportRanges(previousSurface) {
@@ -70966,7 +71367,7 @@ function createDocumentRuntime(options) {
     return -1;
   }
   function cachePatchedLocalTextSurface(surface, fullSurfaceForCache) {
-    const activeStoryKey = storyTargetKey(activeStory);
+    const activeStoryKey2 = storyTargetKey(activeStory);
     const rangesKey = serializeViewportRanges(surface.viewportBlockRanges);
     cachedSurface = {
       content: state.document.content,
@@ -70977,7 +71378,7 @@ function createDocumentRuntime(options) {
       preservation: state.document.preservation,
       review: state.document.review,
       effectiveMarkupModeProvider,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       viewportRangesKey: rangesKey,
       snapshot: surface
     };
@@ -70992,11 +71393,11 @@ function createDocumentRuntime(options) {
         preservation: state.document.preservation,
         review: state.document.review,
         effectiveMarkupModeProvider,
-        activeStoryKey,
+        activeStoryKey: activeStoryKey2,
         snapshot: fullSurface
       };
     }
-    cachedSurfaceFingerprint = `${activeStoryKey}|${rangesKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
+    cachedSurfaceFingerprint = `${activeStoryKey2}|${rangesKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
   }
   function createLocalTextCorridorSurfaceFromFullSurface(fullSurface) {
     const ranges = getSelectionCorridorViewportRanges(fullSurface);
@@ -71391,7 +71792,7 @@ function createDocumentRuntime(options) {
     return snapshot.suggestions.find((suggestion) => suggestion.changeIds.includes(changeId));
   }
   function getCachedDocumentNavigationSnapshot(nextState, nextActiveStory) {
-    const activeStoryKey = storyTargetKey(nextActiveStory);
+    const activeStoryKey2 = storyTargetKey(nextActiveStory);
     const buildSnapshot = () => layoutEngine.getNavigationSnapshot(
       {
         document: nextState.document,
@@ -71404,7 +71805,7 @@ function createDocumentRuntime(options) {
       nextState.selection,
       nextActiveStory
     );
-    if (cachedNavigation && cachedNavigation.document === nextState.document && cachedNavigation.activeStoryKey === activeStoryKey && cachedNavigation.workspaceMode === viewState.workspaceMode && cachedNavigation.zoomLevel === viewState.zoomLevel) {
+    if (cachedNavigation && cachedNavigation.document === nextState.document && cachedNavigation.activeStoryKey === activeStoryKey2 && cachedNavigation.workspaceMode === viewState.workspaceMode && cachedNavigation.zoomLevel === viewState.zoomLevel) {
       if (cachedNavigation.selectionHead === nextState.selection.head) {
         return cachedNavigation.snapshot;
       }
@@ -71412,7 +71813,7 @@ function createDocumentRuntime(options) {
       if (snapshot2.activePageIndex === cachedNavigation.snapshot.activePageIndex && snapshot2.activeSectionIndex === cachedNavigation.snapshot.activeSectionIndex) {
         cachedNavigation = {
           document: nextState.document,
-          activeStoryKey,
+          activeStoryKey: activeStoryKey2,
           workspaceMode: viewState.workspaceMode,
           zoomLevel: viewState.zoomLevel,
           selectionHead: nextState.selection.head,
@@ -71422,7 +71823,7 @@ function createDocumentRuntime(options) {
       }
       cachedNavigation = {
         document: nextState.document,
-        activeStoryKey,
+        activeStoryKey: activeStoryKey2,
         workspaceMode: viewState.workspaceMode,
         zoomLevel: viewState.zoomLevel,
         selectionHead: nextState.selection.head,
@@ -71435,7 +71836,7 @@ function createDocumentRuntime(options) {
     incrementInvalidationCounter("runtime.snapshot.navigationMisses");
     cachedNavigation = {
       document: nextState.document,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       workspaceMode: viewState.workspaceMode,
       zoomLevel: viewState.zoomLevel,
       selectionHead: nextState.selection.head,
@@ -71453,18 +71854,18 @@ function createDocumentRuntime(options) {
     return storyTargetKey(nextActiveStory);
   }
   function getCachedPageLayoutSnapshot(nextState, nextActiveStory) {
-    const activeStoryKey = storyTargetKey(nextActiveStory);
+    const activeStoryKey2 = storyTargetKey(nextActiveStory);
     const activeSectionIndex = resolvePageLayoutActiveSectionIndex(
       nextState,
       nextActiveStory
     );
-    if (cachedPageLayout && cachedPageLayout.revisionToken === nextState.revisionToken && cachedPageLayout.activeStoryKey === activeStoryKey && cachedPageLayout.activeSectionIndex === activeSectionIndex) {
+    if (cachedPageLayout && cachedPageLayout.revisionToken === nextState.revisionToken && cachedPageLayout.activeStoryKey === activeStoryKey2 && cachedPageLayout.activeSectionIndex === activeSectionIndex) {
       return cachedPageLayout.snapshot;
     }
     const snapshot = derivePageLayoutSnapshot(nextState, nextActiveStory, storySelections);
     cachedPageLayout = {
       revisionToken: nextState.revisionToken,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       activeSectionIndex,
       snapshot
     };
@@ -71534,8 +71935,8 @@ function createDocumentRuntime(options) {
     if (activeStory.kind === "main") {
       return surface.blocks;
     }
-    const activeStoryKey = storyTargetKey(activeStory);
-    return surface.secondaryStories.find((story) => storyTargetKey(story.target) === activeStoryKey)?.blocks ?? null;
+    const activeStoryKey2 = storyTargetKey(activeStory);
+    return surface.secondaryStories.find((story) => storyTargetKey(story.target) === activeStoryKey2)?.blocks ?? null;
   }
   function findSurfaceOpaqueTargetIntersectingRange(blocks, range) {
     for (const block of blocks) {
@@ -71691,6 +72092,7 @@ function createDocumentRuntime(options) {
     deriveOpaqueWorkflowBlockedReason,
     isBlockedByProtection,
     dispatch: (command) => dispatchToRuntime(command),
+    runInRuntimeBatch: runRuntimeNotificationBatch,
     emitEvent: (event) => emit2(event),
     editorStateChannel,
     suggestingUnsupportedCommands: SUGGESTING_UNSUPPORTED_COMMANDS
@@ -71710,12 +72112,12 @@ function createDocumentRuntime(options) {
     };
   }
   function getCachedRuntimeContextAnalytics(query) {
-    const activeStoryKey = storyTargetKey(activeStory);
+    const activeStoryKey2 = storyTargetKey(activeStory);
     const queryKey = getRuntimeContextAnalyticsQueryKey(query);
     const cachedEntry = cachedContextAnalyticsSnapshots.get(queryKey);
     const effectiveScopeKind = query?.scopeKind ?? "selection";
     const selectionCacheKey = effectiveScopeKind === "selection" ? state.selection : null;
-    if (cachedEntry && cachedEntry.revisionToken === state.revisionToken && cachedEntry.activeStoryKey === activeStoryKey && cachedEntry.selection === selectionCacheKey && cachedEntry.readOnly === state.readOnly && cachedEntry.documentMode === viewState.documentMode && cachedEntry.workflowOverlay === overlayStore.getOverlay() && cachedEntry.protectionSnapshot === protectionSnapshot && cachedEntry.warnings === state.warnings && cachedEntry.fatalError === state.fatalError) {
+    if (cachedEntry && cachedEntry.revisionToken === state.revisionToken && cachedEntry.activeStoryKey === activeStoryKey2 && cachedEntry.selection === selectionCacheKey && cachedEntry.readOnly === state.readOnly && cachedEntry.documentMode === viewState.documentMode && cachedEntry.workflowOverlay === overlayStore.getOverlay() && cachedEntry.protectionSnapshot === protectionSnapshot && cachedEntry.warnings === state.warnings && cachedEntry.fatalError === state.fatalError) {
       return cachedEntry.snapshot;
     }
     const tWf = performance.now();
@@ -71772,7 +72174,7 @@ function createDocumentRuntime(options) {
     perfCounters.increment("ctxa.build.us", Math.round((performance.now() - tBuild) * 1e3));
     cachedContextAnalyticsSnapshots.set(queryKey, {
       revisionToken: state.revisionToken,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       // L7 Phase 1.6: store the selectionCacheKey we tested against, so the
       // same scopeKind invariant applies to future reads.
       selection: selectionCacheKey,
@@ -71970,7 +72372,7 @@ function createDocumentRuntime(options) {
   }
   let cachedSurfaceFingerprint = null;
   function refreshSurfaceOnly(options2 = {}) {
-    const activeStoryKey = storyTargetKey(activeStory);
+    const activeStoryKey2 = storyTargetKey(activeStory);
     if (options2.forceProjection) {
       cachedFullSurface = void 0;
     }
@@ -71987,7 +72389,7 @@ function createDocumentRuntime(options) {
         viewportBlockRanges,
         editableTargetsByBlockPath: getEditableTargetsByBlockPathForRanges(
           state.document,
-          activeStoryKey,
+          activeStoryKey2,
           viewportBlockRanges
         ),
         paragraphCascadeCache: ensureParagraphCascadeCacheForStyles(
@@ -72017,7 +72419,7 @@ function createDocumentRuntime(options) {
           preservation: state.document.preservation,
           review: state.document.review,
           effectiveMarkupModeProvider,
-          activeStoryKey,
+          activeStoryKey: activeStoryKey2,
           snapshot: newSurface
         };
       }
@@ -72032,7 +72434,7 @@ function createDocumentRuntime(options) {
       preservation: state.document.preservation,
       review: state.document.review,
       effectiveMarkupModeProvider,
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       viewportRangesKey,
       snapshot: newSurface
     };
@@ -72040,9 +72442,7 @@ function createDocumentRuntime(options) {
       ...cachedRenderSnapshot,
       surface: newSurface
     };
-    for (const listener of listeners) {
-      listener();
-    }
+    notifyRuntimeListeners();
   }
   function maybeRefreshSurfaceForViewport() {
     const fingerprint = `${storyTargetKey(activeStory)}|${viewportRangesKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
@@ -72093,10 +72493,10 @@ function createDocumentRuntime(options) {
     return true;
   }
   function getCachedViewStateSnapshot() {
-    const activeStoryKey = storyTargetKey(activeStory);
+    const activeStoryKey2 = storyTargetKey(activeStory);
     const surface = cachedRenderSnapshot.surface;
     const pageLayout = cachedRenderSnapshot.pageLayout;
-    if (cachedViewStateSnapshot && cachedViewStateSnapshot.activeStoryKey === activeStoryKey && cachedViewStateSnapshot.selection === state.selection && cachedViewStateSnapshot.viewStateRef === viewState && cachedViewStateSnapshot.surface === surface && cachedViewStateSnapshot.pageLayout === pageLayout && cachedViewStateSnapshot.numbering === state.document.numbering) {
+    if (cachedViewStateSnapshot && cachedViewStateSnapshot.activeStoryKey === activeStoryKey2 && cachedViewStateSnapshot.selection === state.selection && cachedViewStateSnapshot.viewStateRef === viewState && cachedViewStateSnapshot.surface === surface && cachedViewStateSnapshot.pageLayout === pageLayout && cachedViewStateSnapshot.numbering === state.document.numbering) {
       return cachedViewStateSnapshot.snapshot;
     }
     const mainSurface = activeStory.kind === "main" ? surface : getCachedSurface(state.document, MAIN_STORY_TARGET);
@@ -72110,7 +72510,7 @@ function createDocumentRuntime(options) {
       state.document.numbering
     );
     cachedViewStateSnapshot = {
-      activeStoryKey,
+      activeStoryKey: activeStoryKey2,
       selection: state.selection,
       viewStateRef: viewState,
       surface,
@@ -72644,6 +73044,17 @@ function createDocumentRuntime(options) {
           };
           resolvedReplayTextTarget = prepared.textTarget;
         } else {
+          const listBoundaryJoinCommand = createListItemBoundaryJoinReplayCommand({
+            command,
+            document: replayState.document,
+            selection: replayState.selection,
+            surface: replaySnapshot.surface?.blocks ?? [],
+            storyTarget: replayStory,
+            timestamp: context.timestamp
+          });
+          if (listBoundaryJoinCommand) {
+            executableCommand = listBoundaryJoinCommand;
+          }
           const selectedListItemDeleteCommand = createSelectedListItemDeleteReplayCommand({
             command,
             document: replayState.document,
@@ -72801,6 +73212,17 @@ function createDocumentRuntime(options) {
             };
             resolvedReplayTextTarget = prepared.textTarget;
           } else {
+            const listBoundaryJoinCommand = createListItemBoundaryJoinReplayCommand({
+              command,
+              document: stateForCommand.document,
+              selection: stateForCommand.selection,
+              surface: snapshotForCommand.surface?.blocks ?? [],
+              storyTarget: replayStory,
+              timestamp: context.timestamp
+            });
+            if (listBoundaryJoinCommand) {
+              executableCommand = listBoundaryJoinCommand;
+            }
             const selectedListItemDeleteCommand = createSelectedListItemDeleteReplayCommand({
               command,
               document: stateForCommand.document,
@@ -73110,8 +73532,8 @@ function createDocumentRuntime(options) {
     applyScopeReplacement(plan) {
       const resolveEditableTargetHint = (hint) => {
         if (!hint) return void 0;
-        const activeStoryKey = storyTargetKey(activeStory);
-        if (hint.storyKey !== activeStoryKey) return null;
+        const activeStoryKey2 = storyTargetKey(activeStory);
+        if (hint.storyKey !== activeStoryKey2) return null;
         const currentTargets = collectEditableTargetRefs(
           state.document,
           editableTargetBlockCache
@@ -73130,7 +73552,7 @@ function createDocumentRuntime(options) {
           document: state.document,
           surface: cachedRenderSnapshot.surface?.blocks ?? [],
           target,
-          activeStoryKey,
+          activeStoryKey: activeStoryKey2,
           editableTargetCache: editableTargetBlockCache
         });
         if (resolved.kind === "rejected") {
@@ -73830,6 +74252,9 @@ function createDocumentRuntime(options) {
     addScope(params) {
       return workflowCoordinator.addScope(params);
     },
+    addScopes(params) {
+      return workflowCoordinator.addScopes(params);
+    },
     getScope(scopeId) {
       return workflowCoordinator.getScope(scopeId);
     },
@@ -74813,6 +75238,9 @@ function createDocumentRuntime(options) {
     if (transaction.mapping.metadata?.scopeTagTouches) return false;
     return getLocalTextPatchMetadata(transaction.mapping) !== null;
   }
+  function isLayoutNeutralScopeMarkerCommit(previous, next, transaction) {
+    return transaction.markDirty && previous.document !== next.document && transaction.mapping.steps.length === 0 && transaction.mapping.metadata?.layoutNeutralScopeMarkers === true;
+  }
   function applyTransactionToState(transaction, options2 = {}) {
     const effects = transaction.effects;
     const selectionUnchanged = transaction.nextState.selection === state.selection;
@@ -74841,6 +75269,11 @@ function createDocumentRuntime(options) {
       transaction,
       transaction.effects
     );
+    const layoutNeutralScopeMarkerCommit = isLayoutNeutralScopeMarkerCommit(
+      previous,
+      state,
+      transaction
+    );
     perfCounters.increment("commit.refreshClassify.us", Math.round((performance.now() - tClassify0) * 1e3));
     const tOverlay0 = performance.now();
     const skipOverlaySync = useLocalTextCommitSnapshot && canSkipOverlaySyncForLocalText(transaction);
@@ -74889,9 +75322,12 @@ function createDocumentRuntime(options) {
         ...detachedWorkflowScopeWarnings.cleared
       ]
     };
-    if (!useLocalTextCommitSnapshot && transaction.markDirty && previous.document !== state.document) {
+    if (!useLocalTextCommitSnapshot && !layoutNeutralScopeMarkerCommit && transaction.markDirty && previous.document !== state.document) {
       applyViewportRanges(getSelectionCorridorViewportRanges(cachedRenderSnapshot.surface));
     }
+    if (layoutNeutralScopeMarkerCommit && viewportBlockRanges !== null) {
+      getCachedFullSurface(state.document, activeStory);
+    }
     const tValidation0 = performance.now();
     const patchSourceSurface = getReusableCachedFullSurface(previous.document, activeStory) ?? cachedRenderSnapshot.surface;
     const patchedFullLocalTextSurface = useLocalTextCommitSnapshot ? tryPatchLocalTextSurface(patchSourceSurface, transaction.mapping) : null;
@@ -75139,9 +75575,7 @@ function createDocumentRuntime(options) {
         code: cleared.code
       });
     }
-    for (const listener of listeners) {
-      listener();
-    }
+    notifyRuntimeListeners();
   }
   function applyTextCommandInActiveStory(command, textOptions = {}) {
     emitStageToken(telemetryBus, "command", "command.dispatch.start", {
@@ -75260,6 +75694,39 @@ function createDocumentRuntime(options) {
     const preSelection = selection;
     const preActiveStory = activeStory;
     const priorDocument = state.document;
+    const listBoundaryJoin = createListItemBoundaryJoinReplacement({
+      command: commandForDispatch,
+      document: state.document,
+      editableTarget,
+      selection,
+      storyTarget: activeStory,
+      targetResolution,
+      timestamp
+    });
+    if (listBoundaryJoin && context.documentMode !== "suggesting") {
+      const replacementCommand = {
+        type: "document.replace",
+        document: listBoundaryJoin.document,
+        selection: listBoundaryJoin.selection,
+        mapping: listBoundaryJoin.mapping,
+        protectionSelection: selection,
+        origin: commandForDispatch.origin
+      };
+      const transaction = executeEditorCommand(baseState, replacementCommand, context);
+      commit(transaction);
+      options.onCommandApplied?.(commandForDispatch, transaction, context, {
+        preSelection,
+        activeStory: preActiveStory,
+        priorDocument
+      });
+      return completeDispatch(classifyAck({
+        command: commandForDispatch,
+        opId,
+        priorState: baseState,
+        transaction,
+        newRevisionToken: state.revisionToken
+      }));
+    }
     const selectedListItemDelete = createSelectedListItemDeleteReplacement({
       command: commandForDispatch,
       document: state.document,
@@ -75701,7 +76168,7 @@ function createDocumentRuntime(options) {
         const warningDelta = workflowCoordinator.applyOverlayCommand(
           command,
           () => {
-            cachedRenderSnapshot = refreshRenderSnapshot();
+            requestRuntimeRenderSnapshotRefresh();
           }
         );
         if (warningDelta) {
@@ -75759,11 +76226,69 @@ function createDocumentRuntime(options) {
         });
       }
     }
+    notifyRuntimeListeners();
+  }
+  function runRuntimeNotificationBatch(label, fn) {
+    runtimeNotificationBatchDepth += 1;
+    perfCounters.increment(`runtime.notificationBatch.${label}.calls`);
+    try {
+      return fn();
+    } finally {
+      runtimeNotificationBatchDepth -= 1;
+      if (runtimeNotificationBatchDepth === 0) {
+        flushRuntimeNotificationBatch();
+      }
+    }
+  }
+  function requestRuntimeRenderSnapshotRefresh() {
+    if (runtimeNotificationBatchDepth > 0) {
+      pendingRenderSnapshotRefresh = true;
+      perfCounters.increment("runtime.notificationBatch.renderRefreshDeferred");
+      return;
+    }
+    cachedRenderSnapshot = refreshRenderSnapshot();
+  }
+  function notifyRuntimeListeners() {
+    if (runtimeNotificationBatchDepth > 0) {
+      pendingRuntimeListenerNotify = true;
+      perfCounters.increment("runtime.notificationBatch.listenerNotifyDeferred");
+      return;
+    }
+    notifyRuntimeListenersNow();
+  }
+  function notifyRuntimeListenersNow() {
     for (const listener of listeners) {
       listener();
     }
   }
+  function flushRuntimeNotificationBatch() {
+    if (pendingRenderSnapshotRefresh) {
+      pendingRenderSnapshotRefresh = false;
+      cachedRenderSnapshot = refreshRenderSnapshot();
+      perfCounters.increment("runtime.notificationBatch.renderRefreshFlushed");
+    }
+    if (pendingRuntimeEvents.length > 0) {
+      const queuedEvents = pendingRuntimeEvents.splice(0);
+      perfCounters.increment("runtime.notificationBatch.eventsFlushed", queuedEvents.length);
+      for (const event of queuedEvents) {
+        emitInternalNow(event);
+      }
+    }
+    if (pendingRuntimeListenerNotify) {
+      pendingRuntimeListenerNotify = false;
+      perfCounters.increment("runtime.notificationBatch.listenerNotifyFlushed");
+      notifyRuntimeListenersNow();
+    }
+  }
   function emitInternal(event) {
+    if (runtimeNotificationBatchDepth > 0) {
+      pendingRuntimeEvents.push(event);
+      perfCounters.increment("runtime.notificationBatch.eventsQueued");
+      return;
+    }
+    emitInternalNow(event);
+  }
+  function emitInternalNow(event) {
     options.onEvent?.(event);
     for (const listener of eventListeners) {
       listener(event);
@@ -78167,6 +78692,56 @@ function stripStoryTarget2(selection) {
 function isTopLevelMainStoryBlockPath(blockPath) {
   return typeof blockPath === "string" && /^main\/block\[\d+\]$/u.test(blockPath);
 }
+function createListItemBoundaryJoinReplacement(input) {
+  const { command, document: document2, editableTarget, selection, storyTarget, targetResolution, timestamp } = input;
+  const direction = listItemBoundaryJoinDirection(command, selection, targetResolution);
+  if (!direction || editableTarget?.listAddress?.operationScope !== "list-text" || targetResolution?.kind !== "accepted") {
+    return null;
+  }
+  const storyBlocks = getStoryBlocks(document2, storyTarget);
+  const replacement = joinNumberedParagraphAtStoryPath(
+    storyBlocks,
+    editableTarget.blockPath,
+    storyTarget,
+    direction
+  );
+  if (!replacement) {
+    return null;
+  }
+  const nextDocument = replaceStoryBlocks({
+    ...document2,
+    updatedAt: timestamp
+  }, storyTarget, replacement.blocks);
+  const deletedFrom = direction === "backward" ? Math.max(0, selection.anchor - 1) : selection.anchor;
+  const deletedTo = direction === "backward" ? selection.anchor : selection.anchor + 1;
+  const nextAnchor = direction === "backward" ? deletedFrom : selection.anchor;
+  return {
+    document: nextDocument,
+    selection: createSelectionSnapshot(nextAnchor, nextAnchor),
+    mapping: {
+      steps: [{
+        from: deletedFrom,
+        to: deletedTo,
+        insertSize: 0
+      }],
+      metadata: {
+        invalidatesStructures: true
+      }
+    }
+  };
+}
+function listItemBoundaryJoinDirection(command, selection, targetResolution) {
+  if (selection.isCollapsed !== true || targetResolution?.kind !== "accepted") {
+    return null;
+  }
+  if (command.type === "text.delete-backward" && selection.anchor === targetResolution.range.from) {
+    return "backward";
+  }
+  if (command.type === "text.delete-forward" && selection.anchor === targetResolution.range.to) {
+    return "forward";
+  }
+  return null;
+}
 function createSelectedListItemDeleteReplacement(input) {
   const { command, document: document2, editableTarget, selection, storyTarget, targetResolution, timestamp } = input;
   if (command.type !== "text.delete-backward" && command.type !== "text.delete-forward") {
@@ -78214,6 +78789,152 @@ function removeNumberedParagraphAtStoryPath(blocks, blockPath, storyTarget) {
   if (!tokens) return null;
   return removeNumberedParagraphFromBlocks(blocks, tokens);
 }
+function joinNumberedParagraphAtStoryPath(blocks, blockPath, storyTarget, direction) {
+  const tokens = parseStoryBlockPathTokens(blockPath, storyTarget);
+  if (!tokens) return null;
+  return joinNumberedParagraphFromBlocks(blocks, tokens, direction);
+}
+function joinNumberedParagraphFromBlocks(blocks, tokens, direction) {
+  const [token, ...rest] = tokens;
+  if (!token || token.kind !== "block") return null;
+  const block = blocks[token.index];
+  if (!block) return null;
+  if (rest.length === 0) {
+    return joinAdjacentNumberedParagraphs(blocks, token.index, direction);
+  }
+  const next = rest[0];
+  if (block.type === "table" && next?.kind === "row") {
+    const updatedTable = joinNumberedParagraphInTable(block, rest, direction);
+    if (!updatedTable) return null;
+    return {
+      blocks: [
+        ...blocks.slice(0, token.index),
+        updatedTable,
+        ...blocks.slice(token.index + 1)
+      ]
+    };
+  }
+  if ((block.type === "sdt" || block.type === "custom_xml") && next?.kind === "block") {
+    const updatedChildren = joinNumberedParagraphFromBlocks(block.children, rest, direction);
+    if (!updatedChildren) return null;
+    return {
+      blocks: [
+        ...blocks.slice(0, token.index),
+        { ...block, children: updatedChildren.blocks },
+        ...blocks.slice(token.index + 1)
+      ]
+    };
+  }
+  if (block.type === "paragraph" && next?.kind === "inline") {
+    const updatedParagraph = joinNumberedParagraphInTextBoxInline(block, rest, direction);
+    if (!updatedParagraph) return null;
+    return {
+      blocks: [
+        ...blocks.slice(0, token.index),
+        updatedParagraph,
+        ...blocks.slice(token.index + 1)
+      ]
+    };
+  }
+  return null;
+}
+function joinAdjacentNumberedParagraphs(blocks, targetIndex, direction) {
+  const target = blocks[targetIndex];
+  if (target?.type !== "paragraph" || !target.numbering) {
+    return null;
+  }
+  if (direction === "backward") {
+    const previousIndex = targetIndex - 1;
+    const previous = blocks[previousIndex];
+    if (previous?.type !== "paragraph" || !previous.numbering) {
+      return null;
+    }
+    const merged2 = {
+      ...previous,
+      children: [...previous.children, ...target.children]
+    };
+    return {
+      blocks: [
+        ...blocks.slice(0, previousIndex),
+        merged2,
+        ...blocks.slice(targetIndex + 1)
+      ]
+    };
+  }
+  const nextIndex = targetIndex + 1;
+  const next = blocks[nextIndex];
+  if (next?.type !== "paragraph" || !next.numbering) {
+    return null;
+  }
+  const merged = {
+    ...target,
+    children: [...target.children, ...next.children]
+  };
+  return {
+    blocks: [
+      ...blocks.slice(0, targetIndex),
+      merged,
+      ...blocks.slice(nextIndex + 1)
+    ]
+  };
+}
+function joinNumberedParagraphInTable(table, tokens, direction) {
+  const [rowToken, cellToken, ...childTokens] = tokens;
+  if (rowToken?.kind !== "row" || cellToken?.kind !== "cell" || childTokens[0]?.kind !== "block") {
+    return null;
+  }
+  const row2 = table.rows[rowToken.index];
+  const cell = row2?.cells[cellToken.index];
+  if (!row2 || !cell) return null;
+  const updatedChildren = joinNumberedParagraphFromBlocks(cell.children, childTokens, direction);
+  if (!updatedChildren) return null;
+  const nextCells = [
+    ...row2.cells.slice(0, cellToken.index),
+    { ...cell, children: updatedChildren.blocks },
+    ...row2.cells.slice(cellToken.index + 1)
+  ];
+  const nextRows = [
+    ...table.rows.slice(0, rowToken.index),
+    { ...row2, cells: nextCells },
+    ...table.rows.slice(rowToken.index + 1)
+  ];
+  return { ...table, rows: nextRows };
+}
+function joinNumberedParagraphInTextBoxInline(paragraph, tokens, direction) {
+  const [inlineToken, textBoxToken, ...childTokens] = tokens;
+  if (inlineToken?.kind !== "inline" || textBoxToken?.kind !== "txbx" || childTokens[0]?.kind !== "block") {
+    return null;
+  }
+  const inline = paragraph.children[inlineToken.index];
+  if (!inline) return null;
+  const updatedInline = joinNumberedParagraphInInlineTextBox(inline, childTokens, direction);
+  if (!updatedInline) return null;
+  return {
+    ...paragraph,
+    children: [
+      ...paragraph.children.slice(0, inlineToken.index),
+      updatedInline,
+      ...paragraph.children.slice(inlineToken.index + 1)
+    ]
+  };
+}
+function joinNumberedParagraphInInlineTextBox(inline, tokens, direction) {
+  if (inline.type === "shape" && inline.txbxBlocks) {
+    const updatedBlocks = joinNumberedParagraphFromBlocks(inline.txbxBlocks, tokens, direction);
+    return updatedBlocks ? { ...inline, txbxBlocks: updatedBlocks.blocks } : null;
+  }
+  if (inline.type === "drawing_frame" && inline.content.type === "shape" && inline.content.txbxBlocks) {
+    const updatedBlocks = joinNumberedParagraphFromBlocks(inline.content.txbxBlocks, tokens, direction);
+    return updatedBlocks ? {
+      ...inline,
+      content: {
+        ...inline.content,
+        txbxBlocks: updatedBlocks.blocks
+      }
+    } : null;
+  }
+  return null;
+}
 function removeNumberedParagraphFromBlocks(blocks, tokens) {
   const [token, ...rest] = tokens;
   if (!token || token.kind !== "block") return null;
@@ -78376,6 +79097,56 @@ function createSelectedListItemDeleteReplayCommand(input) {
     origin: command.origin
   };
 }
+function createListItemBoundaryJoinReplayCommand(input) {
+  const { command, document: document2, selection, surface, storyTarget, timestamp } = input;
+  if (command.type !== "text.delete-backward" && command.type !== "text.delete-forward") {
+    return null;
+  }
+  const editableTarget = command.editableTarget;
+  if (!editableTarget) {
+    return null;
+  }
+  const targetResolution = resolveEditableTextTarget({
+    document: document2,
+    selection,
+    surface,
+    target: editableTarget,
+    activeStoryKey: canonicalEditableTargetStoryKey(storyTarget)
+  });
+  const resolvedEditableTarget = targetResolution.kind === "accepted" ? editableTarget : storyTarget.kind !== "main" && blockPathBelongsToStoryTarget(editableTarget.blockPath, storyTarget) ? resolveEditableCommandTarget({
+    document: document2,
+    target: editableTarget,
+    activeStoryKey: canonicalEditableTargetStoryKey(storyTarget),
+    commandFamilies: ["text-leaf"]
+  }) : null;
+  const selectedRange = {
+    from: Math.min(selection.anchor, selection.head),
+    to: Math.max(selection.anchor, selection.head)
+  };
+  const replacement = createListItemBoundaryJoinReplacement({
+    command,
+    document: document2,
+    editableTarget: resolvedEditableTarget && resolvedEditableTarget.kind === "accepted" ? resolvedEditableTarget.target : editableTarget,
+    selection,
+    storyTarget,
+    targetResolution: resolvedEditableTarget && resolvedEditableTarget.kind === "accepted" ? {
+      kind: "accepted",
+      range: selectedRange
+    } : targetResolution,
+    timestamp
+  });
+  if (!replacement) {
+    return null;
+  }
+  return {
+    type: "document.replace",
+    document: replacement.document,
+    selection: replacement.selection,
+    mapping: replacement.mapping,
+    protectionSelection: selection,
+    origin: command.origin
+  };
+}
 function parseStoryBlockPathTokens(blockPath, storyTarget) {
   if (!blockPath) {
     return null;
@@ -94542,6 +95313,9 @@ function createLoadingRuntimeBridge(input) {
     addScope: () => {
       throw createLoadingBoundaryError(input.snapshot.documentId, "scope");
     },
+    addScopes: () => {
+      throw createLoadingBoundaryError(input.snapshot.documentId, "scope");
+    },
     getScope: () => null,
     compileScopeBundleById: () => null,
     compileScopeList: () => [],
@@ -126809,7 +127583,8 @@ var LAYER_DEBUG_PANES = [
     snippets: [
       { label: "Selection context", expression: "ref?.getRuntimeContextAnalytics?.()" },
       { label: "Document context", expression: "ref?.getRuntimeContextAnalytics?.({ scopeKind: 'document' })" },
-      { label: "Hot edit trace", expression: "runtime?.debug?.getHotEditTraces?.().at(-1)" },
+      { label: "API families", expression: "api ? Object.keys(api).sort() : null" },
+      { label: "Hot edit trace", expression: "runtime?.debug?.getHotEditTraces?.()?.at(-1)" },
       { label: "View state", expression: "ref?.getViewState?.()" }
     ],
     routed: [
@@ -126823,8 +127598,9 @@ var LAYER_DEBUG_PANES = [
     focus: "Workflow scopes, markup, metadata, candidates, and scope-derived context.",
     snippets: [
       { label: "Scope snapshot", expression: "ref?.getWorkflowScopeSnapshot?.()" },
-      { label: "Query scopes", expression: "ref?.queryScopes?.({ includeHidden: true, includeInvisible: true })" },
-      { label: "Workflow markup", expression: "ref?.getWorkflowMarkupSnapshot?.()" }
+      { label: "Query scopes", expression: "api?.runtime.workflow.queryScopes({ includeHidden: true, includeInvisible: true, limit: 50 }) ?? ref?.queryScopes?.({ includeHidden: true, includeInvisible: true, limit: 50 })" },
+      { label: "Bulk placeholder scopes", expression: "(() => { const r = api?.ai.actions.createPlaceholderScopes({ limit: 200 }); if (!r) return { status: 'api-unavailable' }; return { status: r.status, totalHits: r.totalHits, created: r.created, blocked: r.blocked, scopeIds: r.scopes.slice(0, 50).map((s) => s.scopeId ?? null), blockers: r.blockers?.slice(0, 20) ?? [] }; })()" },
+      { label: "Workflow markup", expression: "(() => { const m = ref?.getWorkflowMarkupSnapshot?.(); return m ? { itemCount: m.items?.length ?? 0, items: m.items?.slice(0, 50) ?? [] } : m; })()" }
     ],
     routed: [
       "Compiler replacement planning and semantic scope normalization remain Layer 08-owned."
@@ -126838,7 +127614,8 @@ var LAYER_DEBUG_PANES = [
     snippets: [
       { label: "Document analytics", expression: "ref?.getRuntimeContextAnalytics?.({ scopeKind: 'document' })" },
       { label: "Workflow analytics", expression: "ref?.getRuntimeContextAnalytics?.({ scopeKind: 'workflow_scope', scopeId: ref?.getInteractionGuardSnapshot?.()?.matchedScopeId })" },
-      { label: "Available scopes", expression: "ref?.queryScopes?.({ includeHidden: true, includeInvisible: true })" }
+      { label: "Available scopes", expression: "api?.ai.listScopes({ limit: 50 }) ?? ref?.queryScopes?.({ includeHidden: true, includeInvisible: true, limit: 50 })" },
+      { label: "Placeholder scope action", expression: "api?.ai.actions.createPlaceholderScopes({ limit: 200 })" }
     ],
     routed: [
       "AI audit references and action policy payloads are Layer 09-owned."
@@ -126866,7 +127643,7 @@ var LAYER_DEBUG_PANES = [
     snippets: [
       { label: "Navigation", expression: "ref?.getDocumentNavigationSnapshot?.()" },
       { label: "Review surface", expression: "({ comments: ref?.getCommentSidebarSnapshot?.(), changes: ref?.getTrackedChangesSnapshot?.() })" },
-      { label: "Hot edit traces", expression: "runtime?.debug?.getHotEditTraces?.()" },
+      { label: "Hot edit traces", expression: "runtime?.debug?.getHotEditTraces?.()?.slice?.(-10)" },
       { label: "Compatibility", expression: "ref?.getCompatibilityReport?.()" }
     ],
     routed: [
@@ -126899,6 +127676,11 @@ var import_jsx_runtime83 = require("react/jsx-runtime");
 var MAX_HISTORY = 30;
 var MAX_ENTRIES = 50;
 var MAX_OUTPUT_CHARS = 8e3;
+var MAX_SERIALIZE_DEPTH = 6;
+var MAX_SERIALIZE_STRING_CHARS = 1e3;
+var MAX_SERIALIZE_ARRAY_ITEMS = 40;
+var MAX_SERIALIZE_OBJECT_KEYS = 80;
+var MAX_SERIALIZE_NODES = 2500;
 var HISTORY_STORAGE_KEY = "wre-runtime-repl-history";
 var HISTORY_STORAGE_VERSION = 1;
 function TwRuntimeReplDialog(props) {
@@ -126996,10 +127778,12 @@ function TwRuntimeReplDialog(props) {
         return;
       }
       try {
+        const refValue = editorRef?.current ?? null;
         const value = await evaluateReplExpression(
           code,
           runtime,
-          editorRef?.current ?? null
+          refValue,
+          resolveReplApi(refValue)
         );
         pushEntry({
           input: code,
@@ -127104,9 +127888,10 @@ function TwRuntimeReplDialog(props) {
                     "evaluates against ",
                     /* @__PURE__ */ (0, import_jsx_runtime83.jsx)("code", { children: "runtime" }),
                     editorRef ? /* @__PURE__ */ (0, import_jsx_runtime83.jsxs)(import_jsx_runtime83.Fragment, { children: [
-                      " ",
-                      "and ",
-                      /* @__PURE__ */ (0, import_jsx_runtime83.jsx)("code", { children: "ref" })
+                      ", ",
+                      /* @__PURE__ */ (0, import_jsx_runtime83.jsx)("code", { children: "ref" }),
+                      ", and ",
+                      /* @__PURE__ */ (0, import_jsx_runtime83.jsx)("code", { children: "api" })
                     ] }) : null
                   ] })
                 ] }),
@@ -127253,10 +128038,10 @@ function TwRuntimeReplDialog(props) {
                   "data-testid": "tw-runtime-repl__output",
                   children: entries.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime83.jsxs)("p", { className: "text-[var(--color-text-tertiary)]", children: [
                     "Evaluate JavaScript against the active runtime",
-                    editorRef ? " and editor ref" : "",
+                    editorRef ? ", editor ref, and API" : "",
                     ". Example:",
                     " ",
-                    /* @__PURE__ */ (0, import_jsx_runtime83.jsx)("code", { children: editorRef ? "ref.getRenderSnapshot().surface?.blocks.length" : "runtime.getRenderSnapshot().surface?.blocks.length" })
+                    /* @__PURE__ */ (0, import_jsx_runtime83.jsx)("code", { children: editorRef ? "api.ai.listScopes({ limit: 5 })" : "runtime.getRenderSnapshot().surface?.blocks.length" })
                   ] }) : entries.map((entry) => /* @__PURE__ */ (0, import_jsx_runtime83.jsxs)("div", { className: "mb-3 last:mb-0", children: [
                     /* @__PURE__ */ (0, import_jsx_runtime83.jsxs)("div", { className: "flex items-start gap-2", children: [
                       /* @__PURE__ */ (0, import_jsx_runtime83.jsx)(
@@ -127306,7 +128091,7 @@ function TwRuntimeReplDialog(props) {
                     onKeyDown: handleKeyDown,
                     rows: 3,
                     spellCheck: false,
-                    placeholder: editorRef ? "ref.getRenderSnapshot().selection" : "runtime.getRenderSnapshot().selection",
+                    placeholder: editorRef ? "api.runtime.workflow.queryScopes({ limit: 10 })" : "runtime.getRenderSnapshot().selection",
                     className: [
                       "w-full resize-y rounded-[var(--radius-sm)] bg-[var(--color-bg-muted)]",
                       "px-3 py-2 font-mono text-xs leading-relaxed",
@@ -127339,12 +128124,13 @@ function isReplToggleShortcut(event) {
   if (event.shiftKey) return false;
   return event.metaKey || event.ctrlKey;
 }
-async function evaluateReplExpression(code, runtime, ref = null) {
+async function evaluateReplExpression(code, runtime, ref = null, api = resolveReplApi(ref)) {
   let fn = null;
   try {
     fn = new Function(
       "runtime",
       "ref",
+      "api",
       `return (async () => { return (${code}); })();`
     );
   } catch (exprError) {
@@ -127354,17 +128140,22 @@ async function evaluateReplExpression(code, runtime, ref = null) {
     fn = new Function(
       "runtime",
       "ref",
+      "api",
       `return (async () => { ${code}
  })();`
     );
   }
-  return await fn(runtime, ref);
+  return await fn(runtime, ref, api);
+}
+function resolveReplApi(ref) {
+  if (!ref || typeof ref.getApiV3 !== "function") return null;
+  return ref.getApiV3();
 }
 function formatReplValue(value) {
   if (value === void 0) return "undefined";
   if (value === null) return "null";
   const type = typeof value;
-  if (type === "string") return JSON.stringify(value);
+  if (type === "string") return truncate2(JSON.stringify(value), MAX_OUTPUT_CHARS);
   if (type === "number" || type === "boolean" || type === "bigint") {
     return String(value);
   }
@@ -127374,7 +128165,7 @@ function formatReplValue(value) {
     return `[Function${fn.name ? `: ${fn.name}` : ""}]`;
   }
   try {
-    const serialized = JSON.stringify(value, createCircularReplacer(), 2);
+    const serialized = JSON.stringify(createReplPreview(value), null, 2);
     if (serialized === void 0) {
       return String(value);
     }
@@ -127390,21 +128181,113 @@ function formatReplError(error) {
   }
   return truncate2(String(error), MAX_OUTPUT_CHARS);
 }
-function createCircularReplacer() {
-  const seen = /* @__PURE__ */ new WeakSet();
-  return function replacer(_key, value) {
-    if (typeof value === "bigint") return `${value.toString()}n`;
-    if (typeof value === "function") {
-      const fn = value;
-      return `[Function${fn.name ? `: ${fn.name}` : ""}]`;
+function createReplPreview(value) {
+  return createReplPreviewValue(value, 0, {
+    seen: /* @__PURE__ */ new WeakSet(),
+    nodes: 0
+  });
+}
+function createReplPreviewValue(value, depth, state) {
+  if (value === null || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return value.length > MAX_SERIALIZE_STRING_CHARS ? `${value.slice(0, MAX_SERIALIZE_STRING_CHARS)}... [truncated ${value.length - MAX_SERIALIZE_STRING_CHARS} chars]` : value;
+  }
+  if (typeof value === "bigint") return `${value.toString()}n`;
+  if (typeof value === "symbol") return value.toString();
+  if (typeof value === "function") {
+    const fn = value;
+    return `[Function${fn.name ? `: ${fn.name}` : ""}]`;
+  }
+  if (typeof value !== "object") return String(value);
+  state.nodes += 1;
+  if (state.nodes > MAX_SERIALIZE_NODES) {
+    return "[Max REPL preview nodes reached]";
+  }
+  const objectValue = value;
+  if (state.seen.has(objectValue)) return "[Circular]";
+  state.seen.add(objectValue);
+  if (depth >= MAX_SERIALIZE_DEPTH) {
+    return summarizePreviewBoundary(objectValue);
+  }
+  const domPreview = summarizeDomNode(objectValue);
+  if (domPreview) return domPreview;
+  if (Array.isArray(value)) {
+    const preview = value.slice(0, MAX_SERIALIZE_ARRAY_ITEMS).map((item) => createReplPreviewValue(item, depth + 1, state));
+    if (value.length > MAX_SERIALIZE_ARRAY_ITEMS) {
+      preview.push(`[... ${value.length - MAX_SERIALIZE_ARRAY_ITEMS} more items]`);
     }
-    if (typeof value === "symbol") return value.toString();
-    if (value !== null && typeof value === "object") {
-      if (seen.has(value)) return "[Circular]";
-      seen.add(value);
+    return preview;
+  }
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? "[Invalid Date]" : value.toISOString();
+  }
+  if (value instanceof Map) {
+    const entries = [];
+    let index = 0;
+    for (const [key, entryValue] of value.entries()) {
+      if (index >= MAX_SERIALIZE_OBJECT_KEYS) {
+        entries.push("[additional map entries omitted]");
+        break;
+      }
+      entries.push([
+        createReplPreviewValue(key, depth + 1, state),
+        createReplPreviewValue(entryValue, depth + 1, state)
+      ]);
+      index += 1;
     }
-    return value;
-  };
+    return { "[Map]": entries };
+  }
+  if (value instanceof Set) {
+    const entries = [];
+    let index = 0;
+    for (const entryValue of value.values()) {
+      if (index >= MAX_SERIALIZE_OBJECT_KEYS) {
+        entries.push("[additional set entries omitted]");
+        break;
+      }
+      entries.push(createReplPreviewValue(entryValue, depth + 1, state));
+      index += 1;
+    }
+    return { "[Set]": entries };
+  }
+  const output = {};
+  let count = 0;
+  for (const key in value) {
+    if (!Object.prototype.propertyIsEnumerable.call(value, key)) continue;
+    if (count >= MAX_SERIALIZE_OBJECT_KEYS) {
+      output["..."] = "[additional properties omitted]";
+      break;
+    }
+    try {
+      output[key] = createReplPreviewValue(
+        value[key],
+        depth + 1,
+        state
+      );
+    } catch (error) {
+      output[key] = `[unreadable property: ${formatReplError(error)}]`;
+    }
+    count += 1;
+  }
+  return output;
+}
+function summarizePreviewBoundary(value) {
+  if (Array.isArray(value)) return `[Array(${value.length}) depth limit]`;
+  const domPreview = summarizeDomNode(value);
+  if (domPreview) return domPreview;
+  const constructorName = value.constructor?.name;
+  return constructorName && constructorName !== "Object" ? `[${constructorName} depth limit]` : "[Object depth limit]";
+}
+function summarizeDomNode(value) {
+  const maybeNode = value;
+  if (typeof maybeNode.nodeType !== "number" || typeof maybeNode.nodeName !== "string") {
+    return null;
+  }
+  const id = typeof maybeNode.id === "string" && maybeNode.id.length > 0 ? `#${maybeNode.id}` : "";
+  const className = typeof maybeNode.className === "string" && maybeNode.className.length > 0 ? `.${maybeNode.className.trim().replace(/\s+/g, ".")}` : "";
+  return `[DOM ${maybeNode.nodeName.toLowerCase()}${id}${className}]`;
 }
 function truncate2(text, max) {
   if (text.length <= max) return text;
@@ -128754,9 +129637,23 @@ function findSurfaceBlockById(blocks, blockId) {
 }
 function createScopeFromAnchor(runtime, input) {
   const doc = runtime.getCanonicalDocument();
-  const storyTarget = input.anchor.storyTarget ?? { kind: "main" };
+  const normalizedInputAnchor = normalizeCreateScopeAnchor(input.anchor);
+  const storyTarget = normalizedInputAnchor.storyTarget ?? { kind: "main" };
   const storyLength = storyTarget.kind === "main" ? computeMainStoryLength(doc) : Number.MAX_SAFE_INTEGER;
-  const { from, to } = input.anchor;
+  const { from, to } = normalizedInputAnchor;
+  if (!Number.isFinite(from) || !Number.isFinite(to)) {
+    const diagnosticFrom = Number.isFinite(from) ? from : 0;
+    const diagnosticTo = Number.isFinite(to) ? to : diagnosticFrom;
+    return {
+      status: "range-invalid",
+      reason: "non-finite-range",
+      from: diagnosticFrom,
+      to: diagnosticTo,
+      storyLength,
+      message: `createScopeFromAnchor requires finite numeric from/to offsets. Pass selection.activeRange or an object shaped as {from, to}; do not pass a malformed range.`,
+      nextStep: "pass-selection-activeRange-or-finite-from-to"
+    };
+  }
   if (from < 0) {
     return {
       status: "range-invalid",
@@ -128854,6 +129751,29 @@ function createScopeFromAnchor(runtime, input) {
   }
   return { status: "created", scopeId: result.scopeId, anchor: result.anchor };
 }
+function normalizeCreateScopeAnchor(anchor) {
+  const candidate = anchor;
+  const activeRange = candidate.activeRange;
+  if (activeRange?.kind === "range") {
+    return {
+      from: activeRange.from,
+      to: activeRange.to,
+      storyTarget: candidate.storyTarget
+    };
+  }
+  if (candidate.kind === "range") {
+    return {
+      from: candidate.from ?? Number.NaN,
+      to: candidate.to ?? Number.NaN,
+      storyTarget: candidate.storyTarget
+    };
+  }
+  return {
+    from: candidate.from ?? Number.NaN,
+    to: candidate.to ?? Number.NaN,
+    storyTarget: candidate.storyTarget
+  };
+}
 
 // src/api/v3/runtime/workflow.ts
 var createScopeMetadata = {
@@ -128894,6 +129814,29 @@ var createScopeFromAnchorMetadata = {
   broadcastsVia: "crdt",
   rwdReference: "\xA7Runtime API \xA7 runtime.workflow.createScopeFromAnchor. Companion to createScope({blockId}) for sub-block ranges. Consumes from/to once to plant inline scope_marker_start/end; the returned scopeId is the durable reference (KI-P9)."
 };
+var createScopesMetadata = {
+  name: "runtime.workflow.createScopes",
+  status: "live-with-adapter",
+  sourceLayer: "workflow-review",
+  liveEvidence: {
+    runnerTest: "test/api/v3/workflow-create-scope-live.test.ts",
+    commit: "pending"
+  },
+  uxIntent: {
+    uiVisible: true,
+    expectsUxResponse: "scope-created",
+    expectedDelta: "rail shows new scope chips; editor surface refreshes once after the bulk scope batch"
+  },
+  agentMetadata: {
+    readOrMutate: "mutate",
+    boundedScope: "selection",
+    auditCategory: "scope-creation"
+  },
+  stateClass: "A-canonical",
+  persistsTo: "customXml",
+  broadcastsVia: "crdt",
+  rwdReference: "\xA7Runtime API \xA7 runtime.workflow.createScopes. Bulk companion to createScope/createScopeFromAnchor; resolves blockId/range inputs, plants marker-backed scopes via one runtime addScopes batch, and returns per-item results."
+};
 var setScopeGuardPolicyMetadata = {
   name: "runtime.workflow.setScopeGuardPolicy",
   status: "live",
@@ -128989,6 +129932,228 @@ var setMarkupModePolicyMetadata = {
   broadcastsVia: "crdt",
   rwdReference: "\xA7Runtime API \xA7 runtime.workflow.setMarkupModePolicy"
 };
+function isAnchorScopeInput(input) {
+  return "anchor" in input;
+}
+function normalizeCreateScopesAnchor(anchor) {
+  const candidate = anchor;
+  const activeRange = candidate.activeRange;
+  if (activeRange?.kind === "range") {
+    return {
+      from: activeRange.from,
+      to: activeRange.to,
+      storyTarget: candidate.storyTarget
+    };
+  }
+  if (candidate.kind === "range") {
+    return {
+      from: candidate.from ?? Number.NaN,
+      to: candidate.to ?? Number.NaN,
+      storyTarget: candidate.storyTarget
+    };
+  }
+  return {
+    from: candidate.from ?? Number.NaN,
+    to: candidate.to ?? Number.NaN,
+    storyTarget: candidate.storyTarget
+  };
+}
+function stableRefMetadataFields(stableRefHint) {
+  if (stableRefHint === void 0) return void 0;
+  return [{
+    key: "stableRefHint",
+    valueType: "string",
+    value: stableRefHint
+  }];
+}
+function createRangeInvalidResult(inputIndex, reason, from, to, storyLength, detail) {
+  const base = {
+    inputIndex,
+    scopeId: "",
+    status: "range-invalid",
+    reason,
+    from,
+    to,
+    storyLength,
+    ...detail?.blockIndex !== void 0 ? { blockIndex: detail.blockIndex } : {},
+    ...detail?.blockKind !== void 0 ? { blockKind: detail.blockKind } : {}
+  };
+  switch (reason) {
+    case "non-finite-range":
+      return {
+        ...base,
+        message: `createScopes requires finite numeric from/to values (received from=${from}, to=${to}). Pass selection.activeRange or an object shaped as {from, to}.`,
+        nextStep: "pass-selection-activeRange-or-finite-from-to"
+      };
+    case "from-negative":
+      return {
+        ...base,
+        message: `createScopes requires from >= 0 (received from=${from}). Clamp negative values to 0 before calling.`,
+        nextStep: "clamp-from-to-zero"
+      };
+    case "to-less-than-from":
+      return {
+        ...base,
+        message: `createScopes requires to >= from (received from=${from}, to=${to}). Swap the two values before calling.`,
+        nextStep: "swap-from-and-to"
+      };
+    case "range-exceeds-story-length":
+      return {
+        ...base,
+        message: `createScopes requires to <= storyLength (received to=${to}, storyLength=${storyLength}). Re-derive positions from the current document and retry.`,
+        nextStep: "clamp-to-to-storyLength-or-pick-a-different-range"
+      };
+    case "non-paragraph-target":
+      return {
+        ...base,
+        message: `createScopes refused range [${from}, ${to}]: it targets a ${detail?.blockKind ?? "non-paragraph"} block. Pick a paragraph target or use a structural workflow scope.`,
+        nextStep: "pick-a-paragraph-target"
+      };
+    case "empty-document":
+      return {
+        ...base,
+        message: "createScopes refused: the target document has no blocks; initialize a document before creating scopes.",
+        nextStep: "initialize-document-before-creating-scopes"
+      };
+  }
+}
+function plantFailureToCreateScopesResult(pending, result) {
+  const status = result.plantStatus;
+  if (!status || status.planted !== false) {
+    return {
+      inputIndex: pending.inputIndex,
+      status: "created",
+      scopeId: result.scopeId
+    };
+  }
+  if (status.reason === "non-paragraph-target") {
+    return createRangeInvalidResult(
+      pending.inputIndex,
+      "non-paragraph-target",
+      pending.from,
+      pending.to,
+      status.storyLength ?? pending.storyLength,
+      {
+        blockIndex: status.blockIndex ?? -1,
+        blockKind: status.blockKind ?? "unknown"
+      }
+    );
+  }
+  if (status.reason === "range-out-of-bounds") {
+    return createRangeInvalidResult(
+      pending.inputIndex,
+      "range-exceeds-story-length",
+      pending.from,
+      pending.to,
+      status.storyLength ?? pending.storyLength
+    );
+  }
+  return createRangeInvalidResult(
+    pending.inputIndex,
+    "empty-document",
+    pending.from,
+    pending.to,
+    status.storyLength ?? pending.storyLength
+  );
+}
+function createScopesBulk(runtime, input) {
+  const doc = runtime.getCanonicalDocument();
+  const storyLength = runtime.getRenderSnapshot().surface?.storySize ?? 0;
+  const results = [];
+  const pending = [];
+  input.scopes.forEach((item, inputIndex) => {
+    const assoc = item.assoc ?? { start: 1, end: -1 };
+    const scopeMetadataFields = stableRefMetadataFields(item.stableRefHint);
+    if (isAnchorScopeInput(item)) {
+      const normalizedAnchor = normalizeCreateScopesAnchor(item.anchor);
+      const { from, to } = normalizedAnchor;
+      const itemStoryLength = normalizedAnchor.storyTarget?.kind === void 0 || normalizedAnchor.storyTarget.kind === "main" ? storyLength : Number.MAX_SAFE_INTEGER;
+      if (!Number.isFinite(from) || !Number.isFinite(to)) {
+        results.push(createRangeInvalidResult(inputIndex, "non-finite-range", from, to, itemStoryLength));
+        return;
+      }
+      if (from < 0) {
+        results.push(createRangeInvalidResult(inputIndex, "from-negative", from, to, itemStoryLength));
+        return;
+      }
+      if (to < from) {
+        results.push(createRangeInvalidResult(inputIndex, "to-less-than-from", from, to, itemStoryLength));
+        return;
+      }
+      if (to > itemStoryLength) {
+        results.push(createRangeInvalidResult(inputIndex, "range-exceeds-story-length", from, to, itemStoryLength));
+        return;
+      }
+      const anchor2 = {
+        kind: "range",
+        from,
+        to,
+        assoc
+      };
+      pending.push({
+        inputIndex,
+        request: {
+          anchor: anchor2,
+          scopeId: item.scopeId,
+          mode: item.mode,
+          persistence: item.persistence,
+          metadata: item.metadata,
+          label: item.label,
+          storyTarget: normalizedAnchor.storyTarget ?? { kind: "main" },
+          ...item.visibility ? { visibility: item.visibility } : {},
+          ...item.guardPolicy ? { guardPolicy: item.guardPolicy } : {},
+          ...scopeMetadataFields ? { scopeMetadataFields } : {}
+        },
+        from,
+        to,
+        storyLength: itemStoryLength
+      });
+      return;
+    }
+    const anchor = resolveBlockAnchorFromCanonical(doc, item.blockId, assoc);
+    if (!anchor || anchor.kind !== "range") {
+      results.push({
+        inputIndex,
+        scopeId: "",
+        status: "block-not-found"
+      });
+      return;
+    }
+    pending.push({
+      inputIndex,
+      request: {
+        anchor,
+        scopeId: item.scopeId,
+        mode: item.mode,
+        persistence: item.persistence,
+        metadata: item.metadata,
+        label: item.label,
+        ...item.visibility ? { visibility: item.visibility } : {},
+        ...item.guardPolicy ? { guardPolicy: item.guardPolicy } : {},
+        ...scopeMetadataFields ? { scopeMetadataFields } : {}
+      },
+      from: anchor.from,
+      to: anchor.to,
+      storyLength
+    });
+  });
+  const created = runtime.addScopes(pending.map((item) => item.request));
+  created.forEach((result, index) => {
+    const item = pending[index];
+    if (!item) return;
+    results.push(plantFailureToCreateScopesResult(item, result));
+  });
+  const sorted = results.sort((a, b) => a.inputIndex - b.inputIndex);
+  const createdCount = sorted.filter((item) => item.status === "created").length;
+  const blocked2 = sorted.length - createdCount;
+  return {
+    status: blocked2 === 0 ? "created" : createdCount > 0 ? "partial" : "blocked",
+    total: input.scopes.length,
+    created: createdCount,
+    blocked: blocked2,
+    scopes: Object.freeze(sorted)
+  };
+}
 function createWorkflowFamily(runtime) {
   return {
     queryScopes(filter) {
@@ -129003,7 +130168,10 @@ function createWorkflowFamily(runtime) {
     createScope(input) {
       const adapterResult = createScopeFromBlockId(runtime, {
         blockId: input.blockId,
+        scopeId: input.scopeId,
         mode: input.mode,
+        persistence: input.persistence,
+        metadata: input.metadata,
         label: input.label,
         ...input.visibility ? { visibility: input.visibility } : {},
         ...input.guardPolicy ? { guardPolicy: input.guardPolicy } : {},
@@ -129037,6 +130205,25 @@ function createWorkflowFamily(runtime) {
       }
       return { scopeId: adapterResult.scopeId, status: "created" };
     },
+    createScopes(input) {
+      const result = createScopesBulk(runtime, input);
+      emitUxResponse(runtime, {
+        apiFn: createScopesMetadata.name,
+        intent: createScopesMetadata.uxIntent.expectedDelta ?? "",
+        mockOrLive: "live",
+        uiVisible: true,
+        expectedDelta: createScopesMetadata.uxIntent.expectedDelta,
+        actualDelta: result.created > 0 ? {
+          kind: "inline-change",
+          payload: {
+            created: result.created,
+            blocked: result.blocked,
+            scopeIds: result.scopes.filter((scope) => scope.status === "created").map((scope) => scope.scopeId)
+          }
+        } : void 0
+      });
+      return result;
+    },
     getScopeGuardPolicy(scopeId) {
       return runtime.getScopeGuardPolicy(scopeId);
     },
@@ -129072,7 +130259,10 @@ function createWorkflowFamily(runtime) {
     createScopeFromAnchor(input) {
       const adapterResult = createScopeFromAnchor(runtime, {
         anchor: input.anchor,
+        scopeId: input.scopeId,
         mode: input.mode,
+        persistence: input.persistence,
+        metadata: input.metadata,
         label: input.label,
         ...input.visibility ? { visibility: input.visibility } : {},
         ...input.guardPolicy ? { guardPolicy: input.guardPolicy } : {},
@@ -130100,7 +131290,8 @@ var SUPPORTED_COMMANDS2 = [
   "indent",
   "outdent",
   "restart-numbering",
-  "continue-numbering"
+  "continue-numbering",
+  "set-value"
 ];
 var UNSUPPORTED_COMMANDS2 = [
   "create",
@@ -130109,7 +131300,6 @@ var UNSUPPORTED_COMMANDS2 = [
   "join",
   "separate",
   "split",
-  "set-value",
   "apply-template",
   "capture-template",
   "apply-preset",
@@ -130157,11 +131347,17 @@ function createListsFamily2(runtime) {
       const resolved = resolveCurrentListTarget(runtime.getCanonicalDocument(), input);
       return resolved.kind === "resolved" ? toReadback(runtime.getCanonicalDocument(), resolved.target, resolved.paragraph) : null;
     },
+    canJoin(input) {
+      return sequencePreflight(runtime.getCanonicalDocument(), input, activeStoryKey(runtime));
+    },
+    canContinuePrevious(input) {
+      return sequencePreflight(runtime.getCanonicalDocument(), input, activeStoryKey(runtime));
+    },
     previewCommand(input) {
-      return previewListCommand(runtime.getCanonicalDocument(), input);
+      return previewListCommand(runtime.getCanonicalDocument(), input, activeStoryKey(runtime));
     },
     applyCommand(input) {
-      const preview = previewListCommand(runtime.getCanonicalDocument(), input);
+      const preview = previewListCommand(runtime.getCanonicalDocument(), input, activeStoryKey(runtime));
       if (!preview.supported || !preview.target) {
         return {
           applied: false,
@@ -130221,7 +131417,38 @@ function createListsFamily2(runtime) {
     }
   };
 }
-function previewListCommand(document2, input) {
+function sequencePreflight(document2, input, activeStoryKey2) {
+  const resolved = resolveCurrentListTarget(document2, input);
+  if (resolved.kind !== "resolved") {
+    return {
+      canJoin: false,
+      canContinuePrevious: false,
+      blockers: [resolved.blocker]
+    };
+  }
+  const target = toReadback(document2, resolved.target, resolved.paragraph);
+  const targetRef = { targetKey: target.targetKey, addressKey: target.addressKey };
+  if (activeStoryKey2 !== void 0 && target.storyKey !== activeStoryKey2) {
+    return {
+      target,
+      canJoin: false,
+      canContinuePrevious: false,
+      blockers: [{
+        code: "list-target-wrong-story",
+        ownerLayer: "L07",
+        message: "List target does not belong to the runtime active story.",
+        ...targetRef
+      }]
+    };
+  }
+  return {
+    target,
+    canJoin: canJoinPreviousSequence(document2, resolved.paragraphIndex),
+    canContinuePrevious: canContinuePreviousSequence(document2, resolved.paragraphIndex),
+    blockers: []
+  };
+}
+function previewListCommand(document2, input, activeStoryKey2) {
   const resolved = resolveCurrentListTarget(document2, input);
   if (resolved.kind !== "resolved") {
     return {
@@ -130233,6 +131460,20 @@ function previewListCommand(document2, input) {
   }
   const target = toReadback(document2, resolved.target, resolved.paragraph);
   const targetRef = { targetKey: target.targetKey, addressKey: target.addressKey };
+  if (activeStoryKey2 !== void 0 && target.storyKey !== activeStoryKey2) {
+    return {
+      command: input.command,
+      supported: false,
+      target,
+      affectedTargets: [target],
+      blockers: [{
+        code: "list-target-wrong-story",
+        ownerLayer: "L07",
+        message: "List target does not belong to the runtime active story.",
+        ...targetRef
+      }]
+    };
+  }
   if (!SUPPORTED_COMMANDS2.includes(input.command)) {
     return {
       command: input.command,
@@ -130245,6 +131486,17 @@ function previewListCommand(document2, input) {
   const canContinuePrevious = canContinuePreviousSequence(document2, resolved.paragraphIndex);
   const canJoin = canJoinPreviousSequence(document2, resolved.paragraphIndex);
   const blockers = [];
+  if (input.command === "set-value") {
+    const value = input.startAt;
+    if (!Number.isInteger(value) || value === void 0 || value < 1) {
+      blockers.push({
+        code: "list-command-preflight-blocked",
+        ownerLayer: "L07",
+        message: "runtime.lists.set-value requires a positive integer startAt value.",
+        ...targetRef
+      });
+    }
+  }
   if (input.command === "continue-numbering" && !canContinuePrevious) {
     blockers.push({
       code: "list-continue-target-missing",
@@ -130275,6 +131527,7 @@ function editorCommandForListCommand(command, editableTarget, timestamp, startAt
     case "outdent":
       return { type: "list.outdent", editableTargets: [editableTarget], origin };
     case "restart-numbering":
+    case "set-value":
       return {
         type: "list.restart-numbering",
         editableTarget,
@@ -130358,33 +131611,35 @@ function resolveCurrentListTarget(document2, input) {
   return { kind: "resolved", ...resolved };
 }
 function currentListTargets(document2) {
-  const paragraphs = collectParagraphEntries(document2.content.children, "main");
+  const paragraphs = collectParagraphEntries(document2);
   const targets = collectEditableTargetRefs(document2).filter(isListTextTarget);
-  const byBlockPath = /* @__PURE__ */ new Map();
-  for (const target of targets) byBlockPath.set(target.blockPath, target);
+  const byStoryBlockPath = /* @__PURE__ */ new Map();
+  for (const target of targets) byStoryBlockPath.set(storyBlockPathKey(target.storyKey, target.blockPath), target);
   const out = [];
   for (let paragraphIndex = 0; paragraphIndex < paragraphs.length; paragraphIndex += 1) {
     const entry = paragraphs[paragraphIndex];
     if (!entry?.paragraph.numbering) continue;
-    const target = byBlockPath.get(entry.blockPath);
+    const target = byStoryBlockPath.get(storyBlockPathKey(entry.storyKey, entry.blockPath));
     if (!target) continue;
-    out.push({ target, paragraph: entry.paragraph, paragraphIndex });
+    out.push({ target, paragraph: entry.paragraph, paragraphIndex, storyKey: entry.storyKey });
   }
   return out;
 }
-function collectParagraphEntries(blocks, basePath) {
+function collectParagraphEntries(document2) {
   const out = [];
-  collectParagraphEntriesInto(blocks, basePath, out);
+  for (const context of collectStoryBlockContexts(document2)) {
+    collectParagraphEntriesInto(context.blocks, context.storyKey, context.basePath, out);
+  }
   return out;
 }
-function collectParagraphEntriesInto(blocks, basePath, out) {
+function collectParagraphEntriesInto(blocks, storyKey2, basePath, out) {
   for (let blockIndex = 0; blockIndex < blocks.length; blockIndex += 1) {
     const block = blocks[blockIndex];
     if (!block) continue;
     const blockPath = `${basePath}/block[${blockIndex}]`;
     switch (block.type) {
       case "paragraph":
-        out.push({ paragraph: block, blockPath });
+        out.push({ paragraph: block, storyKey: storyKey2, blockPath, containerPath: basePath });
         break;
       case "table":
         for (let rowIndex = 0; rowIndex < block.rows.length; rowIndex += 1) {
@@ -130395,6 +131650,7 @@ function collectParagraphEntriesInto(blocks, basePath, out) {
             if (!cell) continue;
             collectParagraphEntriesInto(
               cell.children,
+              storyKey2,
               `${blockPath}/row[${rowIndex}]/cell[${cellIndex}]`,
               out
             );
@@ -130402,7 +131658,7 @@ function collectParagraphEntriesInto(blocks, basePath, out) {
         }
         break;
       case "sdt":
-        collectParagraphEntriesInto(block.children, blockPath, out);
+        collectParagraphEntriesInto(block.children, storyKey2, blockPath, out);
         break;
       case "custom_xml":
         break;
@@ -130446,13 +131702,17 @@ function toReadback(document2, target, paragraph) {
   };
 }
 function canContinuePreviousSequence(document2, paragraphIndex) {
-  const paragraphs = collectParagraphEntries(document2.content.children, "main");
-  const current = paragraphs[paragraphIndex]?.paragraph;
+  const paragraphs = collectParagraphEntries(document2);
+  const currentEntry = paragraphs[paragraphIndex];
+  const current = currentEntry?.paragraph;
   if (!current?.numbering) return false;
   const currentKind = getListKind(document2.numbering, current.numbering.numberingInstanceId);
   if (!currentKind) return false;
   for (let index = paragraphIndex - 1; index >= 0; index -= 1) {
-    const previous = paragraphs[index]?.paragraph;
+    const previousEntry = paragraphs[index];
+    if (previousEntry?.storyKey !== currentEntry.storyKey) break;
+    if (previousEntry.containerPath !== currentEntry.containerPath) break;
+    const previous = previousEntry.paragraph;
     if (!previous?.numbering) continue;
     const previousKind = getListKind(document2.numbering, previous.numbering.numberingInstanceId);
     return previousKind === currentKind && previous.numbering.numberingInstanceId !== current.numbering.numberingInstanceId;
@@ -130460,14 +131720,26 @@ function canContinuePreviousSequence(document2, paragraphIndex) {
   return false;
 }
 function canJoinPreviousSequence(document2, paragraphIndex) {
-  const paragraphs = collectParagraphEntries(document2.content.children, "main");
-  const current = paragraphs[paragraphIndex]?.paragraph;
-  const previous = paragraphs[paragraphIndex - 1]?.paragraph;
+  const paragraphs = collectParagraphEntries(document2);
+  const currentEntry = paragraphs[paragraphIndex];
+  const previousEntry = paragraphs[paragraphIndex - 1];
+  if (previousEntry?.storyKey !== currentEntry?.storyKey) return false;
+  if (previousEntry?.containerPath !== currentEntry?.containerPath) return false;
+  const current = currentEntry?.paragraph;
+  const previous = previousEntry?.paragraph;
   if (!current?.numbering || !previous?.numbering) return false;
   const currentKind = getListKind(document2.numbering, current.numbering.numberingInstanceId);
   const previousKind = getListKind(document2.numbering, previous.numbering.numberingInstanceId);
   return Boolean(currentKind) && currentKind === previousKind && current.numbering.numberingInstanceId !== previous.numbering.numberingInstanceId;
 }
+function storyBlockPathKey(storyKey2, blockPath) {
+  return `${storyKey2}
+${blockPath}`;
+}
+function activeStoryKey(runtime) {
+  const activeStory = runtime.getRenderSnapshot()?.activeStory;
+  return activeStory ? storyTargetKey(activeStory) : void 0;
+}
 function unsupportedCommandBlocker(command, target) {
   return {
     code: "list-command-unsupported",
@@ -134762,33 +136034,51 @@ function createPlaceholderScopes(runtime, input) {
       blockerDetails: Object.freeze([detail])
     };
   }
-  const compiler = createScopeCompilerService(runtime);
   const byOriginalIndex = /* @__PURE__ */ new Map();
-  for (const item of orderedHits) {
+  const createdScopeIds = [];
+  const scopeRequests = orderedHits.map((item) => {
     const text = item.text || query;
     const label = input.labelPrefix === void 0 ? text : `${input.labelPrefix} ${item.originalIndex + 1}`;
-    const result = createScopeFromAnchor(runtime, {
-      anchor: { from: item.hit.from, to: item.hit.to },
+    return {
+      anchor: {
+        kind: "range",
+        from: item.hit.from,
+        to: item.hit.to,
+        assoc: input.assoc ?? { start: 1, end: -1 }
+      },
       mode: input.mode ?? "edit",
       label,
       ...input.visibility ? { visibility: input.visibility } : {},
       ...input.guardPolicy ? { guardPolicy: input.guardPolicy } : {},
       ...input.assoc ? { assoc: input.assoc } : {},
-      ...input.stableRefHint ? { stableRefHint: input.stableRefHint } : {}
-    });
-    if (result.status === "created") {
-      const compiled = compiler.compileScopeById(result.scopeId)?.scope;
+      ...input.stableRefHint ? {
+        scopeMetadataFields: [
+          {
+            key: "stableRefHint",
+            valueType: "string",
+            value: input.stableRefHint
+          }
+        ]
+      } : {}
+    };
+  });
+  const scopeResults = runtime.addScopes(scopeRequests);
+  orderedHits.forEach((item, requestIndex) => {
+    const text = item.text || query;
+    const result = scopeResults[requestIndex];
+    if (result && result.scopeId && result.plantStatus?.planted !== false) {
+      createdScopeIds.push(result.scopeId);
       byOriginalIndex.set(item.originalIndex, {
         status: "created",
         text,
         excerpt: excerpt(text),
-        scopeId: result.scopeId,
-        ...compiled?.handle ? { handle: compiled.handle } : {}
+        scopeId: result.scopeId
       });
-      continue;
+      return;
     }
+    const reason = result?.plantStatus?.reason ?? "unknown";
     const detail = blockerWithOwner(
-      `actions:placeholder-scopes:create-refused:${result.reason}`,
+      `actions:placeholder-scopes:create-refused:${reason}`,
       "blocked",
       "The placeholder match could not be converted into a workflow scope.",
       "Refresh the document and retry; if it still refuses, route the target to the workflow/scope writer owner.",
@@ -134801,6 +136091,38 @@ function createPlaceholderScopes(runtime, input) {
       blockers: Object.freeze([detail.code]),
       blockerDetails: Object.freeze([detail])
     });
+  });
+  if (createdScopeIds.length > 0) {
+    const createdScopeIdSet = new Set(createdScopeIds);
+    const handlesByScopeId = new Map(
+      createScopeCompilerService(runtime).compileAllScopes().filter((scope) => createdScopeIdSet.has(scope.handle.scopeId)).map((scope) => [scope.handle.scopeId, scope.handle])
+    );
+    for (const [originalIndex, item] of byOriginalIndex) {
+      if (item.status !== "created" || !item.scopeId) continue;
+      const handle = handlesByScopeId.get(item.scopeId);
+      if (!handle) {
+        const detail = blockerWithOwner(
+          `actions:placeholder-scopes:create-unresolved:${item.scopeId}`,
+          "blocked",
+          "The placeholder scope marker was planted but did not enumerate as a current semantic scope handle.",
+          "Treat this target as unresolved, refresh scope enumeration, and route persistent misses to the semantic-scope compiler owner.",
+          "L08"
+        );
+        byOriginalIndex.set(originalIndex, {
+          status: "blocked",
+          text: item.text,
+          excerpt: item.excerpt,
+          scopeId: item.scopeId,
+          blockers: Object.freeze([detail.code]),
+          blockerDetails: Object.freeze([detail])
+        });
+        continue;
+      }
+      byOriginalIndex.set(originalIndex, {
+        ...item,
+        handle
+      });
+    }
   }
   const scopes = orderedHits.map((item) => byOriginalIndex.get(item.originalIndex)).filter((value) => value !== void 0);
   const created = scopes.filter((scope) => scope.status === "created").length;
@@ -135263,6 +136585,9 @@ function applyRewrite(runtime, target, input) {
   if (target.kind === "editable-text") {
     return applyEditableTextRewrite(runtime, target, input);
   }
+  if (target.handle.provenance === "marker-backed" && (target.scope.kind === "paragraph" || target.scope.kind === "list-item")) {
+    return applyMarkerBackedRangeRewrite(runtime, target, input);
+  }
   if (target.scope.kind === "list-item") {
     const listTextTarget = uniqueListTextActionForScope(runtime, target.handle);
     if (!listTextTarget.ok) return blockedApplyFromResolution(listTextTarget);
@@ -135409,13 +136734,97 @@ function applyEditableTextRewrite(runtime, target, input) {
     afterReadback
   };
 }
+function applyMarkerBackedRangeRewrite(runtime, target, input) {
+  const range = buildScopePositionMap(runtime.getCanonicalDocument()).markerScopes.get(
+    target.handle.scopeId
+  );
+  if (!range) {
+    return blockedApply(
+      `actions:rewrite:marker-range-unresolved:${target.handle.scopeId}`,
+      "unresolved-target",
+      "The marker-backed scope could not be joined to its current marker range.",
+      "Refresh placeholder scopes and retry; route persistent failures to L06 marker scope tracking."
+    );
+  }
+  const beforeReadback = markerScopeReadback(runtime, target.handle.scopeId) ?? {
+    text: target.scope.content.text,
+    isEmpty: target.scope.content.text.length === 0
+  };
+  const before = runtime.getCanonicalDocument();
+  const origin = actionOrigin(runtime, input);
+  runtime.dispatch({
+    type: "selection.set",
+    selection: {
+      anchor: range.from,
+      head: range.to,
+      isCollapsed: range.from === range.to,
+      activeRange: {
+        kind: "range",
+        from: range.from,
+        to: range.to,
+        assoc: { start: -1, end: 1 }
+      }
+    },
+    origin
+  });
+  const ack = runtime.applyActiveStoryTextCommand({
+    type: "text.insert",
+    text: input.text,
+    origin
+  });
+  const changed = runtime.getCanonicalDocument() !== before;
+  const afterReadback = markerScopeReadback(runtime, target.handle.scopeId);
+  const compiledAfter = createScopeCompilerService(runtime).compileScopeById(target.handle.scopeId);
+  if (!changed || afterReadback?.text !== input.text) {
+    return {
+      status: "blocked",
+      applied: false,
+      changed,
+      target: summarizeTarget(
+        compiledAfter ? { ...target, scope: compiledAfter.scope, handle: compiledAfter.scope.handle } : target
+      ),
+      posture: "suspect-readback",
+      blockers: Object.freeze([
+        `actions:rewrite:marker-range-readback-mismatch:${target.handle.scopeId}`
+      ]),
+      blockerDetails: Object.freeze([
+        blocker(
+          `actions:rewrite:marker-range-readback-mismatch:${target.handle.scopeId}`,
+          "blocked",
+          ack.kind === "rejected" ? "The marker-backed rewrite command was rejected or did not produce the requested marker readback." : "The marker-backed rewrite command did not produce the requested marker readback.",
+          "Treat the mutation as suspect. Re-read the target and export before claiming success."
+        )
+      ]),
+      ...afterReadback ? { afterReadback } : {}
+    };
+  }
+  return {
+    status: "applied",
+    applied: true,
+    changed: true,
+    target: summarizeTarget(
+      compiledAfter ? { ...target, scope: compiledAfter.scope, handle: compiledAfter.scope.handle } : target
+    ),
+    commandReference: {
+      command: "text.insert",
+      actorId: input.actorId ?? "v3-ai-api",
+      origin: input.origin ?? "agent",
+      emittedAtUtc: currentAuditTimestamp(runtime)
+    },
+    beforeReadback,
+    afterReadback
+  };
+}
 function applyTableScopedMarkerRewrite(runtime, target, action, input) {
   const workflowScope = runtime.getScope(target.handle.scopeId);
+  const markerRange = buildScopePositionMap(runtime.getCanonicalDocument()).markerScopes.get(
+    target.handle.scopeId
+  );
   const editableTarget = tableEditableTargetForActionHandle(
     runtime,
     action.actionHandle
   );
-  if (!workflowScope || workflowScope.anchor.kind !== "range" || !editableTarget) {
+  if (!workflowScope || !markerRange || !editableTarget) {
     return blockedApply(
       `actions:rewrite:table-marker-target-unresolved:${target.handle.scopeId}`,
       "unresolved-target",
@@ -135423,19 +136832,23 @@ function applyTableScopedMarkerRewrite(runtime, target, action, input) {
       "Refresh placeholder scopes and retry; route persistent failures to L08 table scope target mapping."
     );
   }
+  const beforeReadback = markerScopeReadback(runtime, target.handle.scopeId) ?? {
+    text: target.scope.content.text,
+    isEmpty: target.scope.content.text.length === 0
+  };
   const before = runtime.getCanonicalDocument();
   try {
     runtime.dispatch({
       type: "selection.set",
       selection: {
-        anchor: workflowScope.anchor.from,
-        head: workflowScope.anchor.to,
-        isCollapsed: workflowScope.anchor.from === workflowScope.anchor.to,
+        anchor: markerRange.from,
+        head: markerRange.to,
+        isCollapsed: markerRange.from === markerRange.to,
         activeRange: {
           kind: "range",
-          from: workflowScope.anchor.from,
-          to: workflowScope.anchor.to,
-          assoc: workflowScope.anchor.assoc ?? { start: -1, end: 1 }
+          from: markerRange.from,
+          to: markerRange.to,
+          assoc: { start: -1, end: 1 }
         }
       },
       origin: actionOrigin(runtime, input)
@@ -135470,12 +136883,19 @@ function applyTableScopedMarkerRewrite(runtime, target, action, input) {
   );
   const afterText = paragraph ? collectInlineText4(paragraph.children) : void 0;
   const afterReadback = afterText === void 0 ? void 0 : { text: afterText, isEmpty: afterText.length === 0 };
-  if (!changed || afterReadback?.text !== input.text) {
+  const compiledAfter = createScopeCompilerService(runtime).compileScopeById(target.handle.scopeId);
+  const scopeReadback = markerScopeReadback(runtime, target.handle.scopeId) ?? (compiledAfter ? {
+    text: compiledAfter.scope.content.text,
+    isEmpty: compiledAfter.scope.content.text.length === 0
+  } : void 0);
+  if (!changed || scopeReadback?.text !== input.text) {
     return {
       status: "blocked",
       applied: false,
       changed,
-      target: summarizeTarget({ kind: "table-text", action }),
+      target: summarizeTarget(
+        compiledAfter ? { ...target, scope: compiledAfter.scope, handle: compiledAfter.scope.handle } : target
+      ),
       posture: "suspect-readback",
       blockers: Object.freeze([
         `actions:rewrite:table-marker-readback-mismatch:${target.handle.scopeId}`
@@ -135488,25 +136908,24 @@ function applyTableScopedMarkerRewrite(runtime, target, action, input) {
           "Treat the mutation as suspect. Re-read the target and export before claiming success."
         )
       ]),
-      ...afterReadback ? { afterReadback } : {}
+      ...scopeReadback ? { afterReadback: scopeReadback } : afterReadback ? { afterReadback } : {}
     };
   }
   return {
     status: "applied",
     applied: true,
     changed: true,
-    target: summarizeTarget({
-      kind: "table-text",
-      action: { ...action, readback: afterReadback }
-    }),
+    target: summarizeTarget(
+      compiledAfter ? { ...target, scope: compiledAfter.scope, handle: compiledAfter.scope.handle } : { kind: "table-text", action: { ...action, readback: scopeReadback } }
+    ),
     commandReference: {
       command: "text.insert",
       actorId: input.actorId ?? "v3-ai-api",
       origin: input.origin ?? "agent",
       emittedAtUtc: currentAuditTimestamp(runtime)
     },
-    ...action.readback ? { beforeReadback: action.readback } : {},
-    afterReadback
+    beforeReadback,
+    afterReadback: scopeReadback
   };
 }
 function projectRewriteScopeResult(runtime, result, target, beforeText, proposedText, documentMutated) {
@@ -135600,7 +137019,7 @@ function summarizeTarget(target) {
   if (target.kind === "editable-text") {
     return {
       kind: target.targetKind,
-      handle: target.ownerHandle,
+      handle: publicActionScopeHandle(target.ownerHandle),
       actionHandle: target.actionHandle,
       readback: target.readback,
       canRewriteText: true,
@@ -135611,13 +137030,21 @@ function summarizeTarget(target) {
   }
   return {
     kind: target.scope.kind,
-    handle: target.handle,
+    handle: publicActionScopeHandle(target.handle),
     canRewriteText: canRewriteScopeText(target.scope),
     canInsertAdjacentText: canInsertAdjacentScopeText(target.scope),
     canFlag: true,
     canMark: canMarkScope(target.scope)
   };
 }
+function publicActionScopeHandle(handle) {
+  const parentScopeId = handle.parentScopeId;
+  if (!parentScopeId || !/^(cell|table|row|column|span):/u.test(parentScopeId)) {
+    return handle;
+  }
+  const { parentScopeId: _parentScopeId, ...rest } = handle;
+  return rest;
+}
 function tableTextActionsForScope(runtime, handle) {
   const result = createTableActionFamily(runtime).listTableActions({
     handle,
@@ -135670,6 +137097,13 @@ function tableEditableTargetForActionHandle(runtime, actionHandle) {
   }
   return null;
 }
+function markerScopeReadback(runtime, scopeId) {
+  const document2 = runtime.getCanonicalDocument();
+  const range = buildScopePositionMap(document2).markerScopes.get(scopeId);
+  if (!range) return null;
+  const text = textForCanonicalRange(document2, range.from, range.to);
+  return { text, isEmpty: text.length === 0 };
+}
 function editableTextActionsForScope(runtime, handle) {
   const bundle = createScopeCompilerService(runtime).compileBundleById(
     handle.scopeId,
@@ -137022,6 +138456,86 @@ function blockTextLength(block) {
       return 0;
   }
 }
+function textForCanonicalRange(document2, from, to) {
+  let cursor = 0;
+  let text = "";
+  const append = (value, start, end) => {
+    const clippedFrom = Math.max(from, start);
+    const clippedTo = Math.min(to, end);
+    if (clippedTo <= clippedFrom) return;
+    const localFrom = clippedFrom - start;
+    const localTo = clippedTo - start;
+    text += Array.from(value).slice(localFrom, localTo).join("");
+  };
+  const walkInline = (inline) => {
+    const start = cursor;
+    switch (inline.type) {
+      case "text": {
+        const length = Array.from(inline.text).length;
+        cursor += length;
+        append(inline.text, start, cursor);
+        return length;
+      }
+      case "tab":
+        cursor += 1;
+        append("	", start, cursor);
+        return 1;
+      case "hard_break":
+        cursor += 1;
+        append("\n", start, cursor);
+        return 1;
+      case "hyperlink":
+      case "field": {
+        const before = cursor;
+        for (const child of inline.children) {
+          walkInline(child);
+        }
+        return cursor - before;
+      }
+      case "bookmark_start":
+      case "bookmark_end":
+      case "scope_marker_start":
+      case "scope_marker_end":
+        return 0;
+      default:
+        cursor += 1;
+        return 1;
+    }
+  };
+  const walkBlock = (block) => {
+    if (!block) return 0;
+    const before = cursor;
+    switch (block.type) {
+      case "paragraph":
+        for (const child of block.children) walkInline(child);
+        break;
+      case "table":
+        for (const row2 of block.rows) {
+          for (const cell of row2.cells) {
+            for (const child of cell.children) walkBlock(child);
+          }
+        }
+        break;
+      case "sdt":
+      case "custom_xml":
+        for (const child of block.children) walkBlock(child);
+        break;
+      default:
+        cursor += 1;
+        break;
+    }
+    return cursor - before;
+  };
+  const blocks = document2.content.children;
+  for (let index = 0; index < blocks.length; index += 1) {
+    walkBlock(blocks[index]);
+    if (index < blocks.length - 1 && blocks[index + 1]?.type === "paragraph") {
+      cursor += 1;
+      append("\n", cursor - 1, cursor);
+    }
+  }
+  return text;
+}
 function inlineTextLength(inline) {
   if (!inline) return 0;
   switch (inline.type) {
@@ -137177,6 +138691,109 @@ function summarizePlanResult(mode, steps) {
   };
 }
 
+// src/api/v3/ai/agent.ts
+function createAgentFamily(runtime, pe2Evidence) {
+  const inspect = createInspectFamily(runtime, pe2Evidence);
+  const resolve = createResolveFamily(runtime);
+  const bundle = createBundleFamily(runtime, pe2Evidence);
+  const actions2 = createActionsFamily(runtime).actions;
+  const table = createTableActionFamily(runtime);
+  const object = createObjectActionFamily(runtime);
+  const policy = createPolicyFamily(runtime);
+  const evaluate = createEvaluateFamily(runtime);
+  const outline = createOutlineFamily(runtime);
+  const stats = createStatsFamily(runtime);
+  const explain = createExplainFamily(runtime);
+  const review = createReviewFamily2(runtime);
+  const exportFamily = createExportFamily(runtime);
+  const read = Object.freeze({
+    inspectDocument: inspect.inspectDocument,
+    listScopes: inspect.listScopes,
+    getScope: bundle.getScope,
+    getScopeBundle: bundle.getScopeBundle,
+    resolveReference: resolve.resolveReference,
+    queryScopeAtPosition: resolve.queryScopeAtPosition,
+    queryScopeInRange: resolve.queryScopeInRange,
+    brief: actions2.brief,
+    getDocumentOutline: outline.getDocumentOutline,
+    getDocumentStatistics: stats.getDocumentStatistics,
+    explainFormatting: explain.explainFormatting
+  });
+  const target = Object.freeze({
+    discover: actions2.discover,
+    locate: actions2.locate,
+    locateAll: actions2.locateAll,
+    createPlaceholderScopes: actions2.createPlaceholderScopes
+  });
+  const edit = Object.freeze({
+    rewrite: actions2.rewrite,
+    runPlan: actions2.runPlan,
+    insertText: actions2.insertText,
+    mark: actions2.mark,
+    flag: actions2.flag,
+    flagMany: actions2.flagMany,
+    fieldRefresh: actions2.fieldRefresh,
+    tocRefresh: actions2.tocRefresh,
+    bookmarkEdit: actions2.bookmarkEdit,
+    hyperlinkDestinationEdit: actions2.hyperlinkDestinationEdit,
+    hyperlinkTextEdit: actions2.hyperlinkTextEdit
+  });
+  const template = Object.freeze({
+    validateTargets: actions2.validateTemplateTargets,
+    readTarget: actions2.templateTargetRead,
+    fillField: actions2.templateFieldFill
+  });
+  const tableGroup = Object.freeze({
+    replaceContent: actions2.tableContent,
+    applyFragment: actions2.tableFragment,
+    applySelection: actions2.tableSelection,
+    listActions: table.listTableActions,
+    applyAction: table.applyTableAction
+  });
+  const list = Object.freeze({
+    applyOperation: actions2.listOperation
+  });
+  const objectGroup = Object.freeze({
+    listActions: object.listObjectActions,
+    applyAction: object.applyObjectAction
+  });
+  const reviewGroup = Object.freeze({
+    acceptRevision: review.acceptRevision,
+    rejectRevision: review.rejectRevision,
+    resolveCommentThread: review.resolveCommentThread,
+    resolveIssue: review.resolveIssue,
+    reopenIssue: review.reopenIssue
+  });
+  const policyGroup = Object.freeze({
+    getPolicy: policy.getPolicy,
+    listActions: policy.listAIActions,
+    evaluateAction: evaluate.evaluateAction
+  });
+  const exportGroup = Object.freeze({
+    reviewedDocument: exportFamily.exportReviewedDocument
+  });
+  const category = Object.freeze({
+    read,
+    target,
+    edit,
+    template,
+    table: tableGroup,
+    list,
+    object: objectGroup,
+    review: reviewGroup,
+    policy: policyGroup,
+    export: exportGroup
+  });
+  const family = {
+    agent() {
+      return category;
+    }
+  };
+  return {
+    agent: family.agent()
+  };
+}
+
 // src/api/v3/_create.ts
 function createApiV3(handle, opts) {
   const ai = {
@@ -137194,7 +138811,8 @@ function createApiV3(handle, opts) {
     ...createOutlineFamily(handle),
     ...createTableActionFamily(handle),
     ...createObjectActionFamily(handle),
-    ...createActionsFamily(handle)
+    ...createActionsFamily(handle),
+    ...createAgentFamily(handle, opts?.pe2Evidence)
   };
   const runtime = {
     document: createDocumentFamily(handle),