@agent-native/core 0.184.0 → 0.184.1-nightly-20260922211241

package/corpus/templates/content/docs/product/capabilities/content.knowledge.search.md

@@ -59,7 +59,7 @@ Given a stale connected Source result, when it appears, then its freshness state
 
 ## Current evidence
 
-Existing search paths are in progress donor substrate, but complete indexed, freshness, ranking, and agent-parity proof is incomplete. This Capability remains `in_progress`.
+Existing search paths are in progress donor substrate, but complete indexed, freshness, and agent-parity proof is incomplete. This Capability remains `in_progress`.
 
 The command picker uses the shared paginated search Action, with title-only,
 document-type and modified-date predicates applied before pagination. Parent
@@ -67,13 +67,16 @@ context is independently access-scoped. The query supports a bounded
 Google-style operator set: quoted "exact phrases", `-excludedTerm`,
 uppercase `OR` between terms, `intitle:term`, and implicit AND across bare
 words; `%`, `_`, and `*` stay literal, and an all-workspaces scope option
-omits the space filter while keeping server-side access scoping. Snippet
-windows anchor at the first in-body occurrence of the first match needle,
-so deep-body matches show their own context. Focused
-tests cover later pages, private-parent suppression, hidden-result counts,
-type filters, and each operator. This is bounded lexical search substrate,
-not proof of indexed retrieval across every Source, authoritative author
-filtering, ranking, or policy-governed global search.
+omits the space filter while keeping server-side access scoping. Search ranks
+the complete authorized match set before pagination. Exact and contiguous
+partial titles form protected tiers above title-word, description, and body
+matches; modification time only breaks otherwise equal results. Snippet windows
+prefer context containing more positive terms. Focused tests cover later pages,
+private-parent suppression, hidden-result counts, title tiers, useful snippets,
+type filters, and each operator. A 10,000-document PGlite benchmark covers the
+current warm-query budget. This is bounded lexical search substrate, not proof
+of indexed retrieval across every Source, authoritative author filtering,
+freshness ranking, or policy-governed global search.
 
 Local browser verification of the command picker covered 27 authorized matches
 across two result pages, equal-title parent context, keyboard opening, title/body

package/corpus/templates/design/.generated/bridge/editor-chrome.generated.ts

@@ -2539,6 +2539,13 @@ export const editorChromeBridgeScript: string = `"use strict";
       }
       return containerScopeAncestor(resolved, scope);
     }
+    function plainClickSelectionTarget(hit) {
+      if (!designCanvasBoardSurface) {
+        selectionContainerScope = null;
+        return selectionTargetForHit(hit);
+      }
+      return containerFirstSelectionTarget(hit);
+    }
     function clickThroughSelectionTarget(hit, ev) {
       if (ev.detail > 1) return null;
       if (!selectedEl || !document.documentElement.contains(selectedEl)) {
@@ -8247,7 +8254,7 @@ export const editorChromeBridgeScript: string = `"use strict";
         return;
       }
       hoveredSpacingHandleKey = "";
-      var resolvedClickTarget = e.metaKey || e.ctrlKey ? selectionTargetForHit(target) : containerFirstSelectionTarget(target);
+      var resolvedClickTarget = e.metaKey || e.ctrlKey ? selectionTargetForHit(target) : plainClickSelectionTarget(target);
       var toggled = resolveShiftClickToggleOff(resolvedClickTarget, e);
       if (toggled !== void 0) {
         postToggledSelection(toggled);
@@ -16258,7 +16265,7 @@ export const editorChromeBridgeScript: string = `"use strict";
         }
         if (ev) stopNativeInteraction(ev);
         var cycledEl = !readOnly && (e.metaKey || e.ctrlKey) && !e.shiftKey ? stackCycleTarget(e.clientX, e.clientY, selectedEl) : null;
-        var primaryClickTarget = !readOnly && (e.metaKey || e.ctrlKey) ? selectionTargetForHit(hit) : (!readOnly && !e.shiftKey ? clickThroughSelectionTarget(hit, ev) : null) || containerFirstSelectionTarget(hit);
+        var primaryClickTarget = !readOnly && (e.metaKey || e.ctrlKey) ? selectionTargetForHit(hit) : !designCanvasBoardSurface ? plainClickSelectionTarget(hit) : (!readOnly && !e.shiftKey ? clickThroughSelectionTarget(hit, ev) : null) || containerFirstSelectionTarget(hit);
         if (cycledEl) {
           selectTarget(cycledEl, ev, true);
         } else {
@@ -17205,7 +17212,7 @@ export const editorChromeBridgeScript: string = `"use strict";
     var lastHoverClientPoint = null;
     function resolveHoverTarget(clientX, clientY, deepSelect) {
       var rawHit = elementFromEditorPoint(clientX, clientY);
-      return deepSelect ? selectionTargetForHit(rawHit) : containerFirstSelectionTarget(rawHit);
+      return deepSelect || !designCanvasBoardSurface ? selectionTargetForHit(rawHit) : containerFirstSelectionTarget(rawHit);
     }
     function reresolveHoverAtLastPoint(deepSelect) {
       if (!lastHoverClientPoint) return;

package/corpus/templates/design/.generated/bridge/nav.generated.ts

@@ -28,6 +28,7 @@ export const navBridgeScript: string = `"use strict";
         if (!t || !t.closest) return;
         var a = t.closest("a[href], [data-screen]");
         if (!a) return;
+        if (e.metaKey || e.ctrlKey || e.shiftKey || e.button !== 0) return;
         var ds = a.getAttribute && a.getAttribute("data-screen");
         if (!ds) {
           var rawHref = a.getAttribute("href");

package/corpus/templates/design/app/components/design/MultiScreenCanvas.tsx

@@ -294,7 +294,9 @@ import {
   getBoardSurfaceHtml,
   getBoardSurfaceRenderContent,
   getBoardSurfaceStaticPreviewContent,
+  hasBoardRuntimeSurfaceContent,
   hasBoardSurfaceContent,
+  shouldMountBoardSurface,
   shouldRenderEmptyBoardReviewCanvas,
 } from "./multi-screen/board-surface-html";
 import {
@@ -663,6 +665,7 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
   boardIsActive = false,
   boardRuntimeStructureInsertRequest,
   boardRuntimeStructureRollbackRequest,
+  runtimeStructurePendingTransactionRef,
   onBoardRuntimeStructureInsertRejected,
   onBoardRuntimeStructureInsertApplied,
   onBoardRuntimeStructureRollbackResult,
@@ -729,6 +732,51 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
   // before the first layout measurement.
   const [surfaceSize, setSurfaceSize] = useState({ width: 0, height: 0 });
   const [crossScreenDragActive, setCrossScreenDragActive] = useState(false);
+  const [boardRuntimeSurfaceActive, setBoardRuntimeSurfaceActive] = useState<
+    string | null
+  >(null);
+  const boardCrossScreenDropPendingRef = useRef(false);
+  const boardCrossScreenDropTransactionRef = useRef<string | null>(null);
+  const boardCrossScreenDropTimeoutTransactionRef = useRef<string | null>(null);
+  const boardCrossScreenDropTimeoutRef = useRef<number | null>(null);
+  const onBoardRuntimeStructureInsertRejectedRef = useRef(
+    onBoardRuntimeStructureInsertRejected,
+  );
+  onBoardRuntimeStructureInsertRejectedRef.current =
+    onBoardRuntimeStructureInsertRejected;
+  const finishBoardCrossScreenDrop = useCallback(
+    (options?: { preserveTransaction?: boolean; force?: boolean }) => {
+      if (!boardCrossScreenDropPendingRef.current && !options?.force) return;
+      boardCrossScreenDropPendingRef.current = false;
+      if (boardCrossScreenDropTimeoutRef.current !== null) {
+        window.clearTimeout(boardCrossScreenDropTimeoutRef.current);
+        boardCrossScreenDropTimeoutRef.current = null;
+      }
+      boardCrossScreenDropTimeoutTransactionRef.current = null;
+      if (!options?.preserveTransaction) {
+        boardCrossScreenDropTransactionRef.current = null;
+      }
+      setCrossScreenDragActive(false);
+    },
+    [],
+  );
+  useEffect(() => {
+    const transactionId = boardRuntimeStructureInsertRequest?.transactionId;
+    if (!transactionId || !boardCrossScreenDropPendingRef.current) return;
+    boardCrossScreenDropTransactionRef.current = transactionId;
+  }, [boardRuntimeStructureInsertRequest]);
+  useEffect(
+    () => () => {
+      if (boardCrossScreenDropTimeoutRef.current !== null) {
+        window.clearTimeout(boardCrossScreenDropTimeoutRef.current);
+      }
+    },
+    [],
+  );
+  const [boardRuntimeSurfaceState, setBoardRuntimeSurfaceState] = useState<{
+    boardFileId: string | null;
+    requestKeys: string[];
+  }>({ boardFileId: null, requestKeys: [] });
   const [frameGeometry, setFrameGeometry] = useState<FrameGeometryById>({});
   const frameGeometryRef = useRef(frameGeometry);
   const renderedScreenIdsRef = useRef<Set<string>>(new Set());
@@ -896,12 +944,70 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
   const boardFrameGeometryRef = useRef(boardFrameGeometry);
   boardFrameGeometryRef.current = boardFrameGeometry;
   // Keep the empty board unmounted during normal editing so the text/shape
-  // creation path can still own its first mount. Mount it for the duration of
-  // a cross-screen drag so the drop has a real DOM target before release.
-  const boardSurfaceHtml =
-    crossScreenDragActive || hasBoardSurfaceContent(boardFileContent)
-      ? getBoardSurfaceHtml(boardFileContent)
-      : undefined;
+  // creation path can still own its first mount. Mount it for a cross-screen
+  // drag and keep it through the runtime insert acknowledgement.
+  const handleBoardRuntimeStructureInsertApplied = useCallback(
+    (details: {
+      requestId: string;
+      transactionId?: string;
+      routePath?: string;
+      selector: string;
+      sourceId?: string;
+      applied?: boolean;
+    }) => {
+      if (details.applied !== false && details.selector && boardFileId) {
+        const requestKey = details.transactionId ?? details.requestId;
+        setBoardRuntimeSurfaceState((current) => {
+          const base =
+            current.boardFileId === boardFileId
+              ? current
+              : { boardFileId, requestKeys: [] };
+          return base.requestKeys.includes(requestKey)
+            ? base
+            : { ...base, requestKeys: [...base.requestKeys, requestKey] };
+        });
+      }
+      onBoardRuntimeStructureInsertApplied?.(details);
+    },
+    [boardFileId, onBoardRuntimeStructureInsertApplied],
+  );
+  const handleBoardRuntimeStructureRollbackResult = useCallback(
+    (details: {
+      requestId: string;
+      transactionId?: string;
+      applied: boolean;
+      reason?: string;
+    }) => {
+      if (details.applied && details.transactionId && boardFileId) {
+        setBoardRuntimeSurfaceState((current) => {
+          if (current.boardFileId !== boardFileId) return current;
+          const requestKeys = current.requestKeys.filter(
+            (key) => key !== details.transactionId,
+          );
+          return requestKeys.length > 0
+            ? { ...current, requestKeys }
+            : { boardFileId: null, requestKeys: [] };
+        });
+      }
+      onBoardRuntimeStructureRollbackResult?.(details);
+    },
+    [boardFileId, onBoardRuntimeStructureRollbackResult],
+  );
+  const boardSurfaceHtml = shouldMountBoardSurface({
+    hasAuthoredContent: hasBoardSurfaceContent(boardFileContent),
+    crossScreenDragActive,
+    hasPendingRuntimeInsert: Boolean(boardRuntimeStructureInsertRequest),
+    hasPendingRuntimeRollback: Boolean(boardRuntimeStructureRollbackRequest),
+    runtimeContentBoardId: boardRuntimeSurfaceActive,
+    boardFileId,
+    hasRuntimeContent: hasBoardRuntimeSurfaceContent({
+      boardFileId,
+      runtimeBoardFileId: boardRuntimeSurfaceState.boardFileId,
+      runtimeRequestKeys: boardRuntimeSurfaceState.requestKeys,
+    }),
+  })
+    ? getBoardSurfaceHtml(boardFileContent)
+    : undefined;
   const boardHasSurfaceContent = boardSurfaceHtml !== undefined;
   const boardReviewGeometry = boardSurfaceRenderGeometry ?? {
     x: 0,
@@ -2713,7 +2819,7 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
       );
     };
 
-    const clearCrossScreenDrag = () => {
+    const clearCrossScreenDrag = (options?: { keepBoardMounted?: boolean }) => {
       crossScreenPreviewGenerationRef.current += 1;
       stopParentCrossScreenDrag();
       // The parent key listeners can be removed before a held Control keyup
@@ -2734,7 +2840,10 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
       clearCrossScreenDropGuide();
       crossScreenTargetRef.current = null;
       crossScreenDragMsgRef.current = null;
-      setCrossScreenDragActive(false);
+      if (!options?.keepBoardMounted) {
+        finishBoardCrossScreenDrop();
+        setCrossScreenDragActive(false);
+      }
       // A cancelled/blurred drag must not donate its last board coordinate to
       // the next gesture. In particular, a second drag can emit start -> end
       // without an out-of-iframe move; retaining the previous point would make
@@ -3232,14 +3341,19 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
         ignoreAutoLayout: ignoreAutoLayoutAtRelease,
       };
       crossScreenEndSeenRef.current = true;
-      clearCrossScreenDrag();
       const dropSeq = crossScreenDropSeqRef.current;
       const isCurrentDrop = () =>
         canvasMountedRef.current && crossScreenDropSeqRef.current === dropSeq;
       crossScreenLastBoardPointRef.current = null;
       const hasIdentifier = !!(payload.selector || payload.sourceId);
-      if (!hasIdentifier || !sourceScreenId) return;
-      if (!lastBoardPoint) return;
+      if (!hasIdentifier || !sourceScreenId) {
+        clearCrossScreenDrag();
+        return;
+      }
+      if (!lastBoardPoint) {
+        clearCrossScreenDrag();
+        return;
+      }
       // No candidate means the pointer never left the source screen, so the
       // bridge already handled it as an in-place reorder. Falling back to the
       // board here re-persists the move against a file that does not contain
@@ -3252,7 +3366,10 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
         lastBoardPoint.x <= sourceFrameGeometry.x + sourceFrameGeometry.width &&
         lastBoardPoint.y >= sourceFrameGeometry.y &&
         lastBoardPoint.y <= sourceFrameGeometry.y + sourceFrameGeometry.height;
-      if (droppedInsideSourceScreen) return;
+      if (droppedInsideSourceScreen) {
+        clearCrossScreenDrag();
+        return;
+      }
       trace("drop", "finalize", {
         candidate: candidate?.id ?? null,
         sourceScreen: sourceScreenId,
@@ -3280,9 +3397,47 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
           sourceScreen: sourceScreenId,
           lastBoardPoint,
         });
+        clearCrossScreenDrag();
         return;
       }
       crossScreenHostCommittedRef.current = true;
+      if (targetCandidate.id === boardFileId) {
+        // A successful prior handoff retains its identity until the paired
+        // source-delete/rollback settles. A new handoff must not let a late
+        // acknowledgement for that prior transaction settle this one.
+        boardCrossScreenDropTransactionRef.current = null;
+        boardCrossScreenDropPendingRef.current = true;
+        boardCrossScreenDropTimeoutTransactionRef.current = null;
+        if (boardCrossScreenDropTimeoutRef.current !== null) {
+          window.clearTimeout(boardCrossScreenDropTimeoutRef.current);
+        }
+        const expireBoardCrossScreenDrop = () => {
+          if (!boardCrossScreenDropPendingRef.current) return;
+          // A late hit-test must not create a new runtime request after the
+          // host has cancelled this handoff. Once a runtime request exists,
+          // its iframe ack/reject path owns settlement and clears this timer.
+          crossScreenDropSeqRef.current += 1;
+          const transactionId =
+            boardCrossScreenDropTimeoutTransactionRef.current;
+          if (
+            transactionId &&
+            boardCrossScreenDropTransactionRef.current === transactionId
+          ) {
+            onBoardRuntimeStructureInsertRejectedRef.current?.(
+              "board-drop-timeout",
+              transactionId,
+            );
+            return;
+          }
+          finishBoardCrossScreenDrop();
+        };
+        boardCrossScreenDropTimeoutRef.current = window.setTimeout(() => {
+          expireBoardCrossScreenDrop();
+        }, HIT_TEST_COMMIT_TIMEOUT_MS + 1000);
+      }
+      clearCrossScreenDrag({
+        keepBoardMounted: targetCandidate.id === boardFileId,
+      });
 
       if (targetCandidate.id === boardFileId) {
         void runHitTest(targetCandidate, lastBoardPoint, {
@@ -3303,6 +3458,8 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
             const hasAnchor = Boolean(
               anchorNodeId || pendingNodeId || anchorSelector,
             );
+            const transactionBeforeDrop =
+              runtimeStructurePendingTransactionRef?.current ?? null;
             onCrossScreenElementDropRef.current?.({
               sourceSelector: payload.selector,
               sourceNodeId: payload.sourceId,
@@ -3334,6 +3491,22 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
               styleSnapshot: payload.styleSnapshot,
               styleSnapshotCaptureFailed: payload.styleSnapshotCaptureFailed,
             });
+            const transactionAfterDrop =
+              runtimeStructurePendingTransactionRef?.current ?? null;
+            if (
+              transactionAfterDrop &&
+              transactionAfterDrop !== transactionBeforeDrop
+            ) {
+              boardCrossScreenDropTransactionRef.current = transactionAfterDrop;
+              boardCrossScreenDropTimeoutTransactionRef.current =
+                transactionAfterDrop;
+            } else {
+              // A refused transaction must not leave a timer that can later
+              // reject an unrelated runtime request.
+              finishBoardCrossScreenDrop({
+                preserveTransaction: transactionBeforeDrop !== null,
+              });
+            }
           },
         );
         return;
@@ -3482,7 +3655,9 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
         if (!crossScreenEndSeenRef.current) {
           crossScreenDropSeqRef.current += 1;
         }
-        clearCrossScreenDrag();
+        clearCrossScreenDrag({
+          keepBoardMounted: boardCrossScreenDropPendingRef.current,
+        });
         return;
       }
 
@@ -4004,11 +4179,13 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
     boardFileId,
     boardFrameGeometry,
     boardSurfaceRenderGeometry,
+    finishBoardCrossScreenDrop,
     getFrameEntryAtPoint,
     getFrameViewportSize,
     getCanvasPoint,
     getResolvedMetadata,
     onCrossScreenElementDrop,
+    runtimeStructurePendingTransactionRef,
   ]);
 
   // Unmount only — deliberately NOT part of the message effect's cleanup
@@ -10735,15 +10912,66 @@ export const MultiScreenCanvas = memo(function MultiScreenCanvas({
                   runtimeStructureRollbackRequest={
                     boardRuntimeStructureRollbackRequest
                   }
-                  onRuntimeStructureInsertRejected={
-                    onBoardRuntimeStructureInsertRejected
-                  }
-                  onRuntimeStructureInsertApplied={
-                    onBoardRuntimeStructureInsertApplied
-                  }
-                  onRuntimeStructureRollbackResult={
-                    onBoardRuntimeStructureRollbackResult
-                  }
+                  onRuntimeStructureInsertRejected={(reason, transactionId) => {
+                    const rollbackScheduled =
+                      onBoardRuntimeStructureInsertRejected?.(
+                        reason,
+                        transactionId,
+                      ) === true;
+                    const expectedTransactionId =
+                      boardCrossScreenDropTransactionRef.current;
+                    if (
+                      !expectedTransactionId ||
+                      !transactionId ||
+                      expectedTransactionId !== transactionId
+                    ) {
+                      return;
+                    }
+                    if (reason === "board-drop-timeout") {
+                      // Keep the board iframe mounted until the host's
+                      // rollback request settles. The insert acknowledgement
+                      // may have been lost after the bridge mutated the DOM.
+                      if (!rollbackScheduled) {
+                        setBoardRuntimeSurfaceActive(null);
+                        finishBoardCrossScreenDrop();
+                      }
+                      return;
+                    }
+                    setBoardRuntimeSurfaceActive(null);
+                    finishBoardCrossScreenDrop();
+                  }}
+                  onRuntimeStructureInsertApplied={(details) => {
+                    const expectedTransactionId =
+                      boardCrossScreenDropTransactionRef.current;
+                    if (
+                      !expectedTransactionId ||
+                      !details.transactionId ||
+                      expectedTransactionId !== details.transactionId
+                    ) {
+                      handleBoardRuntimeStructureInsertApplied(details);
+                      return;
+                    }
+                    if (details.applied !== false) {
+                      setBoardRuntimeSurfaceActive(boardFileId ?? null);
+                    }
+                    handleBoardRuntimeStructureInsertApplied(details);
+                    finishBoardCrossScreenDrop({ preserveTransaction: true });
+                  }}
+                  onRuntimeStructureRollbackResult={(details) => {
+                    const expectedTransactionId =
+                      boardCrossScreenDropTransactionRef.current;
+                    if (
+                      !expectedTransactionId ||
+                      !details.transactionId ||
+                      expectedTransactionId !== details.transactionId
+                    ) {
+                      handleBoardRuntimeStructureRollbackResult(details);
+                      return;
+                    }
+                    if (details.applied) setBoardRuntimeSurfaceActive(null);
+                    handleBoardRuntimeStructureRollbackResult(details);
+                    finishBoardCrossScreenDrop({ force: true });
+                  }}
                   clearSelectionRequest={boardClearSelectionRequest}
                   selectedSelector={boardSelectedSelector ?? null}
                   selectedSelectorCandidates={

package/corpus/templates/design/app/components/design/bridge/nav.bridge.ts

@@ -11,6 +11,13 @@
  *   - internal/relative links (or an explicit `data-screen`): asked to switch
  *     to the matching screen in a multi-screen design; otherwise a no-op so the
  *     prototype never blows itself away.
+ *   - Cmd/Ctrl/Shift-click and middle-click on a real `<a href>`: left
+ *     completely alone so the browser's own new-tab/new-window gesture runs
+ *     (see the modifier-click guard below). A screen switch is a same-tab
+ *     mutation of the live editor's mode/selection state; forcing it on a
+ *     click whose entire point was "don't disturb my current tab" corrupts
+ *     that state instead of opening a new one, which is what produced the
+ *     Interact-mode crash this guard fixes.
  *
  * Protocol (iframe → parent):
  *
@@ -47,6 +54,15 @@
       if (!t || !t.closest) return;
       var a = t.closest("a[href], [data-screen]") as HTMLElement | null;
       if (!a) return;
+      // Cmd/Ctrl-click (new tab), Shift-click (new window), and middle-click
+      // are the browser's own "open this somewhere else, leave my tab alone"
+      // gestures. Forcing our same-tab screen-switch/postMessage path on top
+      // of one of these ignores that intent and mutates the live editor's
+      // mode/selection state on a click the user never meant to touch the
+      // current tab with. Step aside entirely and let the browser (or, for a
+      // `data-screen`-only element with no real destination, simply nothing)
+      // handle it instead.
+      if (e.metaKey || e.ctrlKey || e.shiftKey || e.button !== 0) return;
       var ds = a.getAttribute && a.getAttribute("data-screen");
       // In-page anchors ('#...') and empty hrefs must be handled in-document.
       // A srcdoc document resolves '#'/'' against the PARENT app URL, so the

package/corpus/templates/design/app/components/design/multi-screen/board-surface-html.ts

@@ -17,6 +17,38 @@ export function getBoardSurfaceHtml(html: string | undefined) {
   return hasBoardSurfaceContent(html) ? html : EMPTY_BOARD_SURFACE_HTML;
 }
 
+export function shouldMountBoardSurface(args: {
+  hasAuthoredContent: boolean;
+  crossScreenDragActive: boolean;
+  hasPendingRuntimeInsert: boolean;
+  hasPendingRuntimeRollback?: boolean;
+  hasRuntimeContent?: boolean;
+  runtimeContentBoardId?: string | null;
+  boardFileId?: string;
+}): boolean {
+  return (
+    args.hasAuthoredContent ||
+    args.crossScreenDragActive ||
+    args.hasPendingRuntimeInsert ||
+    Boolean(args.hasPendingRuntimeRollback) ||
+    Boolean(args.hasRuntimeContent) ||
+    (args.runtimeContentBoardId != null &&
+      args.runtimeContentBoardId === args.boardFileId)
+  );
+}
+
+export function hasBoardRuntimeSurfaceContent(args: {
+  boardFileId?: string;
+  runtimeBoardFileId: string | null;
+  runtimeRequestKeys: readonly string[];
+}): boolean {
+  return (
+    args.boardFileId !== undefined &&
+    args.runtimeBoardFileId === args.boardFileId &&
+    args.runtimeRequestKeys.length > 0
+  );
+}
+
 export function shouldRenderEmptyBoardReviewCanvas(args: {
   hasSurfaceContent: boolean;
   reviewPinMode: boolean;

package/corpus/templates/design/app/components/design/multi-screen/types.ts

@@ -10,7 +10,7 @@ import type { LayoutGridById } from "@shared/layout-grid";
 import type { PenCuspLatch, PenPath } from "@shared/pen-path";
 import type { SourceNodeProvenance } from "@shared/preview-source-provenance";
 import type { VectorEndpointStyle } from "@shared/vector-endpoints";
-import type { ReactNode } from "react";
+import type { ReactNode, RefObject } from "react";
 
 import type {
   IframeContextMenuPayload,
@@ -508,10 +508,12 @@ export interface MultiScreenCanvasProps {
         screenId: string;
       })
     | null;
+  /** Shared admission lock used to associate a board timeout with its transaction. */
+  runtimeStructurePendingTransactionRef?: RefObject<string | null>;
   onBoardRuntimeStructureInsertRejected?: (
     reason: string,
     transactionId?: string,
-  ) => void;
+  ) => boolean | void;
   onBoardRuntimeStructureInsertApplied?: (details: {
     requestId: string;
     transactionId?: string;

package/corpus/templates/design/app/pages/design-editor/commands/cross-screen-element-drop.ts

@@ -150,6 +150,7 @@ export interface CrossScreenElementDropArgs {
   clearPendingHistory?: () => void;
   syncUndoRedoState?: () => void;
   runtimeStructureInsertRevisionRef: RefObject<number>;
+  runtimeStructurePendingTransactionRef?: RefObject<string | null>;
   sendRuntimeLayerMoveSemanticHandoff: (
     subjectLayerId: string,
     targetLayerId: string,
@@ -201,6 +202,7 @@ export function runCrossScreenElementDrop(
     clearPendingHistory,
     syncUndoRedoState,
     runtimeStructureInsertRevisionRef,
+    runtimeStructurePendingTransactionRef,
     sendRuntimeLayerMoveSemanticHandoff,
     setActiveFileId,
     setCreatedOverviewLayerSelection,
@@ -406,6 +408,18 @@ export function runCrossScreenElementDrop(
   if (!canEditDesign && !canEditLiveCrossScreen && !canEditLiveBoardDrop)
     return;
 
+  const beginRuntimeStructureTransaction = () => {
+    if (runtimeStructurePendingTransactionRef?.current) {
+      toast.error(t("designEditor.toasts.layerMoveFailed"), { duration: 4000 });
+      return null;
+    }
+    const transactionId = `cross-screen-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    if (runtimeStructurePendingTransactionRef) {
+      runtimeStructurePendingTransactionRef.current = transactionId;
+    }
+    return transactionId;
+  };
+
   // Duplicate intent must be resolved before live/semantic move routing. A
   // fresh clone cannot resolve to a source owner, so those paths would reject
   // the copy or treat it as a move without consuming sourceCloneHtml.
@@ -475,7 +489,8 @@ export function runCrossScreenElementDrop(
       });
       return;
     }
-    const transactionId = `cross-screen-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    const transactionId = beginRuntimeStructureTransaction();
+    if (!transactionId) return;
     runtimeStructureInsertRevisionRef.current += 1;
     setRuntimeStructureInsertRequest({
       requestId: runtimeStructureInsertRevisionRef.current,
@@ -558,9 +573,12 @@ export function runCrossScreenElementDrop(
         });
         return;
       }
+      const transactionId = beginRuntimeStructureTransaction();
+      if (!transactionId) return;
       runtimeStructureInsertRevisionRef.current += 1;
       setRuntimeStructureInsertRequest({
         requestId: runtimeStructureInsertRevisionRef.current,
+        transactionId,
         screenId: targetScreenId,
         sourceScreenId,
         remintCollidingNodeIds: true,
@@ -834,9 +852,12 @@ export function runCrossScreenElementDrop(
       });
       return;
     }
+    const transactionId = beginRuntimeStructureTransaction();
+    if (!transactionId) return;
     runtimeStructureInsertRevisionRef.current += 1;
     setRuntimeStructureInsertRequest({
       requestId: runtimeStructureInsertRevisionRef.current,
+      transactionId,
       screenId: targetScreenId,
       sourceScreenId,
       remintCollidingNodeIds: true,

package/corpus/templates/design/changelog/2026-09-22-apps-start-with-an-app-shaped-skeleton-while-session-data-lo.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-22
+---
+
+Apps start with an app-shaped skeleton while session data loads immediately.

package/corpus/templates/design/changelog/2026-09-22-blocks-can-be-selected-with-one-click-inside-screens.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-22
+---
+
+Blocks can be selected with one click inside screens

package/corpus/templates/design/e2e/drag-and-drop.shared.ts

@@ -152,11 +152,16 @@ export function layerRow(page: Page, name: string): Locator {
 }
 
 export function node(page: Page, id: string): Locator {
-  return page
-    .locator("iframe[data-design-preview-iframe]")
-    .first()
-    .contentFrame()
-    .locator(`[data-agent-native-node-id="${id}"]`);
+  return (
+    page
+      // A live board surface is mounted ahead of screen iframes during a
+      // cross-screen drag. Keep this helper bound to authored screen content;
+      // board documents intentionally omit data-screen-iframe-id.
+      .locator("iframe[data-design-preview-iframe][data-screen-iframe-id]")
+      .first()
+      .contentFrame()
+      .locator(`[data-agent-native-node-id="${id}"]`)
+  );
 }
 
 export async function openEditor(page: Page, designId: string): Promise<void> {