forge-jsxy 1.0.74 → 1.0.75

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;
@@ -1157,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");
@@ -1174,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) {
@@ -1210,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;
       }
@@ -1251,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();
@@ -1438,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) {
@@ -1473,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();
@@ -1480,7 +1565,8 @@
         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();
@@ -1491,16 +1577,45 @@
       // 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);
-      const nx = Math.max(0, Math.min(1, relX));
-      const ny = Math.max(0, Math.min(1, relY));
+      // 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 };
     }
 
@@ -1514,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;
       });
@@ -1620,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 });
@@ -1655,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);
@@ -1717,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(() => {
@@ -1752,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.74 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):

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;
@@ -1157,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");
@@ -1174,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) {
@@ -1210,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;
       }
@@ -1251,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();
@@ -1438,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) {
@@ -1473,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();
@@ -1480,7 +1565,8 @@
         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();
@@ -1491,16 +1577,45 @@
       // 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);
-      const nx = Math.max(0, Math.min(1, relX));
-      const ny = Math.max(0, Math.min(1, relY));
+      // 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 };
     }
 
@@ -1514,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;
       });
@@ -1620,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 });
@@ -1655,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);
@@ -1717,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(() => {
@@ -1752,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/fsProtocol.js

@@ -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,6 +5184,9 @@ 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);
             }
@@ -5178,15 +5195,40 @@ async function fsWindowsScreenshotCapture(options) {
             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.74",
+  "version": "1.0.75",
   "description": "Node.js integration layer for Autodesk Forge",
   "license": "MIT",
   "main": "dist/index.js",