@agent-native/core 0.80.7 → 0.80.9

package/corpus/templates/design/app/root.tsx

@@ -92,7 +92,7 @@ function DbSyncSetup() {
   const qc = useQueryClient();
   useDbSync({
     queryClient: qc,
-    queryKeys: ["designs", "design-systems", "design-files", "design-variants"],
+    queryKeys: ["designs", "design-systems", "design-files"],
     ignoreSource: getBrowserTabId(),
   });
   return null;

package/corpus/templates/design/changelog/2026-06-29-agent-edits-to-a-design-are-no-longer-occasionally-dropped-o.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Agent edits to a design are no longer occasionally dropped or corrupted when local and agent changes overlap.

package/corpus/templates/design/changelog/2026-06-29-box-shadow-and-gradient-colors-keep-named-css-colors-like-re.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Box-shadow and gradient colors keep named CSS colors (like red or navy) when edited, instead of resetting to black; the eyedropper now updates the selected gradient stop instead of replacing the whole gradient.

package/corpus/templates/design/changelog/2026-06-29-containers-no-longer-block-selecting-nested-elements-and-nor.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Containers no longer block selecting nested elements, and normal flow hides unavailable alignment and gap controls.

package/corpus/templates/design/changelog/2026-06-29-cut-cmd-ctrl-x-now-removes-the-selected-element-to-the-clipb.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Cut (Cmd/Ctrl+X) now removes the selected element to the clipboard; pasting repeatedly cascades the copies instead of stacking them exactly on top.

package/corpus/templates/design/changelog/2026-06-29-deleting-with-multiple-layers-selected-in-the-layers-panel-n.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Deleting with multiple layers selected in the Layers panel now removes all of them, not just the focused one.

package/corpus/templates/design/changelog/2026-06-29-design-agents-now-generate-and-refine-variants-from-stronger.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Design agents now generate and refine variants from stronger product-grounded design guidance.

package/corpus/templates/design/changelog/2026-06-29-design-inspector-controls-now-match-figmas-softer-dark-chrome.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Design inspector controls now match Figma's softer dark chrome more closely.

package/corpus/templates/design/changelog/2026-06-29-design-questions-now-appear-as-a-cleaner-canvas-intake-with-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Design questions now appear as a cleaner canvas intake with a chat waiting note.

package/corpus/templates/design/changelog/2026-06-29-design-variant-directions-now-appear-as-board-screens-with-chat-buttons.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Design variant directions now appear as regular overview-board screens with one-click chat buttons for choosing which screen to keep.

package/corpus/templates/design/changelog/2026-06-29-duplicating-a-screen-now-gives-the-copy-its-own-layer-ids-so.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Duplicating a screen now gives the copy its own layer ids, so selecting a layer in one screen no longer affects the other.

package/corpus/templates/design/changelog/2026-06-29-element-selection-no-longer-snaps-back-to-the-previous-layer.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Element selection no longer snaps back to the previous layer after selecting or pressing Escape.

package/corpus/templates/design/changelog/2026-06-29-frame-resize-measurements-now-stay-beside-the-cursor-while-d.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Frame resize measurements now stay beside the cursor while dragging.

package/corpus/templates/design/changelog/2026-06-29-hiding-and-re-showing-a-gradient-fill-now-preserves-each-sto.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Hiding and re-showing a gradient fill now preserves each stop's opacity instead of flattening them.

package/corpus/templates/design/changelog/2026-06-29-inspector-number-fields-have-cleaner-tooltips-and-draggable-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Inspector number fields have cleaner tooltips and draggable scrub handles.

package/corpus/templates/design/changelog/2026-06-29-layer-locking-layer-nesting-generated-question-intake-and-im.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Layer locking, layer nesting, generated-question intake, and image-fill visibility behave more reliably in the visual editor.

package/corpus/templates/design/changelog/2026-06-29-layer-names-in-the-sidebar-can-scroll-horizontally-instead-o.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Layer names in the sidebar can scroll horizontally instead of truncating at deep nesting.

package/corpus/templates/design/changelog/2026-06-29-layer-nesting-in-the-sidebar-now-uses-tighter-spacing-so-nam.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Layer nesting in the sidebar now uses tighter spacing so names stay readable.

package/corpus/templates/design/changelog/2026-06-29-layers-no-longer-repeat-document-wrapper-rows-when-a-screen-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Layers no longer repeat document wrapper rows when a screen contains malformed HTML.

package/corpus/templates/design/changelog/2026-06-29-overview-previews-now-keep-element-hover-and-selection-tied-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Overview previews now keep element hover and selection tied to the correct screen.

package/corpus/templates/design/changelog/2026-06-29-picking-a-design-direction-now-submits-to-the-agent-right-aw.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Picking a design direction now submits to the agent right away and reliably saves, instead of leaving the message sitting unsent in the chat box or firing twice on a double-click.

package/corpus/templates/design/changelog/2026-06-29-pressing-escape-now-cancels-a-stuck-screen-drag-in-the-overv.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Pressing Escape now cancels a stuck screen drag in the overview canvas.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-is-easier-to-find-and-named-screens-open-dir.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Screen overview is easier to find and named screens open directly in full-screen edit mode.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-only-highlights-screens-when-the-frame-or-ti.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Screen overview only highlights screens when the frame or title is directly hovered.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-previews-now-resize-to-match-the-selected-de.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Screen overview previews now resize to match the selected device.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-selection-now-uses-a-pointer-cursor-instead-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Design selection now uses a pointer cursor instead of the move cursor.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-selection-outlines-now-stay-locked-to-the-se.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Screen overview selection outlines now stay locked to screens while selecting or resizing.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-zoom-now-reports-real-screen-scale-separatel.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Screen overview zoom now reports real screen scale separately from focused-screen zoom.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-zooming-feels-smoother-and-selection-outline.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Screen overview zooming feels much faster and smoother, in-screen elements can be selected directly, and selection chrome stays crisp above overlapping layers.

package/corpus/templates/design/changelog/2026-06-29-screen-overview-zooming-now-stays-on-the-overview-canvas-ins.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Screen overview zooming now stays on the overview canvas instead of opening a screen automatically.

package/corpus/templates/design/changelog/2026-06-29-selecting-a-nested-layer-from-all-screens-now-keeps-you-in-a.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Selecting a nested layer from All screens now keeps you in All screens view.

package/corpus/templates/design/changelog/2026-06-29-share-now-groups-link-sharing-exports-and-agent-handoff.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Share now groups link sharing, exports, and agent handoff in one tabbed menu.

package/corpus/templates/design/changelog/2026-06-29-style-changes-that-set-several-properties-at-once-fixed-size.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Style changes that set several properties at once (fixed-size text, constraints, padding, flip, stroke position) now all save reliably instead of dropping all but the last property.

package/corpus/templates/design/changelog/2026-06-29-the-design-editor-loading-skeleton-now-uses-a-softer-charcoa.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+The design editor loading skeleton now uses a softer charcoal canvas while designs load.

package/corpus/templates/design/changelog/2026-06-29-the-device-preview-menu-now-sits-next-to-the-preview-button-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+The device preview menu now sits beside collaborators in the inspector sidebar.

package/corpus/templates/design/changelog/2026-06-29-the-editor-no-longer-crashes-when-a-screen-ends-up-with-dupl.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+The editor no longer crashes when a screen ends up with duplicate or malformed layer ids (e.g. from a bad agent edit); the layer tree is now resilient to it.

package/corpus/templates/design/changelog/2026-06-29-the-inspector-stays-read-only-while-an-empty-design-is-still.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+The inspector stays read-only while an empty design is still generating.

package/corpus/templates/design/changelog/2026-06-29-the-missing-design-view-now-matches-the-rest-of-the-editor-c.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+The missing-design view is cleaner and matches the rest of the editor chrome.

package/corpus/templates/design/changelog/2026-06-29-the-pen-tool-icon-and-tool-option-menus-better-match-the-edi.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+The Pen tool icon and tool option menus better match the editor chrome.

package/corpus/templates/design/changelog/2026-06-29-typography-controls-now-keep-the-font-name-visible-and-move-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Typography controls now keep the font name visible and move text box sizing into a details popover.

package/corpus/templates/design/e2e/README.md

@@ -10,6 +10,7 @@ resizing, moving/reparenting, the layers panel, and the iframe bridge.
 pnpm e2e          # headless
 pnpm e2e:headed   # watch it drive a real browser
 pnpm e2e:ui       # Playwright UI mode
+E2E_BROWSER_CHANNEL=chrome pnpm e2e  # run the suite in installed Google Chrome
 ```
 
 - `playwright.config.ts` starts its own dev server on **:9333** backed by a
@@ -32,12 +33,12 @@ action endpoints. Both `.auth/` files are gitignored.
 
 ## Why the editor needs special handling (the hard-won bits)
 
-The design renders inside a `sandbox="allow-scripts"` iframe with **no
-`allow-same-origin`**, and a pointer-capturing shield overlay sits on top. So:
+The design renders inside a sandboxed iframe, and a pointer-capturing shield
+overlay sits on top. So:
 
 | Symptom                                                                 | Wrong approach                         | Right approach                                                                                                                                                                                             |
 | ----------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Can't read iframe DOM                                                   | `iframe.contentDocument` → `null`      | `page.frameLocator('iframe').locator(...)` — CDP targets the frame directly                                                                                                                                |
+| Reaching into iframe DOM                                                | parent-document locators               | `page.frameLocator('iframe').locator(...)` — Playwright targets the frame directly and stays stable across sandbox/overlay changes                                                                         |
 | Clicks "intercepted by `<div data-agent-native-edit-overlay="shield">`" | normal click (actionability fails)     | `.click({ force: true })` — the shield is _meant_ to get the event and drive selection                                                                                                                     |
 | Asserting an edit happened                                              | reading iframe state                   | listen for the bridge's parent `postMessage`s: `element-select`, `element-hover`, `visual-style-change`, `visual-structure-change` (see `installBridge`/`waitForBridge`)                                   |
 | `page.screenshot()` hangs forever                                       | `page.screenshot()`                    | `cdpScreenshot()` — CDP `Page.captureScreenshot`, no stability wait (the page never idles; the agent-chat panel polls)                                                                                     |

package/corpus/templates/design/e2e/global-setup.ts

@@ -18,6 +18,7 @@ export const SEED_TITLE = "E2E Seed Design";
 const AUTH_DIR = path.join(import.meta.dirname, ".auth");
 const STATE_PATH = path.join(AUTH_DIR, "state.json");
 const SEED_PATH = path.join(AUTH_DIR, "seed.json");
+const BROWSER_CHANNEL = process.env.E2E_BROWSER_CHANNEL;
 
 /**
  * Fixture HTML with distinct, text-identifiable elements. Plain inline styles
@@ -33,13 +34,22 @@ export const FIXTURE_HTML = `<!doctype html>
   </head>
   <body style="margin:0;font-family:system-ui,sans-serif;background:#0f1115;color:#f4f4f5">
     <main style="max-width:720px;margin:0 auto;padding:48px 32px;display:flex;flex-direction:column;gap:24px">
-      <h1 style="font-size:40px;font-weight:800;margin:0">E2E Hero Heading</h1>
+      <h1 style="font-size:40px;font-weight:800;margin:0;color:#f4f4f5">E2E Hero Heading</h1>
       <p style="font-size:18px;line-height:1.6;margin:0;color:#a1a1aa">First fixture paragraph for selection tests.</p>
       <p style="font-size:18px;line-height:1.6;margin:0;color:#a1a1aa">Second fixture paragraph for selection tests.</p>
       <div style="display:flex;flex-direction:row;gap:16px">
         <button style="padding:14px 28px;border-radius:10px;border:0;background:#6366f1;color:#fff;font-size:16px">Alpha Button</button>
         <button style="padding:14px 28px;border-radius:10px;border:0;background:#22c55e;color:#06240f;font-size:16px">Beta Button</button>
       </div>
+      <div style="padding:8px;border:1px solid #27272a;border-radius:12px">
+        <div style="padding:8px;border:1px solid #3f3f46;border-radius:10px">
+          <div style="padding:8px;border:1px solid #52525b;border-radius:8px">
+            <div style="padding:8px;border:1px solid #71717a;border-radius:6px">
+              <button style="padding:10px 18px;border-radius:8px;border:0;background:#f59e0b;color:#111827;font-size:14px">Deep Layer Button</button>
+            </div>
+          </div>
+        </div>
+      </div>
       <section style="margin-top:16px;padding:24px;border-radius:14px;background:#1a1d24">
         <h2 style="font-size:24px;margin:0 0 8px">Fixture Card Title</h2>
         <p style="margin:0;color:#a1a1aa">Card body text inside a nested container.</p>
@@ -72,28 +82,25 @@ export default async function globalSetup(config: FullConfig) {
     "http://127.0.0.1:9333";
   await mkdir(AUTH_DIR, { recursive: true });
 
-  const browser = await chromium.launch();
+  const browser = await chromium.launch(
+    BROWSER_CHANNEL ? { channel: BROWSER_CHANNEL } : {},
+  );
   const context = await browser.newContext();
   const page = await context.newPage();
 
   try {
-    await page.goto(`${baseURL}/`, { waitUntil: "domcontentloaded" });
+    await page.goto(`${baseURL}/_agent-native/sign-in`, {
+      waitUntil: "domcontentloaded",
+    });
 
     const isSignIn = async () => /sign in/i.test(await page.title());
 
     if (await isSignIn()) {
       // Try to create the account; if it already exists, fall back to sign in.
-      await page.getByRole("textbox", { name: "Email" }).fill(E2E_EMAIL);
-      await page
-        .getByRole("textbox", { name: "Password", exact: true })
-        .fill(E2E_PASSWORD);
-      const confirm = page.getByRole("textbox", { name: "Confirm password" });
-      if (await confirm.count()) await confirm.fill(E2E_PASSWORD);
-      await page
-        .locator("#signup-form")
-        .getByRole("button", { name: "Create account" })
-        .click()
-        .catch(() => {});
+      await page.locator("#s-email").fill(E2E_EMAIL);
+      await page.locator("#s-pass").fill(E2E_PASSWORD);
+      await page.locator("#s-pass2").fill(E2E_PASSWORD);
+      await page.locator("#signup-form button[type='submit']").click();
       await page.waitForTimeout(2500);
 
       if (await isSignIn()) {
@@ -103,15 +110,9 @@ export default async function globalSetup(config: FullConfig) {
           .first()
           .click()
           .catch(() => {});
-        await page.getByRole("textbox", { name: "Email" }).fill(E2E_EMAIL);
-        await page
-          .getByRole("textbox", { name: "Password", exact: true })
-          .fill(E2E_PASSWORD);
-        await page
-          .getByRole("button", { name: /sign in/i })
-          .last()
-          .click()
-          .catch(() => {});
+        await page.locator("#l-email").fill(E2E_EMAIL);
+        await page.locator("#l-pass").fill(E2E_PASSWORD);
+        await page.locator("#login-form button[type='submit']").click();
         await page.waitForTimeout(2500);
       }
     }

package/corpus/templates/design/e2e/helpers.ts

@@ -26,7 +26,7 @@ export async function readSeedDesignId(): Promise<string> {
 }
 
 export function designFrame(page: Page): FrameLocator {
-  return page.frameLocator("iframe");
+  return page.frameLocator("iframe[data-design-preview-iframe]");
 }
 
 /** Open the editor for a design and wait for the toolbar + iframe to be ready. */
@@ -35,7 +35,16 @@ export async function gotoEditor(page: Page, designId: string): Promise<void> {
   await expect(
     page.getByRole("button", { name: "Move", exact: true }),
   ).toBeVisible({ timeout: 30_000 });
-  await expect(page.locator("iframe").first()).toBeVisible();
+  await waitForDesignBridgeReady(page);
+}
+
+async function waitForDesignBridgeReady(page: Page): Promise<void> {
+  await expect(
+    page.locator("iframe[data-design-preview-iframe]"),
+  ).toBeVisible();
+  await expect(
+    designFrame(page).locator('[data-agent-native-edit-overlay="shield"]'),
+  ).toBeVisible({ timeout: 10_000 });
   // Wait for the iframe bridge to stamp at least one selectable node.
   await expect
     .poll(
@@ -48,14 +57,43 @@ export async function gotoEditor(page: Page, designId: string): Promise<void> {
     .toBeGreaterThan(0);
 }
 
+export async function enterDirectMode(page: Page): Promise<void> {
+  const fullView = page.getByRole("button", { name: "Full view", exact: true });
+  const fullViewVisible = await fullView
+    .first()
+    .waitFor({ state: "visible", timeout: 5_000 })
+    .then(() => true)
+    .catch(() => false);
+  if (fullViewVisible) {
+    await fullView.first().click();
+    await expect(fullView).toHaveCount(0);
+  }
+  await expect
+    .poll(
+      async () =>
+        (await page.locator("iframe[data-design-preview-iframe]").boundingBox())
+          ?.width ?? 0,
+      { timeout: 10_000 },
+    )
+    .toBeGreaterThan(600);
+  await waitForDesignBridgeReady(page);
+}
+
 /** Start capturing bridge postMessages on the parent window. */
 export async function installBridge(page: Page): Promise<void> {
   await page.evaluate(() => {
-    (window as any).__bridge = [];
+    const win = window as any;
+    if (!Array.isArray(win.__bridge)) win.__bridge = [];
+    if (win.__bridgeInstalled) return;
+    win.__bridgeInstalled = true;
     window.addEventListener("message", (e: MessageEvent) => {
       const t = (e.data as any)?.type;
-      if (typeof t === "string" && /^(element-|visual-)/.test(t)) {
-        (window as any).__bridge.push(e.data);
+      if (
+        typeof t === "string" &&
+        (/^(element-|visual-)/.test(t) || t === "text-content-change")
+      ) {
+        if (!Array.isArray(win.__bridge)) win.__bridge = [];
+        win.__bridge.push(e.data);
       }
     });
   });
@@ -73,7 +111,9 @@ export async function waitForBridge(
 ): Promise<any> {
   const handle = await page.waitForFunction(
     (t) =>
-      ((window as any).__bridge ?? []).find((m: any) => m.type === t) ?? null,
+      [...((window as any).__bridge ?? [])]
+        .reverse()
+        .find((m: any) => m.type === t) ?? null,
     type,
     { timeout },
   );
@@ -86,14 +126,85 @@ export async function waitForBridge(
  * shield overlay (which is what actually drives selection).
  */
 export async function selectByText(page: Page, text: string): Promise<any> {
+  await enterDirectMode(page);
   await installBridge(page);
   await page.evaluate(() => ((window as any).__bridge = []));
+  const target = designFrame(page).getByText(text, { exact: false }).first();
+  await target.waitFor({ state: "visible", timeout: 8_000 });
+  const box = await target.boundingBox();
+  if (!box) throw new Error(`no bounding box for "${text}"`);
+  await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);
+  let sel: any;
+  try {
+    sel = await waitForBridge(page, "element-select", 2_000);
+  } catch {
+    await page.evaluate(() => ((window as any).__bridge = []));
+    await dispatchShieldClickByText(page, text);
+    sel = await waitForBridge(page, "element-select");
+  }
+  const payload = sel?.payload ?? sel;
+  expect(String(payload?.textContent ?? "")).toContain(text);
+  return payload;
+}
+
+async function dispatchShieldClickByText(
+  page: Page,
+  text: string,
+): Promise<void> {
   await designFrame(page)
-    .getByText(text, { exact: false })
-    .first()
-    .click({ force: true, timeout: 8_000 });
-  const sel = await waitForBridge(page, "element-select");
-  return sel?.payload ?? sel;
+    .locator("body")
+    .evaluate((_, targetText) => {
+      const normalizeText = (element: HTMLElement) =>
+        (element.textContent ?? "").replace(/\s+/g, " ").trim();
+      const isVisible = (element: HTMLElement) => {
+        const rect = element.getBoundingClientRect();
+        const styles = window.getComputedStyle(element);
+        return (
+          rect.width > 0 &&
+          rect.height > 0 &&
+          styles.display !== "none" &&
+          styles.visibility !== "hidden"
+        );
+      };
+      const shield = document.querySelector<HTMLElement>(
+        '[data-agent-native-edit-overlay="shield"]',
+      );
+      const leafCandidates = Array.from(
+        document.querySelectorAll<HTMLElement>(
+          "h1, h2, h3, h4, h5, h6, p, button, a, label, span, input, textarea",
+        ),
+      ).filter(isVisible);
+      const nodeCandidates = Array.from(
+        document.querySelectorAll<HTMLElement>("[data-agent-native-node-id]"),
+      ).filter(isVisible);
+      const target =
+        nodeCandidates.find(
+          (element) => normalizeText(element) === targetText,
+        ) ??
+        leafCandidates.find(
+          (element) => normalizeText(element) === targetText,
+        ) ??
+        nodeCandidates.find((element) =>
+          normalizeText(element).includes(targetText),
+        ) ??
+        leafCandidates.find((element) =>
+          normalizeText(element).includes(targetText),
+        );
+      if (!shield || !target) {
+        throw new Error(`unable to dispatch selection for "${targetText}"`);
+      }
+      const rect = target.getBoundingClientRect();
+      shield.dispatchEvent(
+        new MouseEvent("click", {
+          bubbles: true,
+          cancelable: true,
+          view: window,
+          clientX: rect.left + rect.width / 2,
+          clientY: rect.top + rect.height / 2,
+          detail: 1,
+        }),
+      );
+    }, text);
 }
 
 /** Number of inputs in the right-hand inspector (proxy for "inspector populated"). */