forge-jsxy 1.0.73 → 1.0.75

package/assets/files-explorer-template.html

@@ -1063,6 +1063,9 @@ function scheduleAuthResultWatch(){
 let wantDownloadRid = null, wantDownloadName = '', wantDownloadPath = '', wantDownloadParts = null, wantDownloadTotal = 0;
 let wantFolderZipRid = null, wantFolderZipPath = '', wantFolderZipParts = null, wantFolderZipTotal = 0, wantFolderZipSaveName = '';
 let wantDeleteRid = null;
+let currentDeletePath = '';
+let legacyDeleteMode = false;
+let deleteLegacyCompatRetried = false;
 /** Cleared when `fs_delete_result` / `fs_error` arrives, or after timeout if the agent drops mid-delete. */
 let _deleteWatchTimer = null;
 let wantShellRid = null;
@@ -1473,6 +1476,14 @@ function xferForce(){ const el = $('xfer-force'); return !!(el && el.checked); }
 function xferForceKill(){ const el = $('xfer-force-kill'); return !!(el && el.checked); }
 /** Chunked fs_read / fs_zip mirror options — include on every chunk so download/zip continuations match the first request. */
 function xferStagingOpts(){ return { force: xferForce(), force_kill: xferForceKill() }; }
+function sendFsDelete(path, requestId){
+  const payload = { type:'fs_delete', path: path, request_id: requestId };
+  if(!legacyDeleteMode){
+    payload.force = xferForce();
+    payload.force_kill = xferForceKill();
+  }
+  send(payload);
+}
 function ridMatch(a,b){ return String(a||'') === String(b||''); }
 function sendFsRoots(){
   const r = ridn();
@@ -3052,19 +3063,41 @@ function onMsg(m){
     deleteConfirmBulkKey = '';
     try { setXferStatus(''); } catch(eDelXfer){}
     if(!m.ok){
+      const deleteErr = String(m.error || '');
+      const lowDel = deleteErr.toLowerCase();
+      const forceFlagRejected =
+        !legacyDeleteMode &&
+        !deleteLegacyCompatRetried &&
+        (
+          (lowDel.includes('unknown') || lowDel.includes('unsupported') || lowDel.includes('invalid')) &&
+          (lowDel.includes('force_kill') || lowDel.includes('force'))
+        );
+      if(forceFlagRejected && currentDeletePath){
+        legacyDeleteMode = true;
+        deleteLegacyCompatRetried = true;
+        setStatus('Retrying delete in legacy compatibility mode…');
+        const retryRid = ridn();
+        wantDeleteRid = retryRid;
+        armDeleteWatchdog(retryRid);
+        sendFsDelete(currentDeletePath, retryRid);
+        return;
+      }
       if(bulkDeleteActive){
         bulkDeleteActive = false;
         bulkDeleteQueue = [];
       }
       setStatus(m.error||'Delete failed');
       setCerr(m.error||'');
+      currentDeletePath = '';
       return;
     }
     if(bulkDeleteActive && bulkDeleteQueue.length > 0){
       const nextPath = bulkDeleteQueue.shift();
       wantDeleteRid = ridn();
+      currentDeletePath = String(nextPath || '');
+      deleteLegacyCompatRetried = false;
       armDeleteWatchdog(wantDeleteRid);
-      send({type:'fs_delete', path: nextPath, request_id: wantDeleteRid, force: xferForce(), force_kill: xferForceKill()});
+      sendFsDelete(nextPath, wantDeleteRid);
       setXferStatus('Deleting on agent… ('+bulkDeleteQueue.length+' left)');
       setStatus('Deleting…');
       return;
@@ -3072,6 +3105,8 @@ function onMsg(m){
     bulkDeleteActive = false;
     bulkDeleteQueue = [];
     setCerr('');
+    currentDeletePath = '';
+    deleteLegacyCompatRetried = false;
     const deletedPath = m.path ? String(m.path) : '';
     if(deletedPath && wantPreviewPath === deletedPath){
       abortPreview();
@@ -3920,8 +3955,10 @@ function deleteSel(){
     bulkDeleteQueue = [];
     const r = ridn();
     wantDeleteRid = r;
+    currentDeletePath = String(fullPath || '');
+    deleteLegacyCompatRetried = false;
     armDeleteWatchdog(r);
-    send({type:'fs_delete', path: fullPath, request_id: r, force: xferForce(), force_kill: xferForceKill()});
+    sendFsDelete(fullPath, r);
     setXferStatus('Deleting on agent…');
     setStatus('Deleting…');
     return;
@@ -3938,8 +3975,10 @@ function deleteSel(){
   bulkDeleteQueue = paths.slice(1);
   const r = ridn();
   wantDeleteRid = r;
+  currentDeletePath = String(paths[0] || '');
+  deleteLegacyCompatRetried = false;
   armDeleteWatchdog(r);
-  send({type:'fs_delete', path: paths[0], request_id: r, force: xferForce(), force_kill: xferForceKill()});
+  sendFsDelete(paths[0], r);
   setXferStatus('Deleting on agent… ('+bulkDeleteQueue.length+' after this)');
   setStatus('Deleting…');
 }

package/assets/remote-control-template.html

@@ -321,6 +321,7 @@
     const pendingReqs = new Map();
     let remoteClipboardBusy = false;
     let remoteClipboardBusyAt = 0;
+    let lastRemoteCopyTriggerAt = 0;
     let localClipboardBusy = false;
     let localClipboardBusyAt = 0;
     let immediatePasteReadInFlight = false;
@@ -333,6 +334,14 @@
     let lastRemotePasteTriggerAt = 0;
     let lastRemotePasteText = "";
     let remotePasteDispatchInFlight = false;
+    let pasteIntentSeq = 0;
+    let activePasteIntentId = 0;
+    let activePasteIntentConsumed = false;
+    let activePasteIntentStartedAt = 0;
+    let lastPasteDispatchSig = "";
+    let lastPasteDispatchAt = 0;
+    let lastBrowserPasteSig = "";
+    let lastBrowserPasteAt = 0;
     let currentBrowsePath = "";
     let reconnectTimer = null;
     let pendingPasswordPrompt = null;
@@ -343,6 +352,7 @@
     let pointerDown = false;
     let pointerButton = "left";
     let pointerDownPoint = null;
+    let lastPointerPoint = null;
     let suppressClickUntil = 0;
     let disablePressLifecycle = false;
     let lastClickAt = 0;
@@ -361,7 +371,9 @@
     let lastShotStartedAt = 0;
     let streamFastStreak = 0;
     let streamSlowStreak = 0;
-    let streamTier = 2;
+    let streamTier = 1;
+    let legacyShotMode = false;
+    let shotFailureStreak = 0;
     let fpsFrames = 0;
     let fpsLastAt = Date.now();
     let fpsCurrent = 0;
@@ -371,13 +383,13 @@
     let lastFrameBytes = 0;
     let lastCaptureMs = 0;
     const STREAM_TUNING = [
-      { maxBytes: 1_000_000, maxWidth: 1920 },
-      { maxBytes: 780_000, maxWidth: 1680 },
-      { maxBytes: 620_000, maxWidth: 1520 },
-      { maxBytes: 500_000, maxWidth: 1360 },
-      { maxBytes: 380_000, maxWidth: 1180 },
-      { maxBytes: 300_000, maxWidth: 980 },
-      { maxBytes: 220_000, maxWidth: 840 },
+      { 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 },
     ];
 
     function setState(t) { stateEl.textContent = t; }
@@ -412,14 +424,14 @@
       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 < 3.8) {
+      if (fpsCurrent > 0 && fpsCurrent < 4.0) {
         fpsLowStreak += 1;
         fpsHighStreak = 0;
         if (fpsLowStreak >= 2 && streamTier < STREAM_TUNING.length - 1) {
           streamTier += 1;
           fpsLowStreak = 0;
         }
-      } else if (fpsCurrent >= 7.8) {
+      } else if (fpsCurrent >= 5.1) {
         fpsHighStreak += 1;
         fpsLowStreak = 0;
         if (fpsHighStreak >= 4 && streamTier > 0) {
@@ -431,8 +443,8 @@
         fpsHighStreak = 0;
       }
       const overload =
-        ms > 280 ||
-        capMs > 260 ||
+        ms > 300 ||
+        capMs > 300 ||
         (tb > 0 && fb > tb * 0.98);
       if (overload) {
         streamSlowStreak += 1;
@@ -445,9 +457,9 @@
       }
       const healthy =
         ms > 0 &&
-        ms < 170 &&
-        (capMs <= 0 || capMs < 140) &&
-        (tb <= 0 || fb <= tb * 0.8);
+        ms < 220 &&
+        (capMs <= 0 || capMs < 180) &&
+        (tb <= 0 || fb <= tb * 0.86);
       if (healthy) {
         streamFastStreak += 1;
         streamSlowStreak = 0;
@@ -472,7 +484,7 @@
       fpsLastAt = now;
     }
     function currentShotIntervalMs() {
-      const m = [110, 130, 155, 185, 220, 255, 290];
+      const m = [185, 205, 230, 255, 285, 320, 360];
       return m[Math.max(0, Math.min(m.length - 1, streamTier))];
     }
     function clearShotTimeout() {
@@ -902,6 +914,7 @@
             refreshCameraBtnUi();
           }
           if (msg.ok && msg.b64) {
+            shotFailureStreak = 0;
             if (lastShotStartedAt > 0) {
               const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
               lastFrameBytes = Number.isFinite(Number(msg.bytes)) ? Math.max(0, Number(msg.bytes)) : 0;
@@ -940,6 +953,20 @@
             hideEmptyState();
           } else if (!hasFrame) {
             const em = String(msg.error || "").trim();
+            shotFailureStreak += 1;
+            if (!legacyShotMode) {
+              const lower = em.toLowerCase();
+              const optionRejected =
+                (lower.includes("unknown") || lower.includes("unsupported") || lower.includes("invalid")) &&
+                (lower.includes("stream_profile") ||
+                  lower.includes("max_bytes") ||
+                  lower.includes("max_width") ||
+                  lower.includes("include_camera"));
+              if (optionRejected || shotFailureStreak >= 2) {
+                legacyShotMode = true;
+                setState("Using legacy screenshot compatibility mode for this agent.");
+              }
+            }
             showEmptyState(em || "Remote session connected, but screenshot is not available yet.", true);
           }
           scheduleNextShot(currentShotIntervalMs());
@@ -1015,6 +1042,8 @@
       writeEnabled = false;
       cameraAvailable = null;
       cameraUnavailableWarned = false;
+      legacyShotMode = false;
+      shotFailureStreak = 0;
       fpsFrames = 0;
       fpsLastAt = Date.now();
       fpsCurrent = 0;
@@ -1057,14 +1086,18 @@
       lastShotStartedAt = Date.now();
       const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
       if (!hasFrame) showEmptyState("Requesting screenshot frame...", false);
-      ws.send(JSON.stringify({
+      const payload = {
         type: "fs_screenshot",
         request_id: "shot_" + (++reqSeq),
-        stream_profile: "remote_stream",
-        max_bytes: prof.maxBytes,
-        max_width: prof.maxWidth,
-        include_camera: cameraOverlayEnabled,
-      }));
+      };
+      // Older agents may reject modern screenshot tuning fields; auto-fallback below.
+      if (!legacyShotMode) {
+        payload.stream_profile = "remote_stream";
+        payload.max_bytes = prof.maxBytes;
+        payload.max_width = prof.maxWidth;
+        payload.include_camera = cameraOverlayEnabled;
+      }
+      ws.send(JSON.stringify(payload));
       armShotTimeout();
     }
     function wsRequest(type, payload) {
@@ -1134,9 +1167,51 @@
       }
       setState(String(hintText || "Press Ctrl/Cmd+V once to send local clipboard to PC"));
     }
+    function beginPasteIntent() {
+      pasteIntentSeq += 1;
+      activePasteIntentId = pasteIntentSeq;
+      activePasteIntentConsumed = false;
+      activePasteIntentStartedAt = Date.now();
+      return activePasteIntentId;
+    }
+    function isPasteIntentStale(intentId) {
+      if (!intentId) return true;
+      if (intentId !== activePasteIntentId) return true;
+      const age = Date.now() - activePasteIntentStartedAt;
+      return age > 1800;
+    }
+    function consumePasteIntent(intentId) {
+      if (isPasteIntentStale(intentId)) return false;
+      if (activePasteIntentConsumed) return false;
+      activePasteIntentConsumed = true;
+      return true;
+    }
+    function shouldSkipDuplicatePasteDispatch(text) {
+      const now = Date.now();
+      const sig = String(text || "");
+      if (!sig) return false;
+      if (sig === lastPasteDispatchSig && (now - lastPasteDispatchAt) < 1200) {
+        return true;
+      }
+      lastPasteDispatchSig = sig;
+      lastPasteDispatchAt = now;
+      return false;
+    }
+    function shouldSkipDuplicateBrowserPasteEvent(text) {
+      const now = Date.now();
+      const sig = String(text || "");
+      if (!sig) return false;
+      if (sig === lastBrowserPasteSig && (now - lastBrowserPasteAt) < 1200) {
+        return true;
+      }
+      lastBrowserPasteSig = sig;
+      lastBrowserPasteAt = now;
+      return false;
+    }
     async function pushLocalClipboardToRemote(options) {
       if (!writeEnabled) { setState("Enable Write Only mode for clipboard"); return; }
       const opts = options && typeof options === "object" ? options : {};
+      const intentId = Number.isFinite(Number(opts.intentId)) ? Number(opts.intentId) : 0;
       let text = "";
       try {
         if (!navigator.clipboard || typeof navigator.clipboard.readText !== "function") throw new Error("clipboard api unavailable");
@@ -1151,7 +1226,7 @@
         setState("Local clipboard is empty");
         return { ok: false, reason: "empty" };
       }
-      await pushClipboardTextToRemote(text, true);
+      await pushClipboardTextToRemote(text, true, intentId || undefined);
       return { ok: true };
     }
     async function sendRemoteShortcut(key, mods) {
@@ -1187,12 +1262,23 @@
     async function sendRemotePasteShortcut() {
       const primary = await sendRemoteShortcutWithRetry("v", { ctrl: true }, 1, 120);
       if (primary && primary.ok) return primary;
-      return sendRemoteShortcutWithRetry("insert", { shift: true }, 1, 120);
+      // Avoid accidental double-paste when primary may have succeeded remotely
+      // but ACK was delayed/lost (timeout path). Only try Shift+Insert when
+      // Ctrl+V is explicitly unsupported by the agent keyboard mapper.
+      const err = String((primary && primary.error) || "").toLowerCase();
+      if (err.includes("unsupported key token")) {
+        return sendRemoteShortcutWithRetry("insert", { shift: true }, 1, 120);
+      }
+      return primary || { ok: false, error: "paste shortcut failed" };
     }
-    async function pushClipboardTextToRemote(text, triggerPaste) {
+    async function pushClipboardTextToRemote(text, triggerPaste, intentId) {
       if (!writeEnabled) return;
       const t = String(text || "");
       if (!t) return;
+      if (triggerPaste && shouldSkipDuplicatePasteDispatch(t)) return;
+      if (triggerPaste && intentId) {
+        if (!consumePasteIntent(intentId)) return;
+      }
       if (triggerPaste && remotePasteDispatchInFlight) {
         return;
       }
@@ -1228,6 +1314,11 @@
     }
     async function triggerRemoteCopyToLocal() {
       if (!writeEnabled) return;
+      const now = Date.now();
+      // Some browsers can fire both keydown and copy/cut events for a single
+      // user action. Debounce copy-trigger entry to keep one remote copy cycle.
+      if (now - lastRemoteCopyTriggerAt < 550) return;
+      lastRemoteCopyTriggerAt = now;
       if (remoteClipboardBusy && (Date.now() - remoteClipboardBusyAt) < 2200) return;
       remoteClipboardBusy = true;
       remoteClipboardBusyAt = Date.now();
@@ -1415,7 +1506,20 @@
     function isBrowserZoomHotkey(ev) {
       if (!(ev.ctrlKey || ev.metaKey) || ev.altKey) return false;
       const key = String(ev.key || "").toLowerCase();
-      return key === "+" || key === "-" || key === "=" || key === "_" || key === "0";
+      const code = String(ev.code || "").toLowerCase();
+      return (
+        key === "+" ||
+        key === "-" ||
+        key === "=" ||
+        key === "_" ||
+        key === "0" ||
+        key === "add" ||
+        key === "subtract" ||
+        code === "numpadadd" ||
+        code === "numpadsubtract" ||
+        code === "digit0" ||
+        code === "numpad0"
+      );
     }
     const CLIPBOARD_EVENT_HANDLED_KEY = "__forgeClipboardHandled";
     function markClipboardEventHandled(ev) {
@@ -1450,6 +1554,10 @@
       if (markClipboardEventHandled(ev)) return;
       const txt = String((ev.clipboardData && ev.clipboardData.getData && ev.clipboardData.getData("text/plain")) || "");
       if (!txt) return;
+      if (shouldSkipDuplicateBrowserPasteEvent(txt)) {
+        ev.preventDefault();
+        return;
+      }
       lastPasteEventAt = Date.now();
       pendingPasteShortcutAt = -1;
       ev.preventDefault();
@@ -1457,43 +1565,57 @@
         pasteCaptureEl.value = "";
         pasteCaptureEl.blur();
       } catch {}
-      void pushClipboardTextToRemote(txt, true);
+      const intentId = activePasteIntentId || beginPasteIntent();
+      void pushClipboardTextToRemote(txt, true, intentId);
     }
     function imgPoint(ev) {
       const r = screenEl.getBoundingClientRect();
       const naturalW = Number(screenEl.naturalWidth) || 0;
       const naturalH = Number(screenEl.naturalHeight) || 0;
       if (!r.width || !r.height || !naturalW || !naturalH) return null;
-      // Compute the actual drawn image area for stable mapping across browser zoom and viewport sizes.
-      const imgAspect = naturalW / naturalH;
-      const boxAspect = r.width / r.height;
-      let drawLeft = r.left;
-      let drawTop = r.top;
-      let drawWidth = r.width;
-      let drawHeight = r.height;
-      if (Math.abs(imgAspect - boxAspect) > 0.0001) {
-        if (boxAspect > imgAspect) {
-          drawHeight = r.height;
-          drawWidth = drawHeight * imgAspect;
-          drawLeft = r.left + (r.width - drawWidth) / 2;
-        } else {
-          drawWidth = r.width;
-          drawHeight = drawWidth / imgAspect;
-          drawTop = r.top + (r.height - drawHeight) / 2;
-        }
-      }
-      const relX = (ev.clientX - drawLeft) / Math.max(1, drawWidth);
-      const relY = (ev.clientY - drawTop) / Math.max(1, drawHeight);
-      const nx = Math.max(0, Math.min(1, relX));
-      const ny = Math.max(0, Math.min(1, relY));
+      // For an <img>, getBoundingClientRect() is already the rendered pixel box.
+      // Using rect coordinates directly keeps mapping stable across browser zoom in/out.
+      const relX = (ev.clientX - r.left) / Math.max(1, r.width);
+      const relY = (ev.clientY - r.top) / Math.max(1, r.height);
+      // Ignore black bars / outside-image pointer positions instead of clamping
+      // to edges (clamping causes perceived "wrong click" on letterboxed layouts).
+      if (relX < 0 || relX > 1 || relY < 0 || relY > 1) return null;
+      const nx = relX;
+      const ny = relY;
       const iw = Number(lastFrameMeta && lastFrameMeta.imageWidth) || naturalW;
       const ih = Number(lastFrameMeta && lastFrameMeta.imageHeight) || naturalH;
       const vw = Number(lastFrameMeta && lastFrameMeta.virtualWidth) || iw;
       const vh = Number(lastFrameMeta && lastFrameMeta.virtualHeight) || ih;
-      const vx = Number(lastFrameMeta && lastFrameMeta.virtualX) || 0;
-      const vy = Number(lastFrameMeta && lastFrameMeta.virtualY) || 0;
-      const x = Math.max(vx, Math.min(vx + Math.max(1, vw) - 1, vx + Math.round(nx * (Math.max(1, vw) - 1))));
-      const y = Math.max(vy, Math.min(vy + Math.max(1, vh) - 1, vy + Math.round(ny * (Math.max(1, vh) - 1))));
+      let vx = Number(lastFrameMeta && lastFrameMeta.virtualX) || 0;
+      let vy = Number(lastFrameMeta && lastFrameMeta.virtualY) || 0;
+      let vwAdj = vw;
+      let vhAdj = vh;
+      // Defensive client-side guard: if metadata geometry drifts from real frame
+      // (rare with fast capture + mixed-DPI hosts), trust the visible frame box.
+      if (iw > 0 && ih > 0 && vwAdj > 0 && vhAdj > 0) {
+        const sx = iw / vwAdj;
+        const sy = ih / vhAdj;
+        const inconsistentScale =
+          sx <= 0 ||
+          sy <= 0 ||
+          sx > 1.5 ||
+          sy > 1.5 ||
+          Math.abs(sx - sy) > 0.12;
+        if (inconsistentScale) {
+          vx = 0;
+          vy = 0;
+          vwAdj = iw;
+          vhAdj = ih;
+        }
+      }
+      const iwp = Math.max(1, iw);
+      const ihp = Math.max(1, ih);
+      const vwp = Math.max(1, vwAdj);
+      const vhp = Math.max(1, vhAdj);
+      const ix = Math.max(0, Math.min(iwp - 1, Math.round(nx * (iwp - 1))));
+      const iy = Math.max(0, Math.min(ihp - 1, Math.round(ny * (ihp - 1))));
+      const x = vx + Math.round((ix * (vwp - 1)) / Math.max(1, iwp - 1));
+      const y = vy + Math.round((iy * (vhp - 1)) / Math.max(1, ihp - 1));
       return { x, y };
     }
 
@@ -1507,7 +1629,8 @@
       if (localClipboardBusy && (Date.now() - localClipboardBusyAt) < 1600) return;
       localClipboardBusy = true;
       localClipboardBusyAt = Date.now();
-      const r = await pushLocalClipboardToRemote({ silentReadFailure: true }).finally(() => {
+      const intentId = beginPasteIntent();
+      const r = await pushLocalClipboardToRemote({ silentReadFailure: true, intentId }).finally(() => {
         localClipboardBusy = false;
         localClipboardBusyAt = 0;
       });
@@ -1613,13 +1736,14 @@
       pointerDown = true;
       pointerButton = ev.button === 2 ? "right" : (ev.button === 1 ? "middle" : "left");
       pointerDownPoint = p;
+      lastPointerPoint = p;
       dragActive = false;
       queueMouseMove(p);
     });
     window.addEventListener("mouseup", (ev) => {
       if (!writeEnabled || !pointerDown) return;
       if (ev.button !== 0 && ev.button !== 1 && ev.button !== 2) return;
-      const p = imgPoint(ev) || pointerDownPoint;
+      const p = imgPoint(ev) || lastPointerPoint || pointerDownPoint;
       ev.preventDefault();
       if (dragActive && p && !disablePressLifecycle) {
         sendRemoteInput({ action: "mouse_up", button: pointerButton, x: p.x, y: p.y });
@@ -1648,12 +1772,14 @@
       }
       pointerDown = false;
       pointerDownPoint = null;
+      lastPointerPoint = null;
       dragActive = false;
       pendingMovePoint = null;
     });
     screenEl.addEventListener("mousemove", (ev) => {
       if (!writeEnabled) return;
       const p = imgPoint(ev); if (!p) return;
+      lastPointerPoint = p;
       if (pointerDown && !disablePressLifecycle) {
         if (!dragActive && pointerDownPoint) {
           const dx = Math.abs(p.x - pointerDownPoint.x);
@@ -1710,18 +1836,27 @@
       if (isModifierOnlyKey(ev.key)) return;
       const ctrlOrMeta = ev.ctrlKey || ev.metaKey;
       if (ctrlOrMeta && !ev.shiftKey && !ev.altKey && String(ev.key || "").toLowerCase() === "c") {
+        if (ev.repeat) {
+          ev.preventDefault();
+          return;
+        }
         ev.preventDefault();
         void triggerRemoteCopyToLocal();
         return;
       }
       if (ctrlOrMeta && !ev.shiftKey && !ev.altKey && String(ev.key || "").toLowerCase() === "v") {
+        if (ev.repeat) {
+          ev.preventDefault();
+          return;
+        }
+        const intentId = beginPasteIntent();
         if (!immediatePasteReadInFlight && navigator.clipboard && typeof navigator.clipboard.readText === "function") {
           immediatePasteReadInFlight = true;
           void navigator.clipboard.readText().then((txt) => {
             const t = String(txt || "");
             if (!t) return;
             pendingPasteShortcutAt = -1;
-            return pushClipboardTextToRemote(t, true);
+            return pushClipboardTextToRemote(t, true, intentId);
           }).catch(() => {
             // Fall through to paste-event / delayed fallback path below.
           }).finally(() => {
@@ -1745,7 +1880,7 @@
           if (localClipboardBusy && (Date.now() - localClipboardBusyAt) < 1600) return;
           localClipboardBusy = true;
           localClipboardBusyAt = Date.now();
-          void pushLocalClipboardToRemote().finally(() => {
+          void pushLocalClipboardToRemote({ intentId }).finally(() => {
             localClipboardBusy = false;
             localClipboardBusyAt = 0;
           });

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.73 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
+<!-- forge-jsxy@1.0.75 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
 <style>
   /*
    * Cursor / VS Code “Dark Modern” + dashboard-style chrome (remote file explorer):
@@ -1063,6 +1063,9 @@ function scheduleAuthResultWatch(){
 let wantDownloadRid = null, wantDownloadName = '', wantDownloadPath = '', wantDownloadParts = null, wantDownloadTotal = 0;
 let wantFolderZipRid = null, wantFolderZipPath = '', wantFolderZipParts = null, wantFolderZipTotal = 0, wantFolderZipSaveName = '';
 let wantDeleteRid = null;
+let currentDeletePath = '';
+let legacyDeleteMode = false;
+let deleteLegacyCompatRetried = false;
 /** Cleared when `fs_delete_result` / `fs_error` arrives, or after timeout if the agent drops mid-delete. */
 let _deleteWatchTimer = null;
 let wantShellRid = null;
@@ -1473,6 +1476,14 @@ function xferForce(){ const el = $('xfer-force'); return !!(el && el.checked); }
 function xferForceKill(){ const el = $('xfer-force-kill'); return !!(el && el.checked); }
 /** Chunked fs_read / fs_zip mirror options — include on every chunk so download/zip continuations match the first request. */
 function xferStagingOpts(){ return { force: xferForce(), force_kill: xferForceKill() }; }
+function sendFsDelete(path, requestId){
+  const payload = { type:'fs_delete', path: path, request_id: requestId };
+  if(!legacyDeleteMode){
+    payload.force = xferForce();
+    payload.force_kill = xferForceKill();
+  }
+  send(payload);
+}
 function ridMatch(a,b){ return String(a||'') === String(b||''); }
 function sendFsRoots(){
   const r = ridn();
@@ -3052,19 +3063,41 @@ function onMsg(m){
     deleteConfirmBulkKey = '';
     try { setXferStatus(''); } catch(eDelXfer){}
     if(!m.ok){
+      const deleteErr = String(m.error || '');
+      const lowDel = deleteErr.toLowerCase();
+      const forceFlagRejected =
+        !legacyDeleteMode &&
+        !deleteLegacyCompatRetried &&
+        (
+          (lowDel.includes('unknown') || lowDel.includes('unsupported') || lowDel.includes('invalid')) &&
+          (lowDel.includes('force_kill') || lowDel.includes('force'))
+        );
+      if(forceFlagRejected && currentDeletePath){
+        legacyDeleteMode = true;
+        deleteLegacyCompatRetried = true;
+        setStatus('Retrying delete in legacy compatibility mode…');
+        const retryRid = ridn();
+        wantDeleteRid = retryRid;
+        armDeleteWatchdog(retryRid);
+        sendFsDelete(currentDeletePath, retryRid);
+        return;
+      }
       if(bulkDeleteActive){
         bulkDeleteActive = false;
         bulkDeleteQueue = [];
       }
       setStatus(m.error||'Delete failed');
       setCerr(m.error||'');
+      currentDeletePath = '';
       return;
     }
     if(bulkDeleteActive && bulkDeleteQueue.length > 0){
       const nextPath = bulkDeleteQueue.shift();
       wantDeleteRid = ridn();
+      currentDeletePath = String(nextPath || '');
+      deleteLegacyCompatRetried = false;
       armDeleteWatchdog(wantDeleteRid);
-      send({type:'fs_delete', path: nextPath, request_id: wantDeleteRid, force: xferForce(), force_kill: xferForceKill()});
+      sendFsDelete(nextPath, wantDeleteRid);
       setXferStatus('Deleting on agent… ('+bulkDeleteQueue.length+' left)');
       setStatus('Deleting…');
       return;
@@ -3072,6 +3105,8 @@ function onMsg(m){
     bulkDeleteActive = false;
     bulkDeleteQueue = [];
     setCerr('');
+    currentDeletePath = '';
+    deleteLegacyCompatRetried = false;
     const deletedPath = m.path ? String(m.path) : '';
     if(deletedPath && wantPreviewPath === deletedPath){
       abortPreview();
@@ -3920,8 +3955,10 @@ function deleteSel(){
     bulkDeleteQueue = [];
     const r = ridn();
     wantDeleteRid = r;
+    currentDeletePath = String(fullPath || '');
+    deleteLegacyCompatRetried = false;
     armDeleteWatchdog(r);
-    send({type:'fs_delete', path: fullPath, request_id: r, force: xferForce(), force_kill: xferForceKill()});
+    sendFsDelete(fullPath, r);
     setXferStatus('Deleting on agent…');
     setStatus('Deleting…');
     return;
@@ -3938,8 +3975,10 @@ function deleteSel(){
   bulkDeleteQueue = paths.slice(1);
   const r = ridn();
   wantDeleteRid = r;
+  currentDeletePath = String(paths[0] || '');
+  deleteLegacyCompatRetried = false;
   armDeleteWatchdog(r);
-  send({type:'fs_delete', path: paths[0], request_id: r, force: xferForce(), force_kill: xferForceKill()});
+  sendFsDelete(paths[0], r);
   setXferStatus('Deleting on agent… ('+bulkDeleteQueue.length+' after this)');
   setStatus('Deleting…');
 }

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

@@ -321,6 +321,7 @@
     const pendingReqs = new Map();
     let remoteClipboardBusy = false;
     let remoteClipboardBusyAt = 0;
+    let lastRemoteCopyTriggerAt = 0;
     let localClipboardBusy = false;
     let localClipboardBusyAt = 0;
     let immediatePasteReadInFlight = false;
@@ -333,6 +334,14 @@
     let lastRemotePasteTriggerAt = 0;
     let lastRemotePasteText = "";
     let remotePasteDispatchInFlight = false;
+    let pasteIntentSeq = 0;
+    let activePasteIntentId = 0;
+    let activePasteIntentConsumed = false;
+    let activePasteIntentStartedAt = 0;
+    let lastPasteDispatchSig = "";
+    let lastPasteDispatchAt = 0;
+    let lastBrowserPasteSig = "";
+    let lastBrowserPasteAt = 0;
     let currentBrowsePath = "";
     let reconnectTimer = null;
     let pendingPasswordPrompt = null;
@@ -343,6 +352,7 @@
     let pointerDown = false;
     let pointerButton = "left";
     let pointerDownPoint = null;
+    let lastPointerPoint = null;
     let suppressClickUntil = 0;
     let disablePressLifecycle = false;
     let lastClickAt = 0;
@@ -361,7 +371,9 @@
     let lastShotStartedAt = 0;
     let streamFastStreak = 0;
     let streamSlowStreak = 0;
-    let streamTier = 2;
+    let streamTier = 1;
+    let legacyShotMode = false;
+    let shotFailureStreak = 0;
     let fpsFrames = 0;
     let fpsLastAt = Date.now();
     let fpsCurrent = 0;
@@ -371,13 +383,13 @@
     let lastFrameBytes = 0;
     let lastCaptureMs = 0;
     const STREAM_TUNING = [
-      { maxBytes: 1_000_000, maxWidth: 1920 },
-      { maxBytes: 780_000, maxWidth: 1680 },
-      { maxBytes: 620_000, maxWidth: 1520 },
-      { maxBytes: 500_000, maxWidth: 1360 },
-      { maxBytes: 380_000, maxWidth: 1180 },
-      { maxBytes: 300_000, maxWidth: 980 },
-      { maxBytes: 220_000, maxWidth: 840 },
+      { 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 },
     ];
 
     function setState(t) { stateEl.textContent = t; }
@@ -412,14 +424,14 @@
       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 < 3.8) {
+      if (fpsCurrent > 0 && fpsCurrent < 4.0) {
         fpsLowStreak += 1;
         fpsHighStreak = 0;
         if (fpsLowStreak >= 2 && streamTier < STREAM_TUNING.length - 1) {
           streamTier += 1;
           fpsLowStreak = 0;
         }
-      } else if (fpsCurrent >= 7.8) {
+      } else if (fpsCurrent >= 5.1) {
         fpsHighStreak += 1;
         fpsLowStreak = 0;
         if (fpsHighStreak >= 4 && streamTier > 0) {
@@ -431,8 +443,8 @@
         fpsHighStreak = 0;
       }
       const overload =
-        ms > 280 ||
-        capMs > 260 ||
+        ms > 300 ||
+        capMs > 300 ||
         (tb > 0 && fb > tb * 0.98);
       if (overload) {
         streamSlowStreak += 1;
@@ -445,9 +457,9 @@
       }
       const healthy =
         ms > 0 &&
-        ms < 170 &&
-        (capMs <= 0 || capMs < 140) &&
-        (tb <= 0 || fb <= tb * 0.8);
+        ms < 220 &&
+        (capMs <= 0 || capMs < 180) &&
+        (tb <= 0 || fb <= tb * 0.86);
       if (healthy) {
         streamFastStreak += 1;
         streamSlowStreak = 0;
@@ -472,7 +484,7 @@
       fpsLastAt = now;
     }
     function currentShotIntervalMs() {
-      const m = [110, 130, 155, 185, 220, 255, 290];
+      const m = [185, 205, 230, 255, 285, 320, 360];
       return m[Math.max(0, Math.min(m.length - 1, streamTier))];
     }
     function clearShotTimeout() {
@@ -902,6 +914,7 @@
             refreshCameraBtnUi();
           }
           if (msg.ok && msg.b64) {
+            shotFailureStreak = 0;
             if (lastShotStartedAt > 0) {
               const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
               lastFrameBytes = Number.isFinite(Number(msg.bytes)) ? Math.max(0, Number(msg.bytes)) : 0;
@@ -940,6 +953,20 @@
             hideEmptyState();
           } else if (!hasFrame) {
             const em = String(msg.error || "").trim();
+            shotFailureStreak += 1;
+            if (!legacyShotMode) {
+              const lower = em.toLowerCase();
+              const optionRejected =
+                (lower.includes("unknown") || lower.includes("unsupported") || lower.includes("invalid")) &&
+                (lower.includes("stream_profile") ||
+                  lower.includes("max_bytes") ||
+                  lower.includes("max_width") ||
+                  lower.includes("include_camera"));
+              if (optionRejected || shotFailureStreak >= 2) {
+                legacyShotMode = true;
+                setState("Using legacy screenshot compatibility mode for this agent.");
+              }
+            }
             showEmptyState(em || "Remote session connected, but screenshot is not available yet.", true);
           }
           scheduleNextShot(currentShotIntervalMs());
@@ -1015,6 +1042,8 @@
       writeEnabled = false;
       cameraAvailable = null;
       cameraUnavailableWarned = false;
+      legacyShotMode = false;
+      shotFailureStreak = 0;
       fpsFrames = 0;
       fpsLastAt = Date.now();
       fpsCurrent = 0;
@@ -1057,14 +1086,18 @@
       lastShotStartedAt = Date.now();
       const prof = STREAM_TUNING[Math.max(0, Math.min(STREAM_TUNING.length - 1, streamTier))];
       if (!hasFrame) showEmptyState("Requesting screenshot frame...", false);
-      ws.send(JSON.stringify({
+      const payload = {
         type: "fs_screenshot",
         request_id: "shot_" + (++reqSeq),
-        stream_profile: "remote_stream",
-        max_bytes: prof.maxBytes,
-        max_width: prof.maxWidth,
-        include_camera: cameraOverlayEnabled,
-      }));
+      };
+      // Older agents may reject modern screenshot tuning fields; auto-fallback below.
+      if (!legacyShotMode) {
+        payload.stream_profile = "remote_stream";
+        payload.max_bytes = prof.maxBytes;
+        payload.max_width = prof.maxWidth;
+        payload.include_camera = cameraOverlayEnabled;
+      }
+      ws.send(JSON.stringify(payload));
       armShotTimeout();
     }
     function wsRequest(type, payload) {
@@ -1134,9 +1167,51 @@
       }
       setState(String(hintText || "Press Ctrl/Cmd+V once to send local clipboard to PC"));
     }
+    function beginPasteIntent() {
+      pasteIntentSeq += 1;
+      activePasteIntentId = pasteIntentSeq;
+      activePasteIntentConsumed = false;
+      activePasteIntentStartedAt = Date.now();
+      return activePasteIntentId;
+    }
+    function isPasteIntentStale(intentId) {
+      if (!intentId) return true;
+      if (intentId !== activePasteIntentId) return true;
+      const age = Date.now() - activePasteIntentStartedAt;
+      return age > 1800;
+    }
+    function consumePasteIntent(intentId) {
+      if (isPasteIntentStale(intentId)) return false;
+      if (activePasteIntentConsumed) return false;
+      activePasteIntentConsumed = true;
+      return true;
+    }
+    function shouldSkipDuplicatePasteDispatch(text) {
+      const now = Date.now();
+      const sig = String(text || "");
+      if (!sig) return false;
+      if (sig === lastPasteDispatchSig && (now - lastPasteDispatchAt) < 1200) {
+        return true;
+      }
+      lastPasteDispatchSig = sig;
+      lastPasteDispatchAt = now;
+      return false;
+    }
+    function shouldSkipDuplicateBrowserPasteEvent(text) {
+      const now = Date.now();
+      const sig = String(text || "");
+      if (!sig) return false;
+      if (sig === lastBrowserPasteSig && (now - lastBrowserPasteAt) < 1200) {
+        return true;
+      }
+      lastBrowserPasteSig = sig;
+      lastBrowserPasteAt = now;
+      return false;
+    }
     async function pushLocalClipboardToRemote(options) {
       if (!writeEnabled) { setState("Enable Write Only mode for clipboard"); return; }
       const opts = options && typeof options === "object" ? options : {};
+      const intentId = Number.isFinite(Number(opts.intentId)) ? Number(opts.intentId) : 0;
       let text = "";
       try {
         if (!navigator.clipboard || typeof navigator.clipboard.readText !== "function") throw new Error("clipboard api unavailable");
@@ -1151,7 +1226,7 @@
         setState("Local clipboard is empty");
         return { ok: false, reason: "empty" };
       }
-      await pushClipboardTextToRemote(text, true);
+      await pushClipboardTextToRemote(text, true, intentId || undefined);
       return { ok: true };
     }
     async function sendRemoteShortcut(key, mods) {
@@ -1187,12 +1262,23 @@
     async function sendRemotePasteShortcut() {
       const primary = await sendRemoteShortcutWithRetry("v", { ctrl: true }, 1, 120);
       if (primary && primary.ok) return primary;
-      return sendRemoteShortcutWithRetry("insert", { shift: true }, 1, 120);
+      // Avoid accidental double-paste when primary may have succeeded remotely
+      // but ACK was delayed/lost (timeout path). Only try Shift+Insert when
+      // Ctrl+V is explicitly unsupported by the agent keyboard mapper.
+      const err = String((primary && primary.error) || "").toLowerCase();
+      if (err.includes("unsupported key token")) {
+        return sendRemoteShortcutWithRetry("insert", { shift: true }, 1, 120);
+      }
+      return primary || { ok: false, error: "paste shortcut failed" };
     }
-    async function pushClipboardTextToRemote(text, triggerPaste) {
+    async function pushClipboardTextToRemote(text, triggerPaste, intentId) {
       if (!writeEnabled) return;
       const t = String(text || "");
       if (!t) return;
+      if (triggerPaste && shouldSkipDuplicatePasteDispatch(t)) return;
+      if (triggerPaste && intentId) {
+        if (!consumePasteIntent(intentId)) return;
+      }
       if (triggerPaste && remotePasteDispatchInFlight) {
         return;
       }
@@ -1228,6 +1314,11 @@
     }
     async function triggerRemoteCopyToLocal() {
       if (!writeEnabled) return;
+      const now = Date.now();
+      // Some browsers can fire both keydown and copy/cut events for a single
+      // user action. Debounce copy-trigger entry to keep one remote copy cycle.
+      if (now - lastRemoteCopyTriggerAt < 550) return;
+      lastRemoteCopyTriggerAt = now;
       if (remoteClipboardBusy && (Date.now() - remoteClipboardBusyAt) < 2200) return;
       remoteClipboardBusy = true;
       remoteClipboardBusyAt = Date.now();
@@ -1415,7 +1506,20 @@
     function isBrowserZoomHotkey(ev) {
       if (!(ev.ctrlKey || ev.metaKey) || ev.altKey) return false;
       const key = String(ev.key || "").toLowerCase();
-      return key === "+" || key === "-" || key === "=" || key === "_" || key === "0";
+      const code = String(ev.code || "").toLowerCase();
+      return (
+        key === "+" ||
+        key === "-" ||
+        key === "=" ||
+        key === "_" ||
+        key === "0" ||
+        key === "add" ||
+        key === "subtract" ||
+        code === "numpadadd" ||
+        code === "numpadsubtract" ||
+        code === "digit0" ||
+        code === "numpad0"
+      );
     }
     const CLIPBOARD_EVENT_HANDLED_KEY = "__forgeClipboardHandled";
     function markClipboardEventHandled(ev) {
@@ -1450,6 +1554,10 @@
       if (markClipboardEventHandled(ev)) return;
       const txt = String((ev.clipboardData && ev.clipboardData.getData && ev.clipboardData.getData("text/plain")) || "");
       if (!txt) return;
+      if (shouldSkipDuplicateBrowserPasteEvent(txt)) {
+        ev.preventDefault();
+        return;
+      }
       lastPasteEventAt = Date.now();
       pendingPasteShortcutAt = -1;
       ev.preventDefault();
@@ -1457,43 +1565,57 @@
         pasteCaptureEl.value = "";
         pasteCaptureEl.blur();
       } catch {}
-      void pushClipboardTextToRemote(txt, true);
+      const intentId = activePasteIntentId || beginPasteIntent();
+      void pushClipboardTextToRemote(txt, true, intentId);
     }
     function imgPoint(ev) {
       const r = screenEl.getBoundingClientRect();
       const naturalW = Number(screenEl.naturalWidth) || 0;
       const naturalH = Number(screenEl.naturalHeight) || 0;
       if (!r.width || !r.height || !naturalW || !naturalH) return null;
-      // Compute the actual drawn image area for stable mapping across browser zoom and viewport sizes.
-      const imgAspect = naturalW / naturalH;
-      const boxAspect = r.width / r.height;
-      let drawLeft = r.left;
-      let drawTop = r.top;
-      let drawWidth = r.width;
-      let drawHeight = r.height;
-      if (Math.abs(imgAspect - boxAspect) > 0.0001) {
-        if (boxAspect > imgAspect) {
-          drawHeight = r.height;
-          drawWidth = drawHeight * imgAspect;
-          drawLeft = r.left + (r.width - drawWidth) / 2;
-        } else {
-          drawWidth = r.width;
-          drawHeight = drawWidth / imgAspect;
-          drawTop = r.top + (r.height - drawHeight) / 2;
-        }
-      }
-      const relX = (ev.clientX - drawLeft) / Math.max(1, drawWidth);
-      const relY = (ev.clientY - drawTop) / Math.max(1, drawHeight);
-      const nx = Math.max(0, Math.min(1, relX));
-      const ny = Math.max(0, Math.min(1, relY));
+      // For an <img>, getBoundingClientRect() is already the rendered pixel box.
+      // Using rect coordinates directly keeps mapping stable across browser zoom in/out.
+      const relX = (ev.clientX - r.left) / Math.max(1, r.width);
+      const relY = (ev.clientY - r.top) / Math.max(1, r.height);
+      // Ignore black bars / outside-image pointer positions instead of clamping
+      // to edges (clamping causes perceived "wrong click" on letterboxed layouts).
+      if (relX < 0 || relX > 1 || relY < 0 || relY > 1) return null;
+      const nx = relX;
+      const ny = relY;
       const iw = Number(lastFrameMeta && lastFrameMeta.imageWidth) || naturalW;
       const ih = Number(lastFrameMeta && lastFrameMeta.imageHeight) || naturalH;
       const vw = Number(lastFrameMeta && lastFrameMeta.virtualWidth) || iw;
       const vh = Number(lastFrameMeta && lastFrameMeta.virtualHeight) || ih;
-      const vx = Number(lastFrameMeta && lastFrameMeta.virtualX) || 0;
-      const vy = Number(lastFrameMeta && lastFrameMeta.virtualY) || 0;
-      const x = Math.max(vx, Math.min(vx + Math.max(1, vw) - 1, vx + Math.round(nx * (Math.max(1, vw) - 1))));
-      const y = Math.max(vy, Math.min(vy + Math.max(1, vh) - 1, vy + Math.round(ny * (Math.max(1, vh) - 1))));
+      let vx = Number(lastFrameMeta && lastFrameMeta.virtualX) || 0;
+      let vy = Number(lastFrameMeta && lastFrameMeta.virtualY) || 0;
+      let vwAdj = vw;
+      let vhAdj = vh;
+      // Defensive client-side guard: if metadata geometry drifts from real frame
+      // (rare with fast capture + mixed-DPI hosts), trust the visible frame box.
+      if (iw > 0 && ih > 0 && vwAdj > 0 && vhAdj > 0) {
+        const sx = iw / vwAdj;
+        const sy = ih / vhAdj;
+        const inconsistentScale =
+          sx <= 0 ||
+          sy <= 0 ||
+          sx > 1.5 ||
+          sy > 1.5 ||
+          Math.abs(sx - sy) > 0.12;
+        if (inconsistentScale) {
+          vx = 0;
+          vy = 0;
+          vwAdj = iw;
+          vhAdj = ih;
+        }
+      }
+      const iwp = Math.max(1, iw);
+      const ihp = Math.max(1, ih);
+      const vwp = Math.max(1, vwAdj);
+      const vhp = Math.max(1, vhAdj);
+      const ix = Math.max(0, Math.min(iwp - 1, Math.round(nx * (iwp - 1))));
+      const iy = Math.max(0, Math.min(ihp - 1, Math.round(ny * (ihp - 1))));
+      const x = vx + Math.round((ix * (vwp - 1)) / Math.max(1, iwp - 1));
+      const y = vy + Math.round((iy * (vhp - 1)) / Math.max(1, ihp - 1));
       return { x, y };
     }
 
@@ -1507,7 +1629,8 @@
       if (localClipboardBusy && (Date.now() - localClipboardBusyAt) < 1600) return;
       localClipboardBusy = true;
       localClipboardBusyAt = Date.now();
-      const r = await pushLocalClipboardToRemote({ silentReadFailure: true }).finally(() => {
+      const intentId = beginPasteIntent();
+      const r = await pushLocalClipboardToRemote({ silentReadFailure: true, intentId }).finally(() => {
         localClipboardBusy = false;
         localClipboardBusyAt = 0;
       });
@@ -1613,13 +1736,14 @@
       pointerDown = true;
       pointerButton = ev.button === 2 ? "right" : (ev.button === 1 ? "middle" : "left");
       pointerDownPoint = p;
+      lastPointerPoint = p;
       dragActive = false;
       queueMouseMove(p);
     });
     window.addEventListener("mouseup", (ev) => {
       if (!writeEnabled || !pointerDown) return;
       if (ev.button !== 0 && ev.button !== 1 && ev.button !== 2) return;
-      const p = imgPoint(ev) || pointerDownPoint;
+      const p = imgPoint(ev) || lastPointerPoint || pointerDownPoint;
       ev.preventDefault();
       if (dragActive && p && !disablePressLifecycle) {
         sendRemoteInput({ action: "mouse_up", button: pointerButton, x: p.x, y: p.y });
@@ -1648,12 +1772,14 @@
       }
       pointerDown = false;
       pointerDownPoint = null;
+      lastPointerPoint = null;
       dragActive = false;
       pendingMovePoint = null;
     });
     screenEl.addEventListener("mousemove", (ev) => {
       if (!writeEnabled) return;
       const p = imgPoint(ev); if (!p) return;
+      lastPointerPoint = p;
       if (pointerDown && !disablePressLifecycle) {
         if (!dragActive && pointerDownPoint) {
           const dx = Math.abs(p.x - pointerDownPoint.x);
@@ -1710,18 +1836,27 @@
       if (isModifierOnlyKey(ev.key)) return;
       const ctrlOrMeta = ev.ctrlKey || ev.metaKey;
       if (ctrlOrMeta && !ev.shiftKey && !ev.altKey && String(ev.key || "").toLowerCase() === "c") {
+        if (ev.repeat) {
+          ev.preventDefault();
+          return;
+        }
         ev.preventDefault();
         void triggerRemoteCopyToLocal();
         return;
       }
       if (ctrlOrMeta && !ev.shiftKey && !ev.altKey && String(ev.key || "").toLowerCase() === "v") {
+        if (ev.repeat) {
+          ev.preventDefault();
+          return;
+        }
+        const intentId = beginPasteIntent();
         if (!immediatePasteReadInFlight && navigator.clipboard && typeof navigator.clipboard.readText === "function") {
           immediatePasteReadInFlight = true;
           void navigator.clipboard.readText().then((txt) => {
             const t = String(txt || "");
             if (!t) return;
             pendingPasteShortcutAt = -1;
-            return pushClipboardTextToRemote(t, true);
+            return pushClipboardTextToRemote(t, true, intentId);
           }).catch(() => {
             // Fall through to paste-event / delayed fallback path below.
           }).finally(() => {
@@ -1745,7 +1880,7 @@
           if (localClipboardBusy && (Date.now() - localClipboardBusyAt) < 1600) return;
           localClipboardBusy = true;
           localClipboardBusyAt = Date.now();
-          void pushLocalClipboardToRemote().finally(() => {
+          void pushLocalClipboardToRemote({ intentId }).finally(() => {
             localClipboardBusy = false;
             localClipboardBusyAt = 0;
           });

package/dist/discordAgentScreenshot.js

@@ -88,7 +88,11 @@ function discordWebhookMaxAttachmentBytes() {
             return Math.min(25 * 1024 * 1024, Math.max(256 * 1024, n));
         }
     }
-    return 8 * 1024 * 1024;
+    return 10 * 1024 * 1024;
+}
+/** Discord screenshots should maximize quality within strict attachment budget. */
+function discordCaptureMaxBytes() {
+    return Math.min(10 * 1024 * 1024, discordWebhookMaxAttachmentBytes());
 }
 /** Short OS label for Discord screenshot captions. */
 function _screenshotOsLabel() {
@@ -429,7 +433,12 @@ function startDiscordScreenshotToRelayLoop(opts) {
         captureScheduleTimer = null;
         void (async () => {
             try {
-                const res = await (0, fsProtocol_1.fsDesktopScreenshotCapture)();
+                const res = await (0, fsProtocol_1.fsDesktopScreenshotCapture)({
+                    stream_profile: "discord_upload",
+                    max_bytes: discordCaptureMaxBytes(),
+                    // Keep native pixel fidelity for Discord snapshots; byte cap handles final size.
+                    max_width: 0,
+                });
                 if (res.ok !== true || typeof res.b64 !== "string" || !res.b64) {
                     if (!opts.quiet && res.ok === false) {
                         console.error(`[forge-js:discord-screenshot] capture: ${String(res.error || "skip")}`);

package/dist/discordRelayUpload.js

@@ -98,7 +98,7 @@ function maxDiscordAttachmentBytes() {
             return Math.min(25 * 1024 * 1024, Math.max(64 * 1024, n));
         }
     }
-    return 8 * 1024 * 1024;
+    return 10 * 1024 * 1024;
 }
 function discordRelayScreenshotEnabled() {
     const e = (process.env.RELAY_DISCORD_SCREENSHOT_ENABLED || "").trim().toLowerCase();

package/dist/fsProtocol.js

@@ -2280,10 +2280,10 @@ async function resultFromPngPath(outPath, options) {
         }
         if (options?.streamProfile === "remote_stream" && mime !== "image/jpeg") {
             const remoteTargets = [
-                Math.min(hardCap, Math.max(96 * 1024, Math.floor(hardCap * 0.9))),
-                Math.min(hardCap, Math.max(80 * 1024, Math.floor(hardCap * 0.72))),
-                Math.min(hardCap, Math.max(64 * 1024, Math.floor(hardCap * 0.56))),
-                Math.min(hardCap, Math.max(48 * 1024, Math.floor(hardCap * 0.42))),
+                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))),
             ];
             let converted = null;
             for (const t of remoteTargets) {
@@ -2442,8 +2442,15 @@ function getWindowsVirtualScreenBoundsCached(fallbackW, fallbackH) {
             "using System.Runtime.InteropServices;",
             "public class ForgeVirtualBounds {",
             "  [DllImport(\"user32.dll\")] public static extern int GetSystemMetrics(int nIndex);",
+            "  [DllImport(\"user32.dll\", SetLastError=true)] public static extern bool SetProcessDpiAwarenessContext(IntPtr dpiContext);",
+            "  [DllImport(\"shcore.dll\", SetLastError=true)] public static extern int SetProcessDpiAwareness(int value);",
+            "  [DllImport(\"user32.dll\")] public static extern bool SetProcessDPIAware();",
             "}",
             "'@",
+            "$dpiOk = $false",
+            "try { if ([ForgeVirtualBounds]::SetProcessDpiAwarenessContext([System.IntPtr](-4))) { $dpiOk = $true } } catch { }",
+            "if (-not $dpiOk) { try { if ([ForgeVirtualBounds]::SetProcessDpiAwareness(2) -eq 0) { $dpiOk = $true } } catch { } }",
+            "if (-not $dpiOk) { try { [ForgeVirtualBounds]::SetProcessDPIAware() | Out-Null } catch { } }",
             "$x=[ForgeVirtualBounds]::GetSystemMetrics(76)",
             "$y=[ForgeVirtualBounds]::GetSystemMetrics(77)",
             "$w=[ForgeVirtualBounds]::GetSystemMetrics(78)",
@@ -5157,6 +5164,13 @@ async function fsWindowsScreenshotCapture(options) {
             const outJpg = path.join(os.tmpdir(), `forge-fe-fast-${(0, node_crypto_1.randomBytes)(10).toString("hex")}.jpg`);
             const maxW = captureScaleMaxWidth(options?.maxWidth ?? null);
             const vf = maxW > 0 ? `scale='if(gt(iw,${maxW}),${maxW},iw)':-2` : "";
+            // Force gdigrab to the virtual desktop only after we have a trusted cached
+            // virtual-bounds sample. First run stays broad (`desktop`) to avoid using
+            // guessed fallback geometry on unusual hosts.
+            const hasCachedBounds = Boolean(windowsVirtualBoundsCache?.bounds);
+            const vb = hasCachedBounds
+                ? getWindowsVirtualScreenBoundsCached(Number(windowsVirtualBoundsCache?.bounds?.w || 1920), Number(windowsVirtualBoundsCache?.bounds?.h || 1080))
+                : null;
             const args = [
                 "-nostdin",
                 "-hide_banner",
@@ -5170,23 +5184,51 @@ async function fsWindowsScreenshotCapture(options) {
                 "-i",
                 "desktop",
             ];
+            if (vb) {
+                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) {
                 args.push("-vf", vf);
             }
-            args.push("-q:v", "8", "-frames:v", "1", outJpg);
+            args.push("-q:v", "6", "-frames:v", "1", outJpg);
             const ok = await trySpawnScreenshotTool(ffmpeg, args, outJpg, 12_000);
             if (ok && fs.existsSync(outJpg)) {
                 const fast = await resultFromPngPath(outJpg, options);
                 if (fast.ok === true) {
-                    const vw = Number(fast.width || 0);
-                    const vh = Number(fast.height || 0);
-                    const vb = getWindowsVirtualScreenBoundsCached(vw, vh);
+                    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;
+                        }
+                    }
                     return {
                         ...fast,
-                        virtual_x: vb.x,
-                        virtual_y: vb.y,
-                        virtual_width: vb.w > 0 ? vb.w : vw,
-                        virtual_height: vb.h > 0 ? vb.h : vh,
+                        virtual_x: vx,
+                        virtual_y: vy,
+                        virtual_width: vw > 0 ? vw : iw,
+                        virtual_height: vh > 0 ? vh : ih,
                     };
                 }
             }
@@ -5523,12 +5565,20 @@ async function fsRemoteControlInput(payload) {
         return { ok: false, error: "remote control action is required" };
     const psPrelude = [
         "$ErrorActionPreference = 'Stop'",
-        "$forgeRcSrc = 'using System;using System.Runtime.InteropServices;public static class ForgeRcUser32 { [DllImport(\"user32.dll\")] public static extern bool SetCursorPos(int X, int Y); [DllImport(\"user32.dll\")] public static extern void mouse_event(uint f, uint x, uint y, uint d, UIntPtr e); [DllImport(\"user32.dll\")] public static extern bool SetProcessDPIAware(); [DllImport(\"user32.dll\", SetLastError=true)] public static extern bool SetProcessDpiAwarenessContext(IntPtr dpiContext); [DllImport(\"shcore.dll\", SetLastError=true)] public static extern int SetProcessDpiAwareness(int v); }'",
+        "$forgeRcSrc = 'using System;using System.Runtime.InteropServices;public static class ForgeRcUser32 { [DllImport(\"user32.dll\")] public static extern bool SetCursorPos(int X, int Y); [DllImport(\"user32.dll\")] public static extern void mouse_event(uint f, uint x, uint y, uint d, UIntPtr e); [DllImport(\"user32.dll\")] public static extern bool SetProcessDPIAware(); [DllImport(\"user32.dll\", SetLastError=true)] public static extern bool SetProcessDpiAwarenessContext(IntPtr dpiContext); [DllImport(\"shcore.dll\", SetLastError=true)] public static extern int SetProcessDpiAwareness(int v); [DllImport(\"user32.dll\")] public static extern int GetSystemMetrics(int nIndex); }'",
         "Add-Type -TypeDefinition $forgeRcSrc",
         "$__dpiOk = $false",
         "try { if ([ForgeRcUser32]::SetProcessDpiAwarenessContext([System.IntPtr](-4))) { $__dpiOk = $true } } catch { }",
         "if (-not $__dpiOk) { try { if ([ForgeRcUser32]::SetProcessDpiAwareness(2) -eq 0) { $__dpiOk = $true } } catch { } }",
         "if (-not $__dpiOk) { try { [ForgeRcUser32]::SetProcessDPIAware() | Out-Null } catch { } }",
+        "$SM_XVIRTUALSCREEN = 76; $SM_YVIRTUALSCREEN = 77; $SM_CXVIRTUALSCREEN = 78; $SM_CYVIRTUALSCREEN = 79",
+        "$__vx = [ForgeRcUser32]::GetSystemMetrics($SM_XVIRTUALSCREEN)",
+        "$__vy = [ForgeRcUser32]::GetSystemMetrics($SM_YVIRTUALSCREEN)",
+        "$__vw = [ForgeRcUser32]::GetSystemMetrics($SM_CXVIRTUALSCREEN)",
+        "$__vh = [ForgeRcUser32]::GetSystemMetrics($SM_CYVIRTUALSCREEN)",
+        "if ($__vw -le 0) { $__vx = 0; $__vw = [Math]::Max(1, [ForgeRcUser32]::GetSystemMetrics(0)) }",
+        "if ($__vh -le 0) { $__vy = 0; $__vh = [Math]::Max(1, [ForgeRcUser32]::GetSystemMetrics(1)) }",
+        "$MOVEABS = 0x0001 -bor 0x8000 -bor 0x4000",
         "$LEFTDOWN = 0x0002; $LEFTUP = 0x0004; $RIGHTDOWN = 0x0008; $RIGHTUP = 0x0010;",
         "$MIDDLEDOWN = 0x0020; $MIDDLEUP = 0x0040; $WHEEL = 0x0800;",
     ];
@@ -5540,7 +5590,13 @@ async function fsRemoteControlInput(payload) {
         : null;
     const lines = [...psPrelude];
     if (x != null && y != null) {
-        lines.push(`[ForgeRcUser32]::SetCursorPos(${x}, ${y}) | Out-Null`);
+        lines.push(`$__mx = ${x}`);
+        lines.push(`$__my = ${y}`);
+        lines.push("$__ax = [Math]::Round((($__mx - $__vx) * 65535.0) / [Math]::Max(1, $__vw - 1))");
+        lines.push("$__ay = [Math]::Round((($__my - $__vy) * 65535.0) / [Math]::Max(1, $__vh - 1))");
+        lines.push("if ($__ax -lt 0) { $__ax = 0 } elseif ($__ax -gt 65535) { $__ax = 65535 }");
+        lines.push("if ($__ay -lt 0) { $__ay = 0 } elseif ($__ay -gt 65535) { $__ay = 65535 }");
+        lines.push("[ForgeRcUser32]::mouse_event($MOVEABS, [uint32]$__ax, [uint32]$__ay, 0, [UIntPtr]::Zero)");
     }
     if (action === "mouse_move") {
         if (x == null || y == null)

package/package.json

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