leapfrog-mcp 0.6.8 → 0.7.0

package/dist/index.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,7 @@ server.registerTool("session_create", {
         }
         // Always inject intervention detection (lightweight MutationObserver)
         await session.context.addInitScript(getDetectionInitScript());
+        attachAdBlocker(session.context);
         // Start tracing if enabled
         if (LEAP_TRACE) {
             await session.context.tracing.start({ screenshots: true, snapshots: true });
@@ -382,6 +427,7 @@ server.registerTool("session_create_batch", {
                 if (LEAP_AUTO_CONSENT)
                     await session.context.addInitScript(getConsentDismissScript());
                 await session.context.addInitScript(getDetectionInitScript());
+                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 +464,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 +673,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-manager.js

@@ -8,7 +8,7 @@ import { generateFingerprint } from "./humanize-fingerprint.js";
 import { isHumanizeEnabled } from "./humanize-utils.js";
 import { CdpConnector } from "./cdp-connector.js";
 import { installSSRFRouteGuard } from "./ssrf.js";
-import { tileManager } from "./tile-manager.js";
+import { tileManager, TileManager } from "./tile-manager.js";
 import * as fs from "fs/promises";
 import * as path from "path";
 import * as os from "os";
@@ -565,13 +565,27 @@ export class SessionManager {
         // Record the screen assignment so reflowAll keeps it on this screen.
         if (isHeaded && !cdpConnected && detectedScreen) {
             tileManager.assignSessionScreen(id, detectedScreen);
+            // Lock viewport for sessions with explicitly-set viewport so reflow
+            // doesn't override it. Unlocked sessions get dynamic viewport sync.
+            if (opts?.viewport) {
+                tileManager.lockViewport(id);
+            }
+            const initialBounds = {
+                x: detectedScreen.x,
+                y: detectedScreen.y,
+                width: Math.min(1280, detectedScreen.width),
+                height: Math.min(720, detectedScreen.height),
+            };
             try {
-                await tileManager.positionWindowWithBounds(page, id, {
-                    x: detectedScreen.x,
-                    y: detectedScreen.y,
-                    width: Math.min(1280, detectedScreen.width),
-                    height: Math.min(720, detectedScreen.height),
-                });
+                await tileManager.positionWindowWithBounds(page, id, initialBounds);
+                // Dynamic viewport sync on initial placement
+                if (!opts?.viewport) {
+                    const viewport = TileManager.calculateViewportFromBounds(initialBounds);
+                    try {
+                        await page.setViewportSize(viewport);
+                    }
+                    catch { }
+                }
             }
             catch (e) {
                 logger.warn("tile.position_failed", { error: e.message });

package/dist/tile-manager.d.ts

@@ -30,6 +30,10 @@ declare class TileManager {
     private windowIds;
     /** Per-session screen assignment — windows stay on the screen where they were created. */
     private sessionScreens;
+    /** Sessions with explicitly-set viewports — reflow won't override these. */
+    private viewportLocked;
+    /** Chrome UI height (tabs, address bar, bookmarks). Subtracted from tile height to get content area. */
+    static CHROME_HEIGHT: number;
     configure(opts: {
         layout: TileLayout;
         padding: number;
@@ -79,6 +83,15 @@ declare class TileManager {
         globalIndex: number;
     }): string[];
     positionWindow(page: Page, sessionId: string): Promise<void>;
+    /** Calculate the page viewport that fits inside a window of the given bounds. */
+    static calculateViewportFromBounds(bounds: TileBounds): {
+        width: number;
+        height: number;
+    };
+    /** Lock a session's viewport so reflow won't override an explicitly-set viewport. */
+    lockViewport(sessionId: string): void;
+    /** Check if a session's viewport is locked. */
+    isViewportLocked(sessionId: string): boolean;
     /** Record which screen a session was placed on so reflows keep it there. */
     assignSessionScreen(sessionId: string, screen: ScreenWorkArea): void;
     /** Get the screen assigned to a session, or the current global screen. */

package/dist/tile-manager.js

@@ -4,7 +4,7 @@
 // Opt-in via LEAP_TILE=true|grid|master env var.
 //
 // Key design:
-//   - Viewport (screenshot resolution) stays at 1280x720 regardless of tile size
+//   - Viewport auto-syncs to tile size during reflow (dynamic viewport)
 //   - Screen detection via page.evaluate() on first headed session, cached
 //   - Accounts for macOS menu bar, Dock, and work area offset
 //   - Launch-time positioning via --window-position/--window-size Chrome args
@@ -23,6 +23,10 @@ class TileManager {
     windowIds = new Map();
     /** Per-session screen assignment — windows stay on the screen where they were created. */
     sessionScreens = new Map();
+    /** Sessions with explicitly-set viewports — reflow won't override these. */
+    viewportLocked = new Set();
+    /** Chrome UI height (tabs, address bar, bookmarks). Subtracted from tile height to get content area. */
+    static CHROME_HEIGHT = process.platform === "darwin" ? 72 : 85;
     // ── Configuration ──────────────────────────────────────────────────
     configure(opts) {
         this.enabled = true;
@@ -317,6 +321,21 @@ if (found) { found; } else {
         // This is a low-level primitive; reflowAll calls it with correct bounds.
         logger.debug("tile.position_window", { sessionId });
     }
+    /** Calculate the page viewport that fits inside a window of the given bounds. */
+    static calculateViewportFromBounds(bounds) {
+        return {
+            width: Math.max(bounds.width, 400),
+            height: Math.max(bounds.height - TileManager.CHROME_HEIGHT, 200),
+        };
+    }
+    /** Lock a session's viewport so reflow won't override an explicitly-set viewport. */
+    lockViewport(sessionId) {
+        this.viewportLocked.add(sessionId);
+    }
+    /** Check if a session's viewport is locked. */
+    isViewportLocked(sessionId) {
+        return this.viewportLocked.has(sessionId);
+    }
     /** Record which screen a session was placed on so reflows keep it there. */
     assignSessionScreen(sessionId, screen) {
         this.sessionScreens.set(sessionId, screen);
@@ -386,6 +405,18 @@ if (found) { found; } else {
                 if (!page || page.isClosed())
                     return;
                 await this.positionWindowWithBounds(page, id, bounds);
+                // Dynamic viewport sync — resize page viewport to match tile content area.
+                // Skip sessions where user explicitly set a viewport (viewport-locked).
+                if (!this.viewportLocked.has(id)) {
+                    const viewport = TileManager.calculateViewportFromBounds(bounds);
+                    try {
+                        await page.setViewportSize(viewport);
+                        logger.debug("tile.viewport_synced", { id, ...viewport });
+                    }
+                    catch {
+                        // Viewport sync is non-fatal
+                    }
+                }
             });
         }));
         // Bring all windows to front after positioning
@@ -416,6 +447,7 @@ if (found) { found; } else {
     removeSession(sessionId) {
         this.windowIds.delete(sessionId);
         this.sessionScreens.delete(sessionId);
+        this.viewportLocked.delete(sessionId);
     }
 }
 export const tileManager = new TileManager();

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.8",
+  "version": "0.7.0",
   "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",