leapfrog-mcp 0.6.9 → 0.7.1

package/dist/index.js

@@ -27,7 +27,7 @@ import { adaptiveNavigate, formatAdaptiveResult } from "./adaptive-wait.js";
 import { runStealthAudit } from "./stealth-audit.js";
 import { exportSession, replayRecording } from "./recording.js";
 import { paginate } from "./paginate.js";
-import { getHUDInitScript, getHUDUpdateScript, getClickRippleScript } from "./session-hud.js";
+import { getHUDInitScript, getHUDUpdateScript, getClickRippleScript, getAgentEyesInitScript } from "./session-hud.js";
 import { getDetectionInitScript, getDetectionCheckScript, getResolutionCheckScript, parseDetectionResult, getPressAndHoldDetectScript, solvePressAndHold } from "./intervention.js";
 import { getConsentDismissScript, getCacheSelectorScript, getTermsAutoCheckScript } from "./consent-dismiss.js";
 import { solveCaptcha, isCaptchaSolverEnabled } from "./captcha-solver.js";
@@ -62,6 +62,47 @@ const LEAP_HUD = process.env.LEAP_HUD === "true";
 const LEAP_AUTO_CONSENT = process.env.LEAP_AUTO_CONSENT !== "false"; // default ON
 const LEAP_TRACE = process.env.LEAP_TRACE === "true";
 const LEAP_RECORD = process.env.LEAP_RECORD === "true";
+const LEAP_AD_BLOCK = process.env.LEAP_AD_BLOCK !== "false"; // default ON
+// ── Ad/Tracker Blocking ──────────────────────────────────────────────────
+const AD_BLOCK_DOMAINS = new Set([
+    "doubleclick.net", "googlesyndication.com", "googleadservices.com",
+    "google-analytics.com", "googletagmanager.com", "googletagservices.com",
+    "adservice.google.com", "pagead2.googlesyndication.com",
+    "facebook.net", "connect.facebook.net", "fbcdn.net",
+    "amazon-adsystem.com", "ads-api.twitter.com",
+    "ads.yahoo.com", "analytics.yahoo.com",
+    "scorecardresearch.com", "quantserve.com", "outbrain.com",
+    "taboola.com", "criteo.com", "criteo.net",
+    "moatads.com", "adsrvr.org", "adnxs.com", "rubiconproject.com",
+    "pubmatic.com", "openx.net", "casalemedia.com",
+    "chartbeat.com", "hotjar.com", "mixpanel.com", "segment.io",
+    "newrelic.com", "nr-data.net", "optimizely.com",
+    "demdex.net", "omtrdc.net", "2o7.net",
+    "tealiumiq.com", "tags.tiqcdn.com",
+]);
+function shouldBlockUrl(url) {
+    try {
+        const hostname = new URL(url).hostname;
+        for (const domain of AD_BLOCK_DOMAINS) {
+            if (hostname === domain || hostname.endsWith("." + domain))
+                return true;
+        }
+    }
+    catch { }
+    return false;
+}
+function attachAdBlocker(context) {
+    if (!LEAP_AD_BLOCK)
+        return;
+    context.route("**/*", (route) => {
+        if (shouldBlockUrl(route.request().url())) {
+            route.abort("blockedbyclient").catch(() => { });
+        }
+        else {
+            route.fallback().catch(() => { });
+        }
+    });
+}
 const sessions = new SessionManager({
     maxSessions: MAX_SESSIONS,
     idleTimeoutMs: IDLE_TIMEOUT_MS,
@@ -88,6 +129,9 @@ if (LEAP_TILE && LEAP_TILE !== "false") {
     const defaultW = LEAP_SCREEN_WIDTH > 0 ? LEAP_SCREEN_WIDTH : detectedScreen?.width ?? 1920;
     const defaultH = LEAP_SCREEN_HEIGHT > 0 ? LEAP_SCREEN_HEIGHT : detectedScreen?.height ?? 1080;
     tilesCoord = new TilesCoordinator(defaultW, defaultH);
+    // Purge ALL slots not owned by this process — handles zombie PIDs
+    // from /mcp reconnects where old node process lingers alive.
+    tilesCoord.purgeOtherPids().catch(() => { });
     // File watcher only needed for multi-terminal mode (multiple Leapfrog instances).
     // In single-instance mode, the watcher causes spurious reflows that fight
     // with external monitor positioning. Only enable when explicitly requested.
@@ -325,6 +369,9 @@ server.registerTool("session_create", {
         }
         // Always inject intervention detection (lightweight MutationObserver)
         await session.context.addInitScript(getDetectionInitScript());
+        // Agent eyes — cursor dot + scroll indicator (zero Node overhead, listens to native DOM events)
+        await session.context.addInitScript(getAgentEyesInitScript());
+        attachAdBlocker(session.context);
         // Start tracing if enabled
         if (LEAP_TRACE) {
             await session.context.tracing.start({ screenshots: true, snapshots: true });
@@ -382,6 +429,8 @@ server.registerTool("session_create_batch", {
                 if (LEAP_AUTO_CONSENT)
                     await session.context.addInitScript(getConsentDismissScript());
                 await session.context.addInitScript(getDetectionInitScript());
+                await session.context.addInitScript(getAgentEyesInitScript());
+                attachAdBlocker(session.context);
                 if (LEAP_TRACE)
                     await session.context.tracing.start({ screenshots: true, snapshots: true });
                 // Claim tile slot (without triggering reflow yet — watcher handles it)
@@ -418,7 +467,7 @@ server.registerTool("session_create_batch", {
                         return;
                     }
                     await session.page.goto(spec.url, {
-                        waitUntil: spec.waitUntil || "load",
+                        waitUntil: spec.waitUntil || "domcontentloaded",
                         timeout: 30000,
                     });
                     results.push({ id: session.id, url: spec.url });
@@ -627,7 +676,7 @@ server.registerTool("navigate", {
         url: z.string().describe("Full URL including https://"),
         waitUntil: z
             .enum(["load", "domcontentloaded", "networkidle"])
-            .default("load")
+            .default("domcontentloaded")
             .describe("Wait strategy. Use networkidle for SPAs."),
         autoRetry: z
             .boolean()

package/dist/session-hud.d.ts

@@ -16,5 +16,11 @@ export declare function getClickRippleScript(x: number, y: number): string;
  */
 export declare function getScrollToTargetZoomIn(selector: string): string;
 export declare function getScrollToTargetZoomOut(selector: string): string;
+/**
+ * Returns JS to inject cursor tracking + scroll indicator for headed sessions.
+ * Always-on for headed mode — not gated by LEAP_HUD.
+ * Zero Node.js overhead: listens to native DOM events dispatched by Playwright.
+ */
+export declare function getAgentEyesInitScript(): string;
 /** Legacy single-call version (sync scroll only, no zoom). */
 export declare function getScrollToTargetScript(selector: string): string;

package/dist/session-hud.js

@@ -79,6 +79,7 @@ export function getHUDInitScript(sessionName) {
     container.appendChild(ripple);
     ripple.addEventListener('animationend', function() { ripple.remove(); });
   };
+
 })();`;
 }
 // ─── Live Update Scripts ───────────────────────────────────────────────────
@@ -124,6 +125,117 @@ export function getScrollToTargetZoomOut(selector) {
   }
 })()`;
 }
+// ─── Agent Eyes Init Script ───────────────────────────────────────────────
+/**
+ * Returns JS to inject cursor tracking + scroll indicator for headed sessions.
+ * Always-on for headed mode — not gated by LEAP_HUD.
+ * Zero Node.js overhead: listens to native DOM events dispatched by Playwright.
+ */
+export function getAgentEyesInitScript() {
+    return `(function() {
+  if (window.__leapfrog_eyes_initialized) return;
+  window.__leapfrog_eyes_initialized = true;
+
+  function init() {
+    // ── CSS ──────────────────────────────────────────────────────────
+    var style = document.createElement('style');
+    style.setAttribute('data-leapfrog', 'true');
+    style.textContent = \`
+      #leapfrog-cursor {
+        position: fixed;
+        width: 20px;
+        height: 20px;
+        border-radius: 50%;
+        background: rgba(34, 197, 94, 0.8);
+        box-shadow: 0 0 12px rgba(34, 197, 94, 0.5), 0 0 4px rgba(34, 197, 94, 0.8);
+        pointer-events: none;
+        z-index: 2147483646;
+        transform: translate(-50%, -50%);
+        transition: left 0.04s linear, top 0.04s linear, opacity 0.3s ease;
+        opacity: 0;
+      }
+      #leapfrog-cursor-ring {
+        position: fixed;
+        width: 36px;
+        height: 36px;
+        border-radius: 50%;
+        border: 2px solid rgba(34, 197, 94, 0.4);
+        pointer-events: none;
+        z-index: 2147483646;
+        transform: translate(-50%, -50%);
+        transition: left 0.08s ease-out, top 0.08s ease-out, opacity 0.3s ease;
+        opacity: 0;
+      }
+      #leapfrog-scroll-indicator {
+        position: fixed;
+        right: 16px;
+        top: 50%;
+        width: 36px;
+        height: 36px;
+        border-radius: 50%;
+        background: rgba(34, 197, 94, 0.7);
+        color: #fff;
+        font-size: 20px;
+        line-height: 36px;
+        text-align: center;
+        pointer-events: none;
+        z-index: 2147483646;
+        opacity: 0;
+        transition: opacity 0.15s ease-out;
+        transform: translateY(-50%);
+      }
+    \`;
+    (document.head || document.documentElement).appendChild(style);
+
+    // ── Agent Cursor (dot + trailing ring) ──────────────────────────
+    var cursor = document.createElement('div');
+    cursor.id = 'leapfrog-cursor';
+    cursor.setAttribute('data-leapfrog', 'true');
+    (document.body || document.documentElement).appendChild(cursor);
+
+    var ring = document.createElement('div');
+    ring.id = 'leapfrog-cursor-ring';
+    ring.setAttribute('data-leapfrog', 'true');
+    (document.body || document.documentElement).appendChild(ring);
+
+    var cursorTimeout;
+    document.addEventListener('mousemove', function(e) {
+      cursor.style.left = e.clientX + 'px';
+      cursor.style.top = e.clientY + 'px';
+      cursor.style.opacity = '1';
+      ring.style.left = e.clientX + 'px';
+      ring.style.top = e.clientY + 'px';
+      ring.style.opacity = '1';
+      clearTimeout(cursorTimeout);
+      cursorTimeout = setTimeout(function() {
+        cursor.style.opacity = '0';
+        ring.style.opacity = '0';
+      }, 3000);
+    }, true);
+
+    // ── Scroll Indicator ────────────────────────────────────────────
+    var scrollArrow = document.createElement('div');
+    scrollArrow.id = 'leapfrog-scroll-indicator';
+    scrollArrow.setAttribute('data-leapfrog', 'true');
+    (document.body || document.documentElement).appendChild(scrollArrow);
+
+    var scrollFadeTimeout;
+    document.addEventListener('wheel', function(e) {
+      scrollArrow.textContent = e.deltaY > 0 ? '\\u25BC' : '\\u25B2';
+      scrollArrow.style.opacity = '1';
+      clearTimeout(scrollFadeTimeout);
+      scrollFadeTimeout = setTimeout(function() { scrollArrow.style.opacity = '0'; }, 400);
+    }, true);
+  }
+
+  // Defer until body exists — init scripts can run before DOM is ready
+  if (document.body) {
+    init();
+  } else {
+    document.addEventListener('DOMContentLoaded', init);
+  }
+})();`;
+}
 /** Legacy single-call version (sync scroll only, no zoom). */
 export function getScrollToTargetScript(selector) {
     const escaped = selector.replace(/\\/g, "\\\\").replace(/'/g, "\\'");

package/dist/tiles-coordinator.d.ts

@@ -87,6 +87,12 @@ export declare class TilesCoordinator {
      * @returns Session IDs of the reaped (dead) slots.
      */
     reapDeadSlots(): Promise<string[]>;
+    /**
+     * Purge all slots NOT owned by the current process.pid.
+     * Called on startup to clear ghost slots from previous instances
+     * that may still be alive (e.g., after /mcp reconnect).
+     */
+    purgeOtherPids(): Promise<number>;
     /**
      * Watch `tiles.json` for changes made by other instances.
      * The callback fires with the new state whenever the file changes.

package/dist/tiles-coordinator.js

@@ -283,6 +283,23 @@ export class TilesCoordinator {
             return deadIds;
         });
     }
+    /**
+     * Purge all slots NOT owned by the current process.pid.
+     * Called on startup to clear ghost slots from previous instances
+     * that may still be alive (e.g., after /mcp reconnect).
+     */
+    async purgeOtherPids() {
+        return withLock(async () => {
+            const state = readState(this.screenWidth, this.screenHeight);
+            const before = state.slots.length;
+            state.slots = state.slots.filter((s) => s.instancePid === process.pid);
+            if (state.slots.length !== before) {
+                recalculatePositions(state);
+                writeState(state);
+            }
+            return before - state.slots.length;
+        });
+    }
     /**
      * Watch `tiles.json` for changes made by other instances.
      * The callback fires with the new state whenever the file changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leapfrog-mcp",
-  "version": "0.6.9",
+  "version": "0.7.1",
   "description": "Multi-session browser MCP for AI agents — 36 tools, stealth, persistent auth, code-first scripts, API sniffer, agent intelligence",
   "type": "module",
   "main": "dist/index.js",