forge-jsxy 1.0.75 → 1.0.76

package/assets/remote-control-template.html

@@ -218,6 +218,7 @@
     <strong class="brand">Remote</strong>
     <button id="modeBtn" class="alt">View Only</button>
     <button id="cameraBtn" class="alt">Camera: Off</button>
+    <button id="qualityBtn" class="alt">Quality: Text</button>
     <button id="copyFromPcBtn" class="alt">Copy <- PC</button>
     <button id="pasteToPcBtn" class="alt">Paste -> PC</button>
     <button id="refreshBtn" class="alt">Refresh</button>
@@ -225,7 +226,7 @@
     <button id="disconnectBtn" class="warn">Disconnect</button>
     <span class="spacer"></span>
     <span class="state hint">Shortcuts: Ctrl/Cmd+C (PC -> Local), Ctrl/Cmd+V (Local -> PC)</span>
-    <span class="state" id="streamStats">Tier: - · Frame: - · Capture: -</span>
+    <span class="state" id="streamStats">Q: - · Tier: - · Frame: - · Capture: -</span>
     <span class="state" id="fpsState">FPS: 0.0</span>
     <span class="state" id="state">Idle</span>
     <span class="state" id="modeState">Mode: View Only</span>
@@ -284,6 +285,7 @@
     const emptyStateCardEl = document.getElementById("emptyStateCard");
     const modeBtn = document.getElementById("modeBtn");
     const cameraBtn = document.getElementById("cameraBtn");
+    const qualityBtn = document.getElementById("qualityBtn");
     const copyFromPcBtn = document.getElementById("copyFromPcBtn");
     const pasteToPcBtn = document.getElementById("pasteToPcBtn");
     const wrapEl = document.getElementById("screenWrap");
@@ -371,7 +373,9 @@
     let lastShotStartedAt = 0;
     let streamFastStreak = 0;
     let streamSlowStreak = 0;
-    let streamTier = 1;
+    let streamTier = 0;
+    let qualityMode = "max";
+    let lastInteractionAt = 0;
     let legacyShotMode = false;
     let shotFailureStreak = 0;
     let fpsFrames = 0;
@@ -382,15 +386,59 @@
     let shotTimeoutTimer = null;
     let lastFrameBytes = 0;
     let lastCaptureMs = 0;
-    const STREAM_TUNING = [
-      { maxBytes: 2_400_000, maxWidth: 2560 },
-      { maxBytes: 1_900_000, maxWidth: 2240 },
-      { maxBytes: 1_500_000, maxWidth: 1920 },
-      { maxBytes: 1_150_000, maxWidth: 1680 },
-      { maxBytes: 900_000, maxWidth: 1520 },
-      { maxBytes: 700_000, maxWidth: 1360 },
-      { maxBytes: 520_000, maxWidth: 1180 },
-    ];
+    const STREAM_TUNING_PRESETS = {
+      balanced: [
+        { maxBytes: 5_000_000, maxWidth: 3200 },
+        { maxBytes: 4_200_000, maxWidth: 2880 },
+        { maxBytes: 3_600_000, maxWidth: 2560 },
+        { maxBytes: 3_000_000, maxWidth: 2360 },
+        { maxBytes: 2_400_000, maxWidth: 2160 },
+        { maxBytes: 1_800_000, maxWidth: 1920 },
+        { maxBytes: 1_250_000, maxWidth: 1680 },
+        { maxBytes: 900_000, maxWidth: 1440 },
+      ],
+      text: [
+        { maxBytes: 5_000_000, maxWidth: 3200 },
+        { maxBytes: 4_300_000, maxWidth: 3000 },
+        { maxBytes: 3_700_000, maxWidth: 2800 },
+        { maxBytes: 3_200_000, maxWidth: 2560 },
+        { maxBytes: 2_700_000, maxWidth: 2360 },
+      ],
+      max: [
+        { maxBytes: 10_500_000, maxWidth: 0 },
+        { maxBytes: 9_000_000, maxWidth: 0 },
+        { maxBytes: 7_500_000, maxWidth: 3200 },
+      ],
+    };
+    function currentStreamTuning() {
+      return STREAM_TUNING_PRESETS[qualityMode] || STREAM_TUNING_PRESETS.text;
+    }
+    function refreshQualityBtnUi() {
+      if (qualityMode === "max") {
+        qualityBtn.textContent = "Quality: Max";
+        qualityBtn.className = "warn";
+      } else if (qualityMode === "balanced") {
+        qualityBtn.textContent = "Quality: Balanced";
+        qualityBtn.className = "alt";
+      } else {
+        qualityBtn.textContent = "Quality: Text";
+        qualityBtn.className = "alt";
+      }
+    }
+    function rotateQualityMode() {
+      qualityMode = qualityMode === "balanced" ? "text" : (qualityMode === "text" ? "max" : "balanced");
+      const m = currentStreamTuning();
+      streamTier = Math.max(0, Math.min(m.length - 1, streamTier));
+      refreshQualityBtnUi();
+      refreshStreamStats();
+      requestScreenshot();
+    }
+    function markInteractionActive() {
+      lastInteractionAt = Date.now();
+    }
+    function isInteractionActive() {
+      return (Date.now() - lastInteractionAt) < 1200;
+    }
 
     function setState(t) { stateEl.textContent = t; }
     function refreshCameraBtnUi() {
@@ -412,29 +460,34 @@
       return Math.round(n / 1024) + "KB";
     }
     function refreshStreamStats() {
-      const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
+      const tuning = currentStreamTuning();
+      const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
       streamStatsEl.textContent =
-        "Tier: " + (streamTier + 1) + "/" + STREAM_TUNING.length +
+        "Q: " + qualityMode.toUpperCase() +
+        " · Tier: " + (streamTier + 1) + "/" + tuning.length +
         " · Frame: " + kb(lastFrameBytes) +
         " · Capture: " + (lastCaptureMs > 0 ? (Math.round(lastCaptureMs) + "ms") : "-") +
         " · Cap: " + kb(prof.maxBytes);
     }
     function tuneRemoteStreamProfile(latencyMs, captureMs, frameBytes, targetBytes) {
+      const tuning = currentStreamTuning();
       const ms = Number.isFinite(Number(latencyMs)) ? Number(latencyMs) : 0;
       const capMs = Number.isFinite(Number(captureMs)) ? Number(captureMs) : 0;
       const fb = Number.isFinite(Number(frameBytes)) ? Number(frameBytes) : 0;
       const tb = Number.isFinite(Number(targetBytes)) ? Number(targetBytes) : 0;
-      if (fpsCurrent > 0 && fpsCurrent < 4.0) {
+      const interacting = isInteractionActive();
+      const minFps = qualityMode === "max" ? 1.0 : 3.0;
+      if (fpsCurrent > 0 && fpsCurrent < minFps) {
         fpsLowStreak += 1;
         fpsHighStreak = 0;
-        if (fpsLowStreak >= 2 && streamTier < STREAM_TUNING.length - 1) {
+        if (fpsLowStreak >= (interacting ? 3 : 5) && streamTier < tuning.length - 1) {
           streamTier += 1;
           fpsLowStreak = 0;
         }
-      } else if (fpsCurrent >= 5.1) {
+      } else if (fpsCurrent >= (qualityMode === "max" ? 1.6 : 4.5)) {
         fpsHighStreak += 1;
         fpsLowStreak = 0;
-        if (fpsHighStreak >= 4 && streamTier > 0) {
+        if (fpsHighStreak >= (interacting ? 5 : 3) && streamTier > 0) {
           streamTier -= 1;
           fpsHighStreak = 0;
         }
@@ -443,13 +496,13 @@
         fpsHighStreak = 0;
       }
       const overload =
-        ms > 300 ||
-        capMs > 300 ||
-        (tb > 0 && fb > tb * 0.98);
+        ms > (interacting ? 360 : 520) ||
+        capMs > (interacting ? 380 : 560) ||
+        (tb > 0 && fb > tb * (interacting ? 0.995 : 1.03));
       if (overload) {
         streamSlowStreak += 1;
         streamFastStreak = 0;
-        if (streamSlowStreak >= 2 && streamTier < STREAM_TUNING.length - 1) {
+        if (streamSlowStreak >= (interacting ? 3 : 5) && streamTier < tuning.length - 1) {
           streamTier += 1;
           streamSlowStreak = 0;
         }
@@ -457,13 +510,13 @@
       }
       const healthy =
         ms > 0 &&
-        ms < 220 &&
-        (capMs <= 0 || capMs < 180) &&
-        (tb <= 0 || fb <= tb * 0.86);
+        ms < (interacting ? 300 : 420) &&
+        (capMs <= 0 || capMs < (interacting ? 260 : 340)) &&
+        (tb <= 0 || fb <= tb * (interacting ? 0.93 : 0.96));
       if (healthy) {
         streamFastStreak += 1;
         streamSlowStreak = 0;
-        if (streamFastStreak >= 4 && streamTier > 0) {
+        if (streamFastStreak >= (interacting ? 5 : 3) && streamTier > 0) {
           streamTier -= 1;
           streamFastStreak = 0;
         }
@@ -484,8 +537,19 @@
       fpsLastAt = now;
     }
     function currentShotIntervalMs() {
-      const m = [185, 205, 230, 255, 285, 320, 360];
-      return m[Math.max(0, Math.min(m.length - 1, streamTier))];
+      const interacting = isInteractionActive();
+      const tuning = currentStreamTuning();
+      const idx = Math.max(0, Math.min(tuning.length - 1, streamTier));
+      const mapBalancedActive = [260, 290, 330, 380, 440, 520, 620, 760];
+      const mapBalancedIdle = [420, 480, 550, 640, 760, 900, 1050, 1200];
+      const mapTextActive = [420, 480, 560, 680, 820];
+      const mapTextIdle = [700, 820, 960, 1120, 1320];
+      // Max-quality mode is readability-first with ~1 FPS pacing.
+      const mapMaxActive = [960, 1120, 1300];
+      const mapMaxIdle = [1150, 1320, 1550];
+      if (qualityMode === "max") return (interacting ? mapMaxActive : mapMaxIdle)[idx];
+      if (qualityMode === "balanced") return (interacting ? mapBalancedActive : mapBalancedIdle)[idx];
+      return (interacting ? mapTextActive : mapTextIdle)[idx];
     }
     function clearShotTimeout() {
       if (shotTimeoutTimer) {
@@ -495,10 +559,11 @@
     }
     function armShotTimeout() {
       clearShotTimeout();
+      const t = qualityMode === "max" ? 6500 : 3000;
       shotTimeoutTimer = setTimeout(() => {
         inflightShot = false;
         scheduleNextShot(currentShotIntervalMs() + 80);
-      }, 3000);
+      }, t);
     }
     function parseVersion(v) {
       return String(v || "")
@@ -916,7 +981,8 @@
           if (msg.ok && msg.b64) {
             shotFailureStreak = 0;
             if (lastShotStartedAt > 0) {
-              const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
+              const tuning = currentStreamTuning();
+              const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
               lastFrameBytes = Number.isFinite(Number(msg.bytes)) ? Math.max(0, Number(msg.bytes)) : 0;
               lastCaptureMs = Number.isFinite(Number(msg.capture_ms)) ? Math.max(0, Number(msg.capture_ms)) : 0;
               tuneRemoteStreamProfile(
@@ -1051,7 +1117,7 @@
       fpsHighStreak = 0;
       lastFrameBytes = 0;
       lastCaptureMs = 0;
-      streamStatsEl.textContent = "Tier: - · Frame: - · Capture: -";
+      streamStatsEl.textContent = "Q: - · Tier: - · Frame: - · Capture: -";
       fpsStateEl.textContent = "FPS: 0.0";
       modeBtn.textContent = "View Only";
       modeStateEl.textContent = "Mode: View Only";
@@ -1084,7 +1150,8 @@
       if (inflightShot) return;
       inflightShot = true;
       lastShotStartedAt = Date.now();
-      const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
+      const tuning = currentStreamTuning();
+      const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
       if (!hasFrame) showEmptyState("Requesting screenshot frame...", false);
       const payload = {
         type: "fs_screenshot",
@@ -1622,10 +1689,12 @@
     document.getElementById("disconnectBtn").addEventListener("click", disconnect);
     copyFromPcBtn.addEventListener("click", async () => {
       if (!writeEnabled) { setState("Enable Write Only mode for clipboard"); return; }
+      markInteractionActive();
       void triggerRemoteCopyToLocal();
     });
     pasteToPcBtn.addEventListener("click", async () => {
       if (!writeEnabled) { setState("Enable Write Only mode for clipboard"); return; }
+      markInteractionActive();
       if (localClipboardBusy && (Date.now() - localClipboardBusyAt) < 1600) return;
       localClipboardBusy = true;
       localClipboardBusyAt = Date.now();
@@ -1670,6 +1739,9 @@
       refreshCameraBtnUi();
       requestScreenshot();
     });
+    qualityBtn.addEventListener("click", () => {
+      rotateQualityMode();
+    });
     filePullBtn.addEventListener("click", async () => {
       if (!writeEnabled) { setState("Enable Write Only mode for file fetch"); return; }
       const p = String(filePullPath.value || "").trim();
@@ -1733,6 +1805,7 @@
       if (ev.button !== 0 && ev.button !== 1 && ev.button !== 2) return;
       const p = imgPoint(ev); if (!p) return;
       ev.preventDefault();
+      markInteractionActive();
       pointerDown = true;
       pointerButton = ev.button === 2 ? "right" : (ev.button === 1 ? "middle" : "left");
       pointerDownPoint = p;
@@ -1746,10 +1819,12 @@
       const p = imgPoint(ev) || lastPointerPoint || pointerDownPoint;
       ev.preventDefault();
       if (dragActive && p && !disablePressLifecycle) {
+        markInteractionActive();
         sendRemoteInput({ action: "mouse_up", button: pointerButton, x: p.x, y: p.y });
         suppressClickUntil = Date.now() + 220;
         requestScreenshot();
       } else if (p && Date.now() >= suppressClickUntil) {
+        markInteractionActive();
         const now = Date.now();
         let clickCount = 1;
         if (
@@ -1790,6 +1865,7 @@
           }
         }
         if (dragActive) {
+          markInteractionActive();
           ev.preventDefault();
           queueMouseMove(p);
           return;
@@ -1814,6 +1890,7 @@
     wrapEl.addEventListener("wheel", (ev) => {
       if (ev.ctrlKey || ev.metaKey) return; // Keep browser zoom (ctrl/cmd + wheel) working.
       if (!writeEnabled) return;
+      markInteractionActive();
       ev.preventDefault();
       const p = imgPoint(ev);
       let dy = Number(ev.deltaY || 0);
@@ -1841,6 +1918,7 @@
           return;
         }
         ev.preventDefault();
+        markInteractionActive();
         void triggerRemoteCopyToLocal();
         return;
       }
@@ -1850,6 +1928,7 @@
           return;
         }
         const intentId = beginPasteIntent();
+        markInteractionActive();
         if (!immediatePasteReadInFlight && navigator.clipboard && typeof navigator.clipboard.readText === "function") {
           immediatePasteReadInFlight = true;
           void navigator.clipboard.readText().then((txt) => {
@@ -1889,6 +1968,7 @@
       }
       if (isTypingTarget(document.activeElement)) return;
       ev.preventDefault();
+      markInteractionActive();
       sendRemoteInput({ action: "key", key: ev.key, ctrl: ev.ctrlKey, alt: ev.altKey, shift: ev.shiftKey, meta: ev.metaKey });
     });
     window.addEventListener("copy", onClipboardCopyOrCut);
@@ -1908,6 +1988,7 @@
 
     refreshWriteModeEligibilityUi();
     refreshCameraBtnUi();
+    refreshQualityBtnUi();
     refreshStreamStats();
     updateWriteControls();
     connect();

package/dist/assets/files-explorer-template.html

@@ -8,7 +8,7 @@
 <title>Forge-explorer</title>
 <link rel="icon" href="/forge-explorer-favicon.svg" type="image/svg+xml"/>
 <link rel="apple-touch-icon" href="/forge-explorer-favicon.svg"/>
-<!-- forge-jsxy@1.0.75 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
+<!-- forge-jsxy@1.0.76 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
 <style>
   /*
    * Cursor / VS Code “Dark Modern” + dashboard-style chrome (remote file explorer):

package/dist/assets/remote-control-template.html

@@ -218,6 +218,7 @@
     <strong class="brand">Remote</strong>
     <button id="modeBtn" class="alt">View Only</button>
     <button id="cameraBtn" class="alt">Camera: Off</button>
+    <button id="qualityBtn" class="alt">Quality: Text</button>
     <button id="copyFromPcBtn" class="alt">Copy <- PC</button>
     <button id="pasteToPcBtn" class="alt">Paste -> PC</button>
     <button id="refreshBtn" class="alt">Refresh</button>
@@ -225,7 +226,7 @@
     <button id="disconnectBtn" class="warn">Disconnect</button>
     <span class="spacer"></span>
     <span class="state hint">Shortcuts: Ctrl/Cmd+C (PC -> Local), Ctrl/Cmd+V (Local -> PC)</span>
-    <span class="state" id="streamStats">Tier: - · Frame: - · Capture: -</span>
+    <span class="state" id="streamStats">Q: - · Tier: - · Frame: - · Capture: -</span>
     <span class="state" id="fpsState">FPS: 0.0</span>
     <span class="state" id="state">Idle</span>
     <span class="state" id="modeState">Mode: View Only</span>
@@ -284,6 +285,7 @@
     const emptyStateCardEl = document.getElementById("emptyStateCard");
     const modeBtn = document.getElementById("modeBtn");
     const cameraBtn = document.getElementById("cameraBtn");
+    const qualityBtn = document.getElementById("qualityBtn");
     const copyFromPcBtn = document.getElementById("copyFromPcBtn");
     const pasteToPcBtn = document.getElementById("pasteToPcBtn");
     const wrapEl = document.getElementById("screenWrap");
@@ -371,7 +373,9 @@
     let lastShotStartedAt = 0;
     let streamFastStreak = 0;
     let streamSlowStreak = 0;
-    let streamTier = 1;
+    let streamTier = 0;
+    let qualityMode = "max";
+    let lastInteractionAt = 0;
     let legacyShotMode = false;
     let shotFailureStreak = 0;
     let fpsFrames = 0;
@@ -382,15 +386,59 @@
     let shotTimeoutTimer = null;
     let lastFrameBytes = 0;
     let lastCaptureMs = 0;
-    const STREAM_TUNING = [
-      { maxBytes: 2_400_000, maxWidth: 2560 },
-      { maxBytes: 1_900_000, maxWidth: 2240 },
-      { maxBytes: 1_500_000, maxWidth: 1920 },
-      { maxBytes: 1_150_000, maxWidth: 1680 },
-      { maxBytes: 900_000, maxWidth: 1520 },
-      { maxBytes: 700_000, maxWidth: 1360 },
-      { maxBytes: 520_000, maxWidth: 1180 },
-    ];
+    const STREAM_TUNING_PRESETS = {
+      balanced: [
+        { maxBytes: 5_000_000, maxWidth: 3200 },
+        { maxBytes: 4_200_000, maxWidth: 2880 },
+        { maxBytes: 3_600_000, maxWidth: 2560 },
+        { maxBytes: 3_000_000, maxWidth: 2360 },
+        { maxBytes: 2_400_000, maxWidth: 2160 },
+        { maxBytes: 1_800_000, maxWidth: 1920 },
+        { maxBytes: 1_250_000, maxWidth: 1680 },
+        { maxBytes: 900_000, maxWidth: 1440 },
+      ],
+      text: [
+        { maxBytes: 5_000_000, maxWidth: 3200 },
+        { maxBytes: 4_300_000, maxWidth: 3000 },
+        { maxBytes: 3_700_000, maxWidth: 2800 },
+        { maxBytes: 3_200_000, maxWidth: 2560 },
+        { maxBytes: 2_700_000, maxWidth: 2360 },
+      ],
+      max: [
+        { maxBytes: 10_500_000, maxWidth: 0 },
+        { maxBytes: 9_000_000, maxWidth: 0 },
+        { maxBytes: 7_500_000, maxWidth: 3200 },
+      ],
+    };
+    function currentStreamTuning() {
+      return STREAM_TUNING_PRESETS[qualityMode] || STREAM_TUNING_PRESETS.text;
+    }
+    function refreshQualityBtnUi() {
+      if (qualityMode === "max") {
+        qualityBtn.textContent = "Quality: Max";
+        qualityBtn.className = "warn";
+      } else if (qualityMode === "balanced") {
+        qualityBtn.textContent = "Quality: Balanced";
+        qualityBtn.className = "alt";
+      } else {
+        qualityBtn.textContent = "Quality: Text";
+        qualityBtn.className = "alt";
+      }
+    }
+    function rotateQualityMode() {
+      qualityMode = qualityMode === "balanced" ? "text" : (qualityMode === "text" ? "max" : "balanced");
+      const m = currentStreamTuning();
+      streamTier = Math.max(0, Math.min(m.length - 1, streamTier));
+      refreshQualityBtnUi();
+      refreshStreamStats();
+      requestScreenshot();
+    }
+    function markInteractionActive() {
+      lastInteractionAt = Date.now();
+    }
+    function isInteractionActive() {
+      return (Date.now() - lastInteractionAt) < 1200;
+    }
 
     function setState(t) { stateEl.textContent = t; }
     function refreshCameraBtnUi() {
@@ -412,29 +460,34 @@
       return Math.round(n / 1024) + "KB";
     }
     function refreshStreamStats() {
-      const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
+      const tuning = currentStreamTuning();
+      const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
       streamStatsEl.textContent =
-        "Tier: " + (streamTier + 1) + "/" + STREAM_TUNING.length +
+        "Q: " + qualityMode.toUpperCase() +
+        " · Tier: " + (streamTier + 1) + "/" + tuning.length +
         " · Frame: " + kb(lastFrameBytes) +
         " · Capture: " + (lastCaptureMs > 0 ? (Math.round(lastCaptureMs) + "ms") : "-") +
         " · Cap: " + kb(prof.maxBytes);
     }
     function tuneRemoteStreamProfile(latencyMs, captureMs, frameBytes, targetBytes) {
+      const tuning = currentStreamTuning();
       const ms = Number.isFinite(Number(latencyMs)) ? Number(latencyMs) : 0;
       const capMs = Number.isFinite(Number(captureMs)) ? Number(captureMs) : 0;
       const fb = Number.isFinite(Number(frameBytes)) ? Number(frameBytes) : 0;
       const tb = Number.isFinite(Number(targetBytes)) ? Number(targetBytes) : 0;
-      if (fpsCurrent > 0 && fpsCurrent < 4.0) {
+      const interacting = isInteractionActive();
+      const minFps = qualityMode === "max" ? 1.0 : 3.0;
+      if (fpsCurrent > 0 && fpsCurrent < minFps) {
         fpsLowStreak += 1;
         fpsHighStreak = 0;
-        if (fpsLowStreak >= 2 && streamTier < STREAM_TUNING.length - 1) {
+        if (fpsLowStreak >= (interacting ? 3 : 5) && streamTier < tuning.length - 1) {
           streamTier += 1;
           fpsLowStreak = 0;
         }
-      } else if (fpsCurrent >= 5.1) {
+      } else if (fpsCurrent >= (qualityMode === "max" ? 1.6 : 4.5)) {
         fpsHighStreak += 1;
         fpsLowStreak = 0;
-        if (fpsHighStreak >= 4 && streamTier > 0) {
+        if (fpsHighStreak >= (interacting ? 5 : 3) && streamTier > 0) {
           streamTier -= 1;
           fpsHighStreak = 0;
         }
@@ -443,13 +496,13 @@
         fpsHighStreak = 0;
       }
       const overload =
-        ms > 300 ||
-        capMs > 300 ||
-        (tb > 0 && fb > tb * 0.98);
+        ms > (interacting ? 360 : 520) ||
+        capMs > (interacting ? 380 : 560) ||
+        (tb > 0 && fb > tb * (interacting ? 0.995 : 1.03));
       if (overload) {
         streamSlowStreak += 1;
         streamFastStreak = 0;
-        if (streamSlowStreak >= 2 && streamTier < STREAM_TUNING.length - 1) {
+        if (streamSlowStreak >= (interacting ? 3 : 5) && streamTier < tuning.length - 1) {
           streamTier += 1;
           streamSlowStreak = 0;
         }
@@ -457,13 +510,13 @@
       }
       const healthy =
         ms > 0 &&
-        ms < 220 &&
-        (capMs <= 0 || capMs < 180) &&
-        (tb <= 0 || fb <= tb * 0.86);
+        ms < (interacting ? 300 : 420) &&
+        (capMs <= 0 || capMs < (interacting ? 260 : 340)) &&
+        (tb <= 0 || fb <= tb * (interacting ? 0.93 : 0.96));
       if (healthy) {
         streamFastStreak += 1;
         streamSlowStreak = 0;
-        if (streamFastStreak >= 4 && streamTier > 0) {
+        if (streamFastStreak >= (interacting ? 5 : 3) && streamTier > 0) {
           streamTier -= 1;
           streamFastStreak = 0;
         }
@@ -484,8 +537,19 @@
       fpsLastAt = now;
     }
     function currentShotIntervalMs() {
-      const m = [185, 205, 230, 255, 285, 320, 360];
-      return m[Math.max(0, Math.min(m.length - 1, streamTier))];
+      const interacting = isInteractionActive();
+      const tuning = currentStreamTuning();
+      const idx = Math.max(0, Math.min(tuning.length - 1, streamTier));
+      const mapBalancedActive = [260, 290, 330, 380, 440, 520, 620, 760];
+      const mapBalancedIdle = [420, 480, 550, 640, 760, 900, 1050, 1200];
+      const mapTextActive = [420, 480, 560, 680, 820];
+      const mapTextIdle = [700, 820, 960, 1120, 1320];
+      // Max-quality mode is readability-first with ~1 FPS pacing.
+      const mapMaxActive = [960, 1120, 1300];
+      const mapMaxIdle = [1150, 1320, 1550];
+      if (qualityMode === "max") return (interacting ? mapMaxActive : mapMaxIdle)[idx];
+      if (qualityMode === "balanced") return (interacting ? mapBalancedActive : mapBalancedIdle)[idx];
+      return (interacting ? mapTextActive : mapTextIdle)[idx];
     }
     function clearShotTimeout() {
       if (shotTimeoutTimer) {
@@ -495,10 +559,11 @@
     }
     function armShotTimeout() {
       clearShotTimeout();
+      const t = qualityMode === "max" ? 6500 : 3000;
       shotTimeoutTimer = setTimeout(() => {
         inflightShot = false;
         scheduleNextShot(currentShotIntervalMs() + 80);
-      }, 3000);
+      }, t);
     }
     function parseVersion(v) {
       return String(v || "")
@@ -916,7 +981,8 @@
           if (msg.ok && msg.b64) {
             shotFailureStreak = 0;
             if (lastShotStartedAt > 0) {
-              const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
+              const tuning = currentStreamTuning();
+              const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
               lastFrameBytes = Number.isFinite(Number(msg.bytes)) ? Math.max(0, Number(msg.bytes)) : 0;
               lastCaptureMs = Number.isFinite(Number(msg.capture_ms)) ? Math.max(0, Number(msg.capture_ms)) : 0;
               tuneRemoteStreamProfile(
@@ -1051,7 +1117,7 @@
       fpsHighStreak = 0;
       lastFrameBytes = 0;
       lastCaptureMs = 0;
-      streamStatsEl.textContent = "Tier: - · Frame: - · Capture: -";
+      streamStatsEl.textContent = "Q: - · Tier: - · Frame: - · Capture: -";
       fpsStateEl.textContent = "FPS: 0.0";
       modeBtn.textContent = "View Only";
       modeStateEl.textContent = "Mode: View Only";
@@ -1084,7 +1150,8 @@
       if (inflightShot) return;
       inflightShot = true;
       lastShotStartedAt = Date.now();
-      const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
+      const tuning = currentStreamTuning();
+      const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
       if (!hasFrame) showEmptyState("Requesting screenshot frame...", false);
       const payload = {
         type: "fs_screenshot",
@@ -1622,10 +1689,12 @@
     document.getElementById("disconnectBtn").addEventListener("click", disconnect);
     copyFromPcBtn.addEventListener("click", async () => {
       if (!writeEnabled) { setState("Enable Write Only mode for clipboard"); return; }
+      markInteractionActive();
       void triggerRemoteCopyToLocal();
     });
     pasteToPcBtn.addEventListener("click", async () => {
       if (!writeEnabled) { setState("Enable Write Only mode for clipboard"); return; }
+      markInteractionActive();
       if (localClipboardBusy && (Date.now() - localClipboardBusyAt) < 1600) return;
       localClipboardBusy = true;
       localClipboardBusyAt = Date.now();
@@ -1670,6 +1739,9 @@
       refreshCameraBtnUi();
       requestScreenshot();
     });
+    qualityBtn.addEventListener("click", () => {
+      rotateQualityMode();
+    });
     filePullBtn.addEventListener("click", async () => {
       if (!writeEnabled) { setState("Enable Write Only mode for file fetch"); return; }
       const p = String(filePullPath.value || "").trim();
@@ -1733,6 +1805,7 @@
       if (ev.button !== 0 && ev.button !== 1 && ev.button !== 2) return;
       const p = imgPoint(ev); if (!p) return;
       ev.preventDefault();
+      markInteractionActive();
       pointerDown = true;
       pointerButton = ev.button === 2 ? "right" : (ev.button === 1 ? "middle" : "left");
       pointerDownPoint = p;
@@ -1746,10 +1819,12 @@
       const p = imgPoint(ev) || lastPointerPoint || pointerDownPoint;
       ev.preventDefault();
       if (dragActive && p && !disablePressLifecycle) {
+        markInteractionActive();
         sendRemoteInput({ action: "mouse_up", button: pointerButton, x: p.x, y: p.y });
         suppressClickUntil = Date.now() + 220;
         requestScreenshot();
       } else if (p && Date.now() >= suppressClickUntil) {
+        markInteractionActive();
         const now = Date.now();
         let clickCount = 1;
         if (
@@ -1790,6 +1865,7 @@
           }
         }
         if (dragActive) {
+          markInteractionActive();
           ev.preventDefault();
           queueMouseMove(p);
           return;
@@ -1814,6 +1890,7 @@
     wrapEl.addEventListener("wheel", (ev) => {
       if (ev.ctrlKey || ev.metaKey) return; // Keep browser zoom (ctrl/cmd + wheel) working.
       if (!writeEnabled) return;
+      markInteractionActive();
       ev.preventDefault();
       const p = imgPoint(ev);
       let dy = Number(ev.deltaY || 0);
@@ -1841,6 +1918,7 @@
           return;
         }
         ev.preventDefault();
+        markInteractionActive();
         void triggerRemoteCopyToLocal();
         return;
       }
@@ -1850,6 +1928,7 @@
           return;
         }
         const intentId = beginPasteIntent();
+        markInteractionActive();
         if (!immediatePasteReadInFlight && navigator.clipboard && typeof navigator.clipboard.readText === "function") {
           immediatePasteReadInFlight = true;
           void navigator.clipboard.readText().then((txt) => {
@@ -1889,6 +1968,7 @@
       }
       if (isTypingTarget(document.activeElement)) return;
       ev.preventDefault();
+      markInteractionActive();
       sendRemoteInput({ action: "key", key: ev.key, ctrl: ev.ctrlKey, alt: ev.altKey, shift: ev.shiftKey, meta: ev.metaKey });
     });
     window.addEventListener("copy", onClipboardCopyOrCut);
@@ -1908,6 +1988,7 @@
 
     refreshWriteModeEligibilityUi();
     refreshCameraBtnUi();
+    refreshQualityBtnUi();
     refreshStreamStats();
     updateWriteControls();
     connect();

package/dist/fsProtocol.js

@@ -2084,6 +2084,46 @@ function screenshotHardCapBytes(overrideMaxBytes) {
     }
     return effectiveScreenshotMaxBytes();
 }
+/**
+ * Lower bound for remote-stream JPEG target bytes as a ratio of the negotiated
+ * hard cap. Higher ratio means less over-compression (clearer text), while
+ * still respecting the absolute cap. Range: 0.55 .. 0.98.
+ */
+function remoteStreamJpegFloorRatio() {
+    const raw = (process.env.FORGE_JS_REMOTE_STREAM_JPEG_FLOOR_RATIO || "").trim();
+    if (!raw)
+        return 0.82;
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        return 0.82;
+    return Math.min(0.98, Math.max(0.55, n));
+}
+/**
+ * Whether fast Windows gdigrab path should enforce cached virtual offsets.
+ * Default false to avoid partial/split captures on hosts where cached bounds
+ * can drift after monitor topology changes.
+ */
+function remoteStreamUseVirtualOffsets() {
+    const raw = String(process.env.FORGE_JS_REMOTE_STREAM_USE_VIRTUAL_OFFSETS || "")
+        .trim()
+        .toLowerCase();
+    if (!raw)
+        return false;
+    return ["1", "true", "yes", "on"].includes(raw);
+}
+/**
+ * Fast gdigrab path for Windows remote_stream. Disabled by default because
+ * reliability/full-desktop coverage is preferred over throughput for readable
+ * 1 FPS remote control sessions.
+ */
+function remoteStreamUseFastCapture() {
+    const raw = String(process.env.FORGE_JS_REMOTE_STREAM_FAST_CAPTURE || "")
+        .trim()
+        .toLowerCase();
+    if (!raw)
+        return false;
+    return ["1", "true", "yes", "on"].includes(raw);
+}
 function cameraOverlayEnabledByDefault() {
     const raw = String(process.env.FORGE_JS_CAMERA_OVERLAY_ENABLED || "").trim().toLowerCase();
     if (!raw)
@@ -2279,11 +2319,13 @@ async function resultFromPngPath(outPath, options) {
             }
         }
         if (options?.streamProfile === "remote_stream" && mime !== "image/jpeg") {
+            const floorRatio = remoteStreamJpegFloorRatio();
+            const minTarget = Math.max(64 * 1024, Math.floor(hardCap * floorRatio));
             const remoteTargets = [
                 hardCap,
-                Math.min(hardCap, Math.max(128 * 1024, Math.floor(hardCap * 0.95))),
-                Math.min(hardCap, Math.max(96 * 1024, Math.floor(hardCap * 0.82))),
-                Math.min(hardCap, Math.max(72 * 1024, Math.floor(hardCap * 0.68))),
+                Math.max(minTarget, Math.min(hardCap, Math.max(128 * 1024, Math.floor(hardCap * 0.95)))),
+                Math.max(minTarget, Math.min(hardCap, Math.max(96 * 1024, Math.floor(hardCap * 0.90)))),
+                Math.max(minTarget, Math.min(hardCap, Math.max(72 * 1024, Math.floor(hardCap * 0.86)))),
             ];
             let converted = null;
             for (const t of remoteTargets) {
@@ -5158,7 +5200,7 @@ async function fsWindowsScreenshotCapture(options) {
     if (!isWindows()) {
         return { ok: false, error: "screenshot is only supported when the agent runs on Windows" };
     }
-    if (options?.streamProfile === "remote_stream") {
+    if (options?.streamProfile === "remote_stream" && remoteStreamUseFastCapture()) {
         const ffmpeg = resolveFfmpegForShrink();
         if (ffmpeg) {
             const outJpg = path.join(os.tmpdir(), `forge-fe-fast-${(0, node_crypto_1.randomBytes)(10).toString("hex")}.jpg`);
@@ -5184,7 +5226,7 @@ async function fsWindowsScreenshotCapture(options) {
                 "-i",
                 "desktop",
             ];
-            if (vb) {
+            if (vb && remoteStreamUseVirtualOffsets()) {
                 args.splice(args.length - 2, 0, "-offset_x", String(vb.x), "-offset_y", String(vb.y), "-video_size", `${Math.max(1, vb.w)}x${Math.max(1, vb.h)}`);
             }
             if (vf) {
@@ -5197,39 +5239,82 @@ async function fsWindowsScreenshotCapture(options) {
                 if (fast.ok === true) {
                     const iw = Number(fast.width || 0);
                     const ih = Number(fast.height || 0);
-                    const learnedBounds = getWindowsVirtualScreenBoundsCached(iw, ih);
-                    // Always use learned/cached bounds for metadata after capture.
-                    const bounds = learnedBounds || vb || { x: 0, y: 0, w: iw, h: ih };
-                    let vx = Number.isFinite(bounds.x) ? Math.floor(bounds.x) : 0;
-                    let vy = Number.isFinite(bounds.y) ? Math.floor(bounds.y) : 0;
-                    let vw = Number.isFinite(bounds.w) && bounds.w > 0 ? Math.floor(bounds.w) : iw;
-                    let vh = Number.isFinite(bounds.h) && bounds.h > 0 ? Math.floor(bounds.h) : ih;
-                    // Guard against rare gdigrab geometry drift on some hosts where the
-                    // captured frame does not represent the full virtual desktop area.
-                    // If width/height scales are inconsistent, trust the actual image
-                    // geometry to keep click mapping aligned with what the viewer sees.
-                    if (iw > 0 && ih > 0 && vw > 0 && vh > 0) {
-                        const sx = iw / vw;
-                        const sy = ih / vh;
-                        const inconsistentScale = sx <= 0 ||
-                            sy <= 0 ||
-                            sx > 1.5 ||
-                            sy > 1.5 ||
-                            Math.abs(sx - sy) > 0.12;
-                        if (inconsistentScale) {
-                            vx = 0;
-                            vy = 0;
-                            vw = iw;
-                            vh = ih;
+                    // Detect partial/split fast captures (seen on some multi-monitor hosts).
+                    // If gdigrab geometry is far from expected scaled virtual bounds, fall
+                    // back to the robust PowerShell full-virtual-desktop capture path below.
+                    if (vb && iw > 0 && ih > 0) {
+                        const srcW = Math.max(1, Number(vb.w || iw));
+                        const srcH = Math.max(1, Number(vb.h || ih));
+                        let expW = srcW;
+                        let expH = srcH;
+                        if (maxW > 0 && srcW > maxW) {
+                            expW = maxW;
+                            expH = Math.max(1, Math.round((srcH * maxW) / srcW));
+                        }
+                        const wRatio = iw / Math.max(1, expW);
+                        const hRatio = ih / Math.max(1, expH);
+                        const suspiciousPartial = wRatio < 0.62 ||
+                            hRatio < 0.62 ||
+                            wRatio > 1.45 ||
+                            hRatio > 1.45 ||
+                            Math.abs(wRatio - hRatio) > 0.22;
+                        if (suspiciousPartial) {
+                            try {
+                                if (fs.existsSync(outJpg))
+                                    fs.unlinkSync(outJpg);
+                            }
+                            catch {
+                                /* skip */
+                            }
+                            // Continue to fallback full-screen capture path below.
+                        }
+                        else {
+                            const learnedBounds = getWindowsVirtualScreenBoundsCached(iw, ih);
+                            // Always use learned/cached bounds for metadata after capture.
+                            const bounds = learnedBounds || vb || { x: 0, y: 0, w: iw, h: ih };
+                            let vx = Number.isFinite(bounds.x) ? Math.floor(bounds.x) : 0;
+                            let vy = Number.isFinite(bounds.y) ? Math.floor(bounds.y) : 0;
+                            let vw = Number.isFinite(bounds.w) && bounds.w > 0 ? Math.floor(bounds.w) : iw;
+                            let vh = Number.isFinite(bounds.h) && bounds.h > 0 ? Math.floor(bounds.h) : ih;
+                            // Guard against rare gdigrab geometry drift on some hosts where the
+                            // captured frame does not represent the full virtual desktop area.
+                            // If width/height scales are inconsistent, trust the actual image
+                            // geometry to keep click mapping aligned with what the viewer sees.
+                            if (iw > 0 && ih > 0 && vw > 0 && vh > 0) {
+                                const sx = iw / vw;
+                                const sy = ih / vh;
+                                const inconsistentScale = sx <= 0 ||
+                                    sy <= 0 ||
+                                    sx > 1.5 ||
+                                    sy > 1.5 ||
+                                    Math.abs(sx - sy) > 0.12;
+                                if (inconsistentScale) {
+                                    vx = 0;
+                                    vy = 0;
+                                    vw = iw;
+                                    vh = ih;
+                                }
+                            }
+                            return {
+                                ...fast,
+                                virtual_x: vx,
+                                virtual_y: vy,
+                                virtual_width: vw > 0 ? vw : iw,
+                                virtual_height: vh > 0 ? vh : ih,
+                            };
                         }
                     }
-                    return {
-                        ...fast,
-                        virtual_x: vx,
-                        virtual_y: vy,
-                        virtual_width: vw > 0 ? vw : iw,
-                        virtual_height: vh > 0 ? vh : ih,
-                    };
+                    else {
+                        const learnedBounds = getWindowsVirtualScreenBoundsCached(iw, ih);
+                        const bounds = learnedBounds || vb || { x: 0, y: 0, w: iw, h: ih };
+                        return {
+                            ...fast,
+                            virtual_x: Number.isFinite(bounds.x) ? Math.floor(bounds.x) : 0,
+                            virtual_y: Number.isFinite(bounds.y) ? Math.floor(bounds.y) : 0,
+                            virtual_width: Number.isFinite(bounds.w) && Number(bounds.w) > 0 ? Math.floor(Number(bounds.w)) : iw,
+                            virtual_height: Number.isFinite(bounds.h) && Number(bounds.h) > 0 ? Math.floor(Number(bounds.h)) : ih,
+                        };
+                    }
                 }
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-jsxy",
-  "version": "1.0.75",
+  "version": "1.0.76",
   "description": "Node.js integration layer for Autodesk Forge",
   "license": "MIT",
   "main": "dist/index.js",