leapfrog-mcp 0.6.8 → 0.6.9

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leapfrog-mcp",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "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",