@tangle-network/browser-agent-driver 0.25.0 → 0.27.0

package/dist/drivers/cursor-overlay.js

@@ -240,6 +240,56 @@ export const CURSOR_OVERLAY_INIT_SCRIPT = `
     overflow: 'hidden',
   });
 
+  // ── Gen 34 Hydra View — fan-out grid (live thumbnails of sub-tabs) ─────
+  // Full-viewport dim overlay + grid of live sub-tab screenshot cells.
+  // Cells lay out based on count: 1→1, 2→1x2, 3-4→2x2, 5-6→2x3, 7-8→2x4.
+  // Each cell background updates via updateFanOutCell(i, dataUrl, meta).
+  const hydra = document.createElement('div');
+  hydra.id = '__bad_overlay_hydra';
+  Object.assign(hydra.style, {
+    position: 'fixed',
+    inset: '0',
+    display: 'none',
+    background: 'radial-gradient(ellipse at center, rgba(11,18,32,0.80) 0%, rgba(11,18,32,0.95) 100%)',
+    backdropFilter: 'blur(6px)',
+    alignItems: 'center',
+    justifyContent: 'center',
+    flexDirection: 'column',
+    gap: '20px',
+    transition: 'opacity 400ms ease',
+    opacity: '0',
+    pointerEvents: 'none',
+  });
+  const hydraTitle = document.createElement('div');
+  Object.assign(hydraTitle.style, {
+    fontSize: '11px',
+    fontWeight: '700',
+    letterSpacing: '0.16em',
+    textTransform: 'uppercase',
+    color: '#7aa2ff',
+    textAlign: 'center',
+  });
+  hydraTitle.textContent = 'Fan-out · investigating branches in parallel';
+  const hydraGrid = document.createElement('div');
+  hydraGrid.id = '__bad_overlay_hydra_grid';
+  Object.assign(hydraGrid.style, {
+    display: 'grid',
+    gap: '16px',
+    maxWidth: '1200px',
+    maxHeight: '70vh',
+    padding: '0 40px',
+  });
+  const hydraCounter = document.createElement('div');
+  Object.assign(hydraCounter.style, {
+    fontSize: '13px',
+    color: '#e6ebf5',
+    fontWeight: '600',
+    textAlign: 'center',
+  });
+  hydra.appendChild(hydraTitle);
+  hydra.appendChild(hydraGrid);
+  hydra.appendChild(hydraCounter);
+
   // Append to documentElement (not body) so the overlay is not affected by
   // body's stacking context — many modern sites apply transform/will-change
   // to body which would clip a max-z-index child appended to body.
@@ -262,6 +312,7 @@ export const CURSOR_OVERLAY_INIT_SCRIPT = `
     root.appendChild(ring);
     root.appendChild(cursor);
     root.appendChild(label);
+    root.appendChild(hydra);
   }
   attach();
 
@@ -418,6 +469,219 @@ export const CURSOR_OVERLAY_INIT_SCRIPT = `
       } catch { /* cosmetic */ }
     },
 
+    // ── Gen 34 Hydra API ─────────────────────────────────────────────
+    /**
+     * Begin a fan-out: render the dim overlay + grid of N labeled cells.
+     * Cells start in "queued" state (empty). Call updateFanOutCell(i, ...)
+     * as sub-agent screenshots stream in.
+     *
+     * labels: human-readable label per cell, one per sub-agent.
+     * originX/originY: optional viewport coord where the fan-out was
+     *   initiated — cells burst outward from this point (default: center).
+     */
+    fanOutStart(labels, originX, originY) {
+      try {
+        const n = Math.max(1, Math.min(8, labels.length));
+        // Layout: 1→1, 2→1x2, 3-4→2x2, 5-6→3x2, 7-8→4x2
+        const cols = n === 1 ? 1 : n === 2 ? 2 : n <= 4 ? 2 : n <= 6 ? 3 : 4;
+        const rows = Math.ceil(n / cols);
+        hydraGrid.style.gridTemplateColumns = 'repeat(' + cols + ', 1fr)';
+        hydraGrid.style.gridTemplateRows = 'repeat(' + rows + ', 1fr)';
+        // Cell size: scale to fit. For a 1200x600 viewport budget:
+        const cellW = Math.floor(1120 / cols) - 10;
+        const cellH = Math.floor(Math.min(520 / rows, cellW * 0.7));
+        // Clear prior cells
+        while (hydraGrid.firstChild) hydraGrid.removeChild(hydraGrid.firstChild);
+        const originPx = typeof originX === 'number' && typeof originY === 'number'
+          ? { x: originX, y: originY }
+          : { x: window.innerWidth / 2, y: window.innerHeight / 2 };
+        for (let i = 0; i < n; i++) {
+          const cell = document.createElement('div');
+          cell.className = '__bad_hydra_cell';
+          cell.dataset.index = String(i);
+          Object.assign(cell.style, {
+            position: 'relative',
+            width: cellW + 'px',
+            height: cellH + 'px',
+            background: '#0b1220',
+            backgroundSize: 'cover',
+            backgroundPosition: 'center top',
+            border: '2px solid rgba(122,162,255,0.55)',
+            borderRadius: '10px',
+            overflow: 'hidden',
+            boxShadow: '0 10px 30px rgba(0,0,0,0.55), inset 0 0 0 1px rgba(122,162,255,0.2)',
+            opacity: '0',
+            transform: 'translate(' + (originPx.x - window.innerWidth / 2) + 'px, ' + (originPx.y - window.innerHeight / 2) + 'px) scale(0.15)',
+            transition: 'transform 480ms cubic-bezier(0.34, 1.56, 0.64, 1), opacity 300ms ease, border-color 300ms ease, box-shadow 300ms ease',
+          });
+          // Header strip: label + live elapsed
+          const header = document.createElement('div');
+          Object.assign(header.style, {
+            position: 'absolute',
+            top: '0', left: '0', right: '0',
+            padding: '6px 10px',
+            background: 'linear-gradient(180deg, rgba(11,18,32,0.95) 0%, rgba(11,18,32,0.0) 100%)',
+            color: '#e6ebf5',
+            fontSize: '11px',
+            fontWeight: '700',
+            letterSpacing: '0.04em',
+            display: 'flex',
+            justifyContent: 'space-between',
+            alignItems: 'center',
+          });
+          const headerLabel = document.createElement('span');
+          headerLabel.textContent = labels[i] || ('branch-' + (i + 1));
+          const headerTimer = document.createElement('span');
+          headerTimer.className = '__bad_hydra_timer';
+          headerTimer.style.cssText = 'font-family:SF Mono,Menlo,monospace;font-size:10px;color:#9aa3b8;font-weight:500;';
+          headerTimer.textContent = '0.0s';
+          header.appendChild(headerLabel);
+          header.appendChild(headerTimer);
+          cell.appendChild(header);
+          // Verdict chip (hidden until complete)
+          const chip = document.createElement('div');
+          chip.className = '__bad_hydra_chip';
+          Object.assign(chip.style, {
+            position: 'absolute',
+            bottom: '8px',
+            left: '8px',
+            padding: '3px 10px',
+            background: 'rgba(11,18,32,0.92)',
+            color: '#ffffff',
+            fontSize: '10px',
+            fontWeight: '700',
+            letterSpacing: '0.05em',
+            textTransform: 'uppercase',
+            borderRadius: '6px',
+            opacity: '0',
+            transition: 'opacity 220ms ease',
+          });
+          cell.appendChild(chip);
+          hydraGrid.appendChild(cell);
+        }
+        hydra.style.display = 'flex';
+        hydraCounter.textContent = '0 / ' + n + ' branches complete';
+        // Next frame: fade in + animate cells to their grid positions
+        requestAnimationFrame(() => {
+          hydra.style.opacity = '1';
+          const cells = hydraGrid.children;
+          for (let i = 0; i < cells.length; i++) {
+            const c = cells[i];
+            // Staggered burst: 0ms, 60ms, 120ms, ...
+            setTimeout(function () {
+              c.style.opacity = '1';
+              c.style.transform = 'translate(0, 0) scale(1)';
+            }, i * 60);
+          }
+        });
+        // Start the elapsed-time ticker
+        hydra.__tickerStart = Date.now();
+        if (hydra.__ticker) clearInterval(hydra.__ticker);
+        hydra.__ticker = setInterval(function () {
+          const elapsed = (Date.now() - hydra.__tickerStart) / 1000;
+          const cells = hydraGrid.children;
+          for (let i = 0; i < cells.length; i++) {
+            const cell = cells[i];
+            if (cell.__completedAt) continue;
+            const timer = cell.querySelector('.__bad_hydra_timer');
+            if (timer) timer.textContent = elapsed.toFixed(1) + 's';
+          }
+        }, 100);
+      } catch { /* cosmetic */ }
+    },
+
+    /**
+     * Update cell N with a fresh screenshot (data URL) and/or metadata.
+     * Call this at 2-5 FPS from the runner's screenshot streamer.
+     *   meta: { action?: string, turn?: number }
+     */
+    fanOutUpdateCell(index, dataUrl, meta) {
+      try {
+        const cell = hydraGrid.children[index];
+        if (!cell) return;
+        if (dataUrl) {
+          cell.style.backgroundImage = 'url("' + dataUrl + '")';
+        }
+        // eslint-disable-next-line no-empty
+        if (meta) { /* reserved for future overlays inside the cell */ }
+      } catch { /* cosmetic */ }
+    },
+
+    /**
+     * Mark cell N as complete with a verdict. kind is one of
+     * 'positive' | 'cleared' | 'review' | 'info'. Final state: border
+     * recolors, chip fades in, timer freezes.
+     */
+    fanOutCompleteCell(index, kind, verdictText) {
+      try {
+        const cell = hydraGrid.children[index];
+        if (!cell) return;
+        cell.__completedAt = Date.now();
+        const palette = (kind === 'positive' ? { c: '#fb7185', bg: 'rgba(251,113,133,0.25)' }
+          : kind === 'cleared' ? { c: '#4ade80', bg: 'rgba(74,222,128,0.25)' }
+            : kind === 'review' ? { c: '#fbbf24', bg: 'rgba(251,191,36,0.25)' }
+              : { c: '#7aa2ff', bg: 'rgba(122,162,255,0.25)' });
+        cell.style.borderColor = palette.c;
+        cell.style.boxShadow = '0 10px 30px rgba(0,0,0,0.55), inset 0 0 0 1px ' + palette.c + ', 0 0 24px ' + palette.bg;
+        const chip = cell.querySelector('.__bad_hydra_chip');
+        if (chip) {
+          chip.style.background = palette.bg;
+          chip.style.color = palette.c;
+          chip.style.border = '1px solid ' + palette.c;
+          chip.textContent = (verdictText || kind).slice(0, 32);
+          chip.style.opacity = '1';
+        }
+        // Update global counter
+        const total = hydraGrid.children.length;
+        let done = 0;
+        for (let i = 0; i < total; i++) if (hydraGrid.children[i].__completedAt) done++;
+        hydraCounter.textContent = done + ' / ' + total + ' branches complete';
+      } catch { /* cosmetic */ }
+    },
+
+    /**
+     * Collapse the grid: cells fly inward to center, merge into a result
+     * tile, then dissolve. Returns after ~800ms when the animation is
+     * done (but does NOT hide the overlay — caller invokes fanOutDismiss).
+     */
+    fanOutCollapse() {
+      try {
+        if (hydra.__ticker) { clearInterval(hydra.__ticker); hydra.__ticker = null; }
+        const cells = hydraGrid.children;
+        const cx = window.innerWidth / 2;
+        const cy = window.innerHeight / 2;
+        for (let i = 0; i < cells.length; i++) {
+          const c = cells[i];
+          const rect = c.getBoundingClientRect();
+          const dx = cx - (rect.left + rect.width / 2);
+          const dy = cy - (rect.top + rect.height / 2);
+          c.style.transition = 'transform 520ms cubic-bezier(0.6, 0, 0.4, 1), opacity 400ms ease';
+          c.style.transform = 'translate(' + dx + 'px, ' + dy + 'px) scale(0.2)';
+          c.style.opacity = '0';
+        }
+        hydraTitle.style.transition = 'opacity 400ms ease';
+        hydraCounter.style.transition = 'opacity 400ms ease';
+        setTimeout(function () { hydraTitle.style.opacity = '0'; hydraCounter.style.opacity = '0'; }, 200);
+      } catch { /* cosmetic */ }
+    },
+
+    /**
+     * Hide the Hydra overlay entirely. Call after fanOutCollapse has
+     * finished + the parent agent has resumed.
+     */
+    fanOutDismiss() {
+      try {
+        hydra.style.opacity = '0';
+        setTimeout(function () {
+          hydra.style.display = 'none';
+          hydraTitle.style.opacity = '1';
+          hydraCounter.style.opacity = '1';
+          while (hydraGrid.firstChild) hydraGrid.removeChild(hydraGrid.firstChild);
+          if (hydra.__ticker) { clearInterval(hydra.__ticker); hydra.__ticker = null; }
+        }, 400);
+      } catch { /* cosmetic */ }
+    },
+
     hide() {
       box.style.opacity = '0';
       label.style.opacity = '0';

package/dist/drivers/cursor-overlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-overlay.js","sourceRoot":"","sources":["../../src/drivers/cursor-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoZzC,CAAA"}
+{"version":3,"file":"cursor-overlay.js","sourceRoot":"","sources":["../../src/drivers/cursor-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4pBzC,CAAA"}

package/dist/drivers/overlay-label.d.ts

@@ -2,18 +2,26 @@
  * Cursor-overlay label builder.
  *
  * The overlay renders a single short label string next to the animated
- * cursor. A bare verb (`click`, `type`) leaves 90% of the agent's intent
- * invisible to anyone watching the recording. Rich labels turn the cursor
- * into a readable narrative — `click · Search`, `type · "IVANOV ALEKSANDR"`,
- * `press · Enter`, `nav · sanctionssearch.ofac.treas.gov`.
+ * cursor. The label is the PRIMARY channel of agent intent visible to
+ * anyone watching a recorded video — it needs to read like a human
+ * narrator, not like a debug log.
+ *
+ * Gen 34 rewrite: natural-English sentences.
+ *
+ *   Before:   `type "JOHN SMITH" · Last Name: insert criteria`
+ *   After:    `Typing "JOHN SMITH" into Last Name`
  *
  * Design rules:
- *   - Labels MUST fit on one line at ~13px. Target max 48 chars rendered.
+ *   - Labels MUST fit on one line at ~13px. Target max 56 chars rendered.
  *   - Truncate with an ellipsis; never wrap.
  *   - Verb-only is the SAFE FALLBACK — never throw, never return empty.
- *   - Target accessible name goes in the label only when it's short and
- *     informative. Skip generic names ('button', 'link', 'textbox') that
- *     restate the role the viewer already sees from context.
+ *   - Target names get aggressive cleanup: strip trailing punctuation,
+ *     drop generic role-restatements, drop verbose suffixes like
+ *     "insert criteria" / "search input" that ARIA labels carry but
+ *     viewers don't need.
+ *   - Start every action with a verb-in-progress ("Typing", "Clicking",
+ *     "Pressing") for readability. Status-bar shorthand ("click · X")
+ *     was good for devs; bad for anyone else.
  */
 import type { Action } from '../types.js';
 export interface OverlayLabelContext {
@@ -26,8 +34,8 @@ export interface OverlayLabelContext {
  * Build a single-line label string for the cursor overlay given an action
  * and (optionally) the resolved target element's accessible name.
  *
- * Always returns a non-empty string. Falls back to the bare verb on any
- * missing context.
+ * Always returns a non-empty string. Falls back to a bare verb-phrase
+ * ("Clicking", "Typing") on any missing context. Never throws.
  */
 export declare function formatOverlayLabel(action: Action, ctx?: OverlayLabelContext): string;
 //# sourceMappingURL=overlay-label.d.ts.map

package/dist/drivers/overlay-label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay-label.d.ts","sourceRoot":"","sources":["../../src/drivers/overlay-label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AA0CzC,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,mBAAwB,GAAG,MAAM,CAsCxF"}
+{"version":3,"file":"overlay-label.d.ts","sourceRoot":"","sources":["../../src/drivers/overlay-label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAyFzC,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,mBAAwB,GAAG,MAAM,CAsCxF"}

package/dist/drivers/overlay-label.js

@@ -1,17 +1,31 @@
-const MAX_LABEL_LEN = 48;
-const MAX_TEXT_PREVIEW = 30;
-const MAX_NAME_PREVIEW = 30;
+const MAX_LABEL_LEN = 56;
+const MAX_TEXT_PREVIEW = 32;
+const MAX_NAME_PREVIEW = 28;
 /**
  * Role names that are generic; including them in the label adds no info.
- * NOTE: "Search" is NOT here — a button labeled "Search" is informative
- * (OFAC, Google, etc.). "searchbox" IS here — that's the role spilling
- * through as a name when an input has no label, which just restates what
- * the viewer already sees from the cursor's position on the textbox.
+ * NOTE: "Search" is NOT here — a button labeled "Search" is informative.
  */
 const GENERIC_NAMES = new Set([
     'button', 'link', 'textbox', 'input', 'field', 'searchbox',
     'combobox', 'listbox', 'option', 'checkbox', 'radio', 'switch',
 ]);
+/**
+ * Suffixes ARIA labels / placeholders often carry that bloat the label
+ * without adding meaning. "Last Name: insert criteria" → "Last Name".
+ * Matching is case-insensitive and trims any trailing punctuation.
+ */
+const NOISE_SUFFIXES = [
+    /\s*[:,]?\s*insert (?:criteria|name|value|text)\s*$/i,
+    /\s*[:,]?\s*search input\s*$/i,
+    /\s*[:,]?\s*search field\s*$/i,
+    /\s*[:,]?\s*input field\s*$/i,
+    /\s*[:,]?\s*text input\s*$/i,
+    /\s*[:,]?\s*enter (?:text|value|name|keyword|query)\s*$/i,
+    /\s*[:,]?\s*type (?:here|name|text)\s*$/i,
+    /\s*[:,]?\s*required\s*$/i,
+    /\s*[*]\s*$/, // trailing asterisks from "Required *" fields
+    /[:;,]\s*$/, // any trailing punctuation
+];
 function truncate(s, max) {
     const collapsed = s.replace(/\s+/g, ' ').trim();
     if (collapsed.length <= max)
@@ -21,7 +35,22 @@ function truncate(s, max) {
 function cleanName(name) {
     if (!name)
         return undefined;
-    const c = name.replace(/\s+/g, ' ').trim();
+    let c = name.replace(/\s+/g, ' ').trim();
+    if (!c)
+        return undefined;
+    // Strip noise suffixes iteratively — an ARIA name like
+    // "Last Name: insert criteria, required *" has three layers to peel.
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const re of NOISE_SUFFIXES) {
+            const stripped = c.replace(re, '').trim();
+            if (stripped !== c && stripped.length > 0) {
+                c = stripped;
+                changed = true;
+            }
+        }
+    }
     if (!c)
         return undefined;
     if (GENERIC_NAMES.has(c.toLowerCase()))
@@ -38,52 +67,69 @@ function displayHost(url) {
         return url.replace(/^https?:\/\//, '').replace(/\/.*$/, '').slice(0, MAX_NAME_PREVIEW);
     }
 }
+/** Press keys get friendlier names — "Enter" / "Tab" / arrow glyphs. */
+function friendlyKey(key) {
+    const k = key.trim();
+    const map = {
+        'Enter': 'Enter',
+        'Return': 'Enter',
+        'Tab': 'Tab',
+        'Escape': 'Esc',
+        'Backspace': '⌫',
+        'Delete': 'Del',
+        'ArrowUp': '↑',
+        'ArrowDown': '↓',
+        'ArrowLeft': '←',
+        'ArrowRight': '→',
+    };
+    return map[k] ?? k;
+}
 /**
  * Build a single-line label string for the cursor overlay given an action
  * and (optionally) the resolved target element's accessible name.
  *
- * Always returns a non-empty string. Falls back to the bare verb on any
- * missing context.
+ * Always returns a non-empty string. Falls back to a bare verb-phrase
+ * ("Clicking", "Typing") on any missing context. Never throws.
  */
 export function formatOverlayLabel(action, ctx = {}) {
     const name = cleanName(ctx.targetName);
     switch (action.action) {
         case 'click': {
-            return truncate(name ? `click · ${name}` : 'click', MAX_LABEL_LEN);
+            return truncate(name ? `Clicking ${name}` : 'Clicking', MAX_LABEL_LEN);
         }
         case 'type': {
             const text = truncate(action.text ?? '', MAX_TEXT_PREVIEW);
             if (text && name)
-                return truncate(`type "${text}" · ${name}`, MAX_LABEL_LEN);
+                return truncate(`Typing “${text}” into ${name}`, MAX_LABEL_LEN);
             if (text)
-                return truncate(`type · "${text}"`, MAX_LABEL_LEN);
-            return name ? truncate(`type · ${name}`, MAX_LABEL_LEN) : 'type';
+                return truncate(`Typing “${text}”`, MAX_LABEL_LEN);
+            return name ? truncate(`Typing into ${name}`, MAX_LABEL_LEN) : 'Typing';
         }
         case 'press': {
-            const key = action.key ?? '';
+            const key = action.key ? friendlyKey(action.key) : '';
             if (key && name)
-                return truncate(`press ${key} · ${name}`, MAX_LABEL_LEN);
-            return truncate(key ? `press · ${key}` : 'press', MAX_LABEL_LEN);
+                return truncate(`Pressing ${key} in ${name}`, MAX_LABEL_LEN);
+            return truncate(key ? `Pressing ${key}` : 'Pressing a key', MAX_LABEL_LEN);
         }
         case 'hover': {
-            return truncate(name ? `hover · ${name}` : 'hover', MAX_LABEL_LEN);
+            return truncate(name ? `Hovering ${name}` : 'Hovering', MAX_LABEL_LEN);
         }
         case 'select': {
             const val = truncate(action.value ?? '', MAX_TEXT_PREVIEW);
             if (val && name)
-                return truncate(`select ${val} · ${name}`, MAX_LABEL_LEN);
+                return truncate(`Selecting “${val}” in ${name}`, MAX_LABEL_LEN);
             if (val)
-                return truncate(`select · ${val}`, MAX_LABEL_LEN);
-            return name ? truncate(`select · ${name}`, MAX_LABEL_LEN) : 'select';
+                return truncate(`Selecting “${val}”`, MAX_LABEL_LEN);
+            return name ? truncate(`Selecting in ${name}`, MAX_LABEL_LEN) : 'Selecting';
         }
         case 'scroll': {
-            return truncate(`scroll ${action.direction}`, MAX_LABEL_LEN);
+            return truncate(`Scrolling ${action.direction}`, MAX_LABEL_LEN);
         }
         case 'navigate': {
-            return truncate(`nav · ${displayHost(action.url)}`, MAX_LABEL_LEN);
+            return truncate(`Navigating to ${displayHost(action.url)}`, MAX_LABEL_LEN);
         }
         case 'wait': {
-            return truncate(`wait ${action.ms}ms`, MAX_LABEL_LEN);
+            return truncate(`Waiting ${action.ms}ms`, MAX_LABEL_LEN);
         }
         default:
             return action.action;

package/dist/drivers/overlay-label.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlay-label.js","sourceRoot":"","sources":["../../src/drivers/overlay-label.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"overlay-label.js","sourceRoot":"","sources":["../../src/drivers/overlay-label.ts"],"names":[],"mappings":"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"}

package/dist/drivers/playwright.d.ts

@@ -121,6 +121,16 @@ export declare class PlaywrightDriver implements Driver {
      * to celebrate the moment.
      */
     pushOverlayBadge(kind: 'positive' | 'cleared' | 'review' | 'info', text: string): Promise<void>;
+    /** Start the fan-out overlay. Renders the dim + grid of N labeled cells. */
+    fanOutStart(labels: string[]): Promise<void>;
+    /** Stream a JPEG dataURL into cell N. Call at 2-5 FPS during fan-out. */
+    fanOutUpdateCell(index: number, dataUrl?: string): Promise<void>;
+    /** Mark cell N complete with a verdict kind + chip text. */
+    fanOutCompleteCell(index: number, kind: 'positive' | 'cleared' | 'review' | 'info', verdictText?: string): Promise<void>;
+    /** Collapse the grid (cells fly to center, merge). ~500ms animation. */
+    fanOutCollapse(): Promise<void>;
+    /** Dismiss the fan-out overlay (fade out). Call after collapse finishes. */
+    fanOutDismiss(): Promise<void>;
     getPage(): Page;
     getUrl(): string;
     inspectSelectorHref(selector: string): Promise<string | undefined>;

package/dist/drivers/playwright.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/drivers/playwright.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/drivers/playwright.ts"],"names":[],"mappings":"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"}

package/dist/drivers/playwright.js

@@ -328,6 +328,84 @@ export class PlaywrightDriver {
         }
         catch { /* cosmetic */ }
     }
+    // ── Gen 34 Hydra API ───────────────────────────────────────────────
+    /** Start the fan-out overlay. Renders the dim + grid of N labeled cells. */
+    async fanOutStart(labels) {
+        if (!this.options.showCursor)
+            return;
+        if (this.cursorInstallPromise)
+            await this.cursorInstallPromise.catch(() => undefined);
+        try {
+            const ls = labels.slice(0, 8);
+            await this.page.evaluate((l) => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const ov = window.__bad_overlay;
+                if (ov && typeof ov.fanOutStart === 'function')
+                    ov.fanOutStart(l);
+            }, ls).catch(() => { });
+        }
+        catch { /* cosmetic */ }
+    }
+    /** Stream a JPEG dataURL into cell N. Call at 2-5 FPS during fan-out. */
+    async fanOutUpdateCell(index, dataUrl) {
+        if (!this.options.showCursor)
+            return;
+        if (this.cursorInstallPromise)
+            await this.cursorInstallPromise.catch(() => undefined);
+        try {
+            await this.page.evaluate(({ i, d }) => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const ov = window.__bad_overlay;
+                if (ov && typeof ov.fanOutUpdateCell === 'function')
+                    ov.fanOutUpdateCell(i, d);
+            }, { i: index, ...(dataUrl ? { d: dataUrl } : {}) }).catch(() => { });
+        }
+        catch { /* cosmetic */ }
+    }
+    /** Mark cell N complete with a verdict kind + chip text. */
+    async fanOutCompleteCell(index, kind, verdictText) {
+        if (!this.options.showCursor)
+            return;
+        if (this.cursorInstallPromise)
+            await this.cursorInstallPromise.catch(() => undefined);
+        try {
+            await this.page.evaluate(({ i, k, t }) => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const ov = window.__bad_overlay;
+                if (ov && typeof ov.fanOutCompleteCell === 'function')
+                    ov.fanOutCompleteCell(i, k, t);
+            }, { i: index, k: kind, ...(verdictText ? { t: verdictText } : {}) }).catch(() => { });
+        }
+        catch { /* cosmetic */ }
+    }
+    /** Collapse the grid (cells fly to center, merge). ~500ms animation. */
+    async fanOutCollapse() {
+        if (!this.options.showCursor)
+            return;
+        try {
+            await this.page.evaluate(() => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const ov = window.__bad_overlay;
+                if (ov && typeof ov.fanOutCollapse === 'function')
+                    ov.fanOutCollapse();
+            }).catch(() => { });
+        }
+        catch { /* cosmetic */ }
+    }
+    /** Dismiss the fan-out overlay (fade out). Call after collapse finishes. */
+    async fanOutDismiss() {
+        if (!this.options.showCursor)
+            return;
+        try {
+            await this.page.evaluate(() => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const ov = window.__bad_overlay;
+                if (ov && typeof ov.fanOutDismiss === 'function')
+                    ov.fanOutDismiss();
+            }).catch(() => { });
+        }
+        catch { /* cosmetic */ }
+    }
     getPage() {
         return this.page;
     }