forge-jsxy 1.0.78 → 1.0.79

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

@@ -329,6 +329,26 @@
     pasteCaptureEl.style.left = "-9999px";
     pasteCaptureEl.style.top = "0";
     document.body.appendChild(pasteCaptureEl);
+    /** Relay-advertised WebRTC/STUN (optional; signaling uses relay WS until data channel is implemented end-to-end). */
+    let relayWebrtcSignaling = false;
+    let relayRtcIceServers = null;
+    let forgeRtcPc = null;
+    let forgeRtcDc = null;
+    /** Partial-reliable channel for bursty input (`mouse_move`, `mouse_wheel`) when agent supports `forge-rc-input`. */
+    let forgeRtcDcInput = null;
+    /** Ordered bulk binary channel — forge-bulk v2 (chunked) + v1 (legacy single frame). */
+    let forgeRtcDcBulk = null;
+    let forgeBulkRcExpectHdr = true;
+    /** null | v1 wait object | v2 accumulation state */
+    let forgeBulkRcRx = null;
+    /** Set after successful `setRemoteDescription` for the agent's WebRTC answer (ICE trickle ordering). */
+    let forgeRtcRemoteDescDone = false;
+    const forgeRtcPendingRemoteCandidates = [];
+    let forgeRtcProbeStarted = false;
+    /** Bounded automatic WebRTC re-offers after ICE/agent failure (relay WS unchanged). */
+    let forgeRtcReconnectTimer = null;
+    let forgeRtcReconnectAttempts = 0;
+    const FORGE_RTC_MAX_RECONNECT = 2;
     let ws = null;
     let authed = false;
     let writeEnabled = false;
@@ -384,6 +404,11 @@
     let lastFrameMeta = null;
     let sessionAgentVersion = "";
     let sessionAgentOs = "";
+    /**
+     * Agents below this forge-jsxy semver skip WebRTC offers (relay WebSocket only — old builds).
+     * Injected at `npm run build` from package.json (`scripts/copy-assets.mjs`). Dev placeholder leaves probing enabled when version unknown.
+     */
+    var FORGE_AGENT_WEBRTC_MIN_VERSION = "1.0.71";
     let cameraOverlayEnabled = false;
     let cameraAvailable = null;
     let cameraUnavailableWarned = false;
@@ -553,20 +578,35 @@
       fpsFrames = 0;
       fpsLastAt = now;
     }
+    /**
+     * When the remote-control tab is in the background, poll screenshots less often (Page Visibility API).
+     * Frees relay/agent CPU and bandwidth; P2P input keeps working while the tab is visible enough for events.
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API
+     */
+    function remoteTabScreenshotThrottleFactor() {
+      try {
+        if (typeof document !== "undefined" && document.hidden) return 2.35;
+      } catch (e) {}
+      return 1;
+    }
     function currentShotIntervalMs() {
       const interacting = isInteractionActive();
       const tuning = currentStreamTuning();
       const idx = Math.max(0, Math.min(tuning.length - 1, streamTier));
-      const mapBalancedActive = [260, 290, 330, 380, 440, 520, 620, 760];
-      const mapBalancedIdle = [420, 480, 550, 640, 760, 900, 1050, 1200];
-      const mapTextActive = [420, 480, 560, 680, 820];
-      const mapTextIdle = [700, 820, 960, 1120, 1320];
-      // Max-quality mode is readability-first with ~1 FPS pacing.
-      const mapMaxActive = [960, 1120, 1300];
-      const mapMaxIdle = [1150, 1320, 1550];
-      if (qualityMode === "max") return (interacting ? mapMaxActive : mapMaxIdle)[idx];
-      if (qualityMode === "balanced") return (interacting ? mapBalancedActive : mapBalancedIdle)[idx];
-      return (interacting ? mapTextActive : mapTextIdle)[idx];
+      // Lower ms ⇒ faster screenshot polling when the adaptive tier allows it.
+      const mapBalancedActive = [180, 210, 245, 285, 335, 400, 500, 640];
+      const mapBalancedIdle = [320, 375, 435, 510, 605, 720, 880, 1040];
+      const mapTextActive = [300, 345, 405, 485, 600];
+      const mapTextIdle = [515, 605, 720, 880, 1040];
+      // Max-quality mode stays readability-first but ticks slightly faster when healthy.
+      const mapMaxActive = [880, 1020, 1180];
+      const mapMaxIdle = [1020, 1180, 1380];
+      let ms;
+      if (qualityMode === "max") ms = (interacting ? mapMaxActive : mapMaxIdle)[idx];
+      else if (qualityMode === "balanced") ms = (interacting ? mapBalancedActive : mapBalancedIdle)[idx];
+      else ms = (interacting ? mapTextActive : mapTextIdle)[idx];
+      ms = Math.floor(ms * remoteTabScreenshotThrottleFactor());
+      return Math.min(9200, Math.max(90, ms));
     }
     function clearShotTimeout() {
       if (shotTimeoutTimer) {
@@ -854,6 +894,553 @@
       if (entered) rememberPassword(sid, entered);
       return entered;
     }
+    async function flushForgeRtcRemoteCandidates() {
+      const pc = forgeRtcPc;
+      if (!pc) return;
+      const pending = forgeRtcPendingRemoteCandidates.splice(0, forgeRtcPendingRemoteCandidates.length);
+      for (let i = 0; i < pending.length; i++) {
+        try {
+          await pc.addIceCandidate(pending[i]);
+        } catch (e) {}
+      }
+    }
+    /** Prefer WebRTC data-channel when open (P2P); screenshots still arrive over WS when needed. */
+    /** Prefer P2P when DC open and payload fits SCTP-safe size; large frames (e.g. rc_file_push) stay on WebSocket. */
+    function sendAgentPayload(obj) {
+      let s;
+      try {
+        s = JSON.stringify(obj);
+      } catch {
+        return;
+      }
+      const maxDc = 32768;
+      if (forgeRtcDc && forgeRtcDc.readyState === "open" && s.length <= maxDc) {
+        try {
+          forgeRtcDc.send(s);
+          return;
+        } catch (e) {}
+      }
+      if (ws && ws.readyState === 1) ws.send(s);
+    }
+    function viewerAgentTransportReady() {
+      return Boolean(
+        (ws && ws.readyState === 1) || (forgeRtcDc && forgeRtcDc.readyState === "open")
+      );
+    }
+    async function processRelayInboundCore(msg) {
+      const sid = resolveSessionId();
+      const t = String(msg && msg.type || "");
+      if (t === "connected") {
+        relayWebrtcSignaling = msg.webrtc_signaling === true;
+        relayRtcIceServers = Array.isArray(msg.rtc_ice_servers) ? msg.rtc_ice_servers : null;
+        return;
+      }
+      if (t === "relay_webrtc_availability") {
+        relayWebrtcSignaling = msg.webrtc_signaling === true;
+        relayRtcIceServers = Array.isArray(msg.rtc_ice_servers) ? msg.rtc_ice_servers : null;
+        if (!relayWebrtcSignaling) {
+          if (forgeRtcReconnectTimer) {
+            clearTimeout(forgeRtcReconnectTimer);
+            forgeRtcReconnectTimer = null;
+          }
+          forgeRtcReconnectAttempts = 0;
+          teardownForgeRtcProbe();
+        } else if (authed && ws && ws.readyState === 1 && !forgeRtcProbeStarted) {
+          setTimeout(function () {
+            tryForgeRtcDirectProbe();
+          }, 350);
+        }
+        return;
+      }
+      if (t === "auth_challenge") {
+        authChallengeSeen = true;
+        clearAuthWatchdog();
+        const pwd = await resolveSessionPassword(sid, false);
+        if (!pwd) {
+          setState("Missing session password");
+          if (!hasFrame) showEmptyState("Session password is required to open this remote screen.", true);
+          return;
+        }
+        const ph = await hashHex(pwd);
+        const nonce = String(msg.nonce || "");
+        const resp = await hashHex(ph + ":" + nonce);
+        ws.send(JSON.stringify({ type: "auth", nonce, response: resp, password_hash: ph }));
+        return;
+      }
+      if (t === "auth_result") {
+        authed = !!msg.ok;
+        if (authed) {
+          forgeRtcReconnectAttempts = 0;
+          if (forgeRtcReconnectTimer) {
+            clearTimeout(forgeRtcReconnectTimer);
+            forgeRtcReconnectTimer = null;
+          }
+          clearAuthWatchdog();
+          setState("Authenticated");
+          startShotLoop();
+          requestScreenshot();
+          startRemoteClipboardPoll();
+          void refreshRemoteControlCapabilities();
+          if (!hasFrame) showEmptyState("Connected. Waiting for first screenshot frame...", false);
+          setTimeout(function () {
+            tryForgeRtcDirectProbe();
+          }, 350);
+        } else {
+          forgetPassword(sid);
+          const entered = await resolveSessionPassword(sid, true);
+          if (entered) {
+            setState("Retrying with updated password...");
+            disconnect();
+            setTimeout(connect, 120);
+          } else {
+            setState("Auth failed");
+            if (!hasFrame) showEmptyState("Authentication failed. Please enter the correct session password.", true);
+          }
+        }
+        return;
+      }
+      if (t === "system_info") {
+        const d = (msg && msg.data) || {};
+        const v = String(d.forge_jsx_version || d.forge_jsxy_version || "").trim();
+        if (v) sessionAgentVersion = v;
+        const os = String(d.os || d.platform || "").trim().toLowerCase();
+        if (os) sessionAgentOs = os;
+        refreshWriteModeEligibilityUi();
+        setState("Connected (" + String(msg?.data?.platform || "unknown") + ")");
+        return;
+      }
+      if (t === "info") {
+        const sys = (msg && msg.data && msg.data.system) || {};
+        const v = String(sys.forge_jsx_version || sys.forge_jsxy_version || "").trim();
+        if (v) sessionAgentVersion = v;
+        const os = String(sys.os || sys.platform || "").trim().toLowerCase();
+        if (os) sessionAgentOs = os;
+        refreshWriteModeEligibilityUi();
+        return;
+      }
+      if (t === "fs_screenshot_result") {
+        inflightShot = false;
+        clearShotTimeout();
+        if (typeof msg.camera_available === "boolean") {
+          cameraAvailable = msg.camera_available;
+          if (cameraAvailable === false && !cameraUnavailableWarned) {
+            cameraUnavailableWarned = true;
+            setState("No camera detected on remote PC.");
+          }
+          refreshCameraBtnUi();
+        }
+        if (msg.ok && msg.b64) {
+          shotFailureStreak = 0;
+          if (lastShotStartedAt > 0) {
+            const tuning = currentStreamTuning();
+            const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
+            lastFrameBytes = Number.isFinite(Number(msg.bytes)) ? Math.max(0, Number(msg.bytes)) : 0;
+            lastCaptureMs = Number.isFinite(Number(msg.capture_ms)) ? Math.max(0, Number(msg.capture_ms)) : 0;
+            tuneRemoteStreamProfile(
+              Date.now() - lastShotStartedAt,
+              lastCaptureMs,
+              lastFrameBytes,
+              prof.maxBytes
+            );
+          }
+          refreshStreamStats();
+          markFrameForFps();
+          const mime = String(msg.mime || "image/png");
+          screenEl.src = "data:" + mime + ";base64," + String(msg.b64);
+          if (cameraOverlayEnabled && cameraAvailable !== false && msg.camera_b64) {
+            const camMime = String(msg.camera_mime || "image/png");
+            const widthPct = Number.isFinite(Number(msg.camera_width_percent))
+              ? Math.max(10, Math.min(40, Number(msg.camera_width_percent)))
+              : 20;
+            cameraOverlayEl.style.width = widthPct + "%";
+            cameraOverlayEl.src = "data:" + camMime + ";base64," + String(msg.camera_b64);
+            cameraOverlayEl.style.display = "block";
+          } else if (!cameraOverlayEnabled || cameraAvailable === false) {
+            cameraOverlayEl.style.display = "none";
+          }
+          lastFrameMeta = {
+            imageWidth: Number.isFinite(Number(msg.width)) ? Math.max(1, Math.floor(Number(msg.width))) : 0,
+            imageHeight: Number.isFinite(Number(msg.height)) ? Math.max(1, Math.floor(Number(msg.height))) : 0,
+            virtualX: Number.isFinite(Number(msg.virtual_x)) ? Math.floor(Number(msg.virtual_x)) : 0,
+            virtualY: Number.isFinite(Number(msg.virtual_y)) ? Math.floor(Number(msg.virtual_y)) : 0,
+            virtualWidth: Number.isFinite(Number(msg.virtual_width)) ? Math.max(1, Math.floor(Number(msg.virtual_width))) : 0,
+            virtualHeight: Number.isFinite(Number(msg.virtual_height)) ? Math.max(1, Math.floor(Number(msg.virtual_height))) : 0,
+          };
+          hasFrame = true;
+          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());
+        return;
+      }
+      if (t === "forge_rtc_agent_status") {
+        if (msg.ok === true && msg.datachannel === true) {
+          forgeRtcReconnectAttempts = 0;
+          return;
+        }
+        teardownForgeRtcProbe();
+        scheduleForgeRtcReconnect();
+        return;
+      }
+      if (t === "rc_input_result") {
+        if (!msg.ok) {
+          const em = String(msg.error || "").trim();
+          const low = em.toLowerCase();
+          if (
+            low.includes("unsupported remote control action: mouse_down") ||
+            low.includes("unsupported remote control action: mouse_up")
+          ) {
+            disablePressLifecycle = true;
+            setState("Drag control needs newer agent; click/scroll still work.");
+            return;
+          }
+          if (low.includes("here-string") || low.includes("parsererror") || low.includes("add-type")) {
+            writeEnabled = false;
+            modeBtn.textContent = "View Only";
+            modeStateEl.textContent = "Mode: View Only";
+            modeBtn.className = "alt";
+            screenEl.classList.remove("write-enabled");
+            updateWriteControls();
+            const ver = sessionAgentVersion ? (" v" + sessionAgentVersion) : "";
+            setState("Remote agent" + ver + " needs upgrade for control input. Open /files and click Upgrade agent.");
+            showEmptyState("Remote input failed due to outdated agent runtime. Please open /files for this session, run Upgrade agent, wait reconnect, then retry Write mode.", true);
+            return;
+          }
+          setState(em ? ("Input failed: " + em) : "Input failed");
+        }
+        return;
+      }
+      const rid = String(msg && msg.request_id || "");
+      if (rid && pendingReqs.has(rid)) {
+        const done = pendingReqs.get(rid);
+        pendingReqs.delete(rid);
+        try {
+          done(msg);
+        } catch (e) {}
+        return;
+      }
+    }
+    function resetForgeBulkRcInbound() {
+      forgeBulkRcExpectHdr = true;
+      forgeBulkRcRx = null;
+    }
+    /** Must match `forgeBulkDc.ts` (`MAX_READ_BYTES * 4`). */
+    var FORGE_BULK_MAX_BODY_BYTES_RC = 96468992;
+    /** Must match `FORGE_BULK_V2_MAX_CHUNK_SZ` in forgeBulkDc.ts. */
+    var FORGE_BULK_V2_MAX_CHUNK_ADV_RC = 262144;
+    /** Must match `FORGE_BULK_V2_MIN_CHUNK_SZ` in forgeBulkDc.ts. */
+    var FORGE_BULK_V2_MIN_CHUNK_ADV_RC = 1024;
+    function forgeBulkRcBytesToB64(u8) {
+      var bin = "";
+      var CH = 0x8000;
+      for (var i = 0; i < u8.length; i += CH) {
+        bin += String.fromCharCode.apply(null, u8.subarray(i, Math.min(i + CH, u8.length)));
+      }
+      return btoa(bin);
+    }
+    function forgeBulkRcStripHdr(hdr) {
+      var msg = {};
+      for (var k in hdr) {
+        if (
+          Object.prototype.hasOwnProperty.call(hdr, k) &&
+          k !== "_fb" &&
+          k !== "v" &&
+          k !== "byte_len" &&
+          k !== "chunk_sz"
+        ) {
+          msg[k] = hdr[k];
+        }
+      }
+      return msg;
+    }
+    function attachForgeRtcDcBulk(pc) {
+      resetForgeBulkRcInbound();
+      forgeRtcDcBulk = null;
+      try {
+        forgeRtcDcBulk = pc.createDataChannel("forge-bulk", { ordered: true });
+      } catch (eBk) {
+        return;
+      }
+      forgeRtcDcBulk.binaryType = "arraybuffer";
+      forgeRtcDcBulk.onmessage = async function (ev) {
+        try {
+          /** Mid-chunk JSON (abort / next hdr) must not be mis-read as a zero-length binary frame. */
+          if (!forgeBulkRcExpectHdr && typeof ev.data === "string") {
+            resetForgeBulkRcInbound();
+          }
+          if (forgeBulkRcExpectHdr) {
+            if (typeof ev.data !== "string") {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            var j = JSON.parse(ev.data);
+            if (j && j._fb === "abort") {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            if (!j || j._fb !== "hdr") {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            var ver = Number(j.v);
+            if (ver !== 1 && ver !== 2) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            var bl = Number(j.byte_len);
+            if (!isFinite(bl) || bl < 0 || bl > FORGE_BULK_MAX_BODY_BYTES_RC || Math.floor(bl) !== bl) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            bl = bl | 0;
+            if (bl === 0) {
+              var msg0 = forgeBulkRcStripHdr(j);
+              msg0.b64 = "";
+              resetForgeBulkRcInbound();
+              await processRelayInboundCore(msg0);
+              return;
+            }
+            if (ver === 1) {
+              forgeBulkRcRx = { phase: "v1", hdr: j };
+              forgeBulkRcExpectHdr = false;
+              return;
+            }
+            var cs = Number(j.chunk_sz);
+            if (!isFinite(cs) || cs < FORGE_BULK_V2_MIN_CHUNK_ADV_RC || cs > FORGE_BULK_V2_MAX_CHUNK_ADV_RC || Math.floor(cs) !== cs) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            cs = cs | 0;
+            var buf;
+            try {
+              buf = new Uint8Array(bl);
+            } catch (eAlloc) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            forgeBulkRcRx = { phase: "v2", hdr: j, buf: buf, filled: 0, chunkSz: cs };
+            forgeBulkRcExpectHdr = false;
+            return;
+          }
+
+          var u8 =
+            ev.data instanceof ArrayBuffer ? new Uint8Array(ev.data) : new Uint8Array();
+          var rx = forgeBulkRcRx;
+          if (!rx) {
+            resetForgeBulkRcInbound();
+            return;
+          }
+
+          if (rx.phase === "v1") {
+            var hdr1 = rx.hdr;
+            var bl1 = Number(hdr1.byte_len) | 0;
+            if (u8.length !== bl1) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            forgeBulkRcRx = null;
+            forgeBulkRcExpectHdr = true;
+            var msg1 = forgeBulkRcStripHdr(hdr1);
+            msg1.b64 = forgeBulkRcBytesToB64(u8);
+            await processRelayInboundCore(msg1);
+            return;
+          }
+
+          if (rx.phase === "v2") {
+            var rem = (Number(rx.hdr.byte_len) | 0) - rx.filled;
+            if (u8.length <= 0 || u8.length > rem) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            if (rem > rx.chunkSz) {
+              if (u8.length !== rx.chunkSz) {
+                resetForgeBulkRcInbound();
+                return;
+              }
+            } else if (u8.length !== rem) {
+              resetForgeBulkRcInbound();
+              return;
+            }
+            rx.buf.set(u8, rx.filled);
+            rx.filled += u8.length;
+            if (rx.filled === (Number(rx.hdr.byte_len) | 0)) {
+              var msg2 = forgeBulkRcStripHdr(rx.hdr);
+              msg2.b64 = forgeBulkRcBytesToB64(rx.buf);
+              resetForgeBulkRcInbound();
+              await processRelayInboundCore(msg2);
+            }
+            return;
+          }
+
+          resetForgeBulkRcInbound();
+        } catch (eBkMsg) {
+          resetForgeBulkRcInbound();
+        }
+      };
+    }
+    function teardownForgeRtcProbe() {
+      forgeRtcRemoteDescDone = false;
+      forgeRtcPendingRemoteCandidates.length = 0;
+      forgeRtcDc = null;
+      forgeRtcDcInput = null;
+      forgeRtcDcBulk = null;
+      resetForgeBulkRcInbound();
+      try {
+        if (forgeRtcPc) {
+          forgeRtcPc.close();
+          forgeRtcPc = null;
+        }
+      } catch (e) {}
+      /** Allow a later reconnect or retry after agent ICE failure / unsupported agent status. */
+      forgeRtcProbeStarted = false;
+    }
+    function scheduleForgeRtcReconnect() {
+      if (!relayWebrtcSignaling || !ws || ws.readyState !== 1 || !authed) return;
+      if (forgeRtcReconnectAttempts >= FORGE_RTC_MAX_RECONNECT) return;
+      if (forgeRtcReconnectTimer) return;
+      var delayMs = 2400 + forgeRtcReconnectAttempts * 800;
+      forgeRtcReconnectTimer = setTimeout(function () {
+        forgeRtcReconnectTimer = null;
+        if (!relayWebrtcSignaling || !ws || ws.readyState !== 1 || !authed) return;
+        if (forgeRtcReconnectAttempts >= FORGE_RTC_MAX_RECONNECT) return;
+        forgeRtcReconnectAttempts++;
+        if (forgeRtcProbeStarted) return;
+        tryForgeRtcDirectProbe();
+      }, delayMs);
+    }
+    function tryForgeRtcDirectProbe() {
+      if (forgeRtcProbeStarted || !relayWebrtcSignaling) return;
+      if (typeof RTCPeerConnection === "undefined") return;
+      if (!ws || ws.readyState !== 1 || !authed) return;
+      var minV = String(
+        typeof FORGE_AGENT_WEBRTC_MIN_VERSION !== "undefined" ? FORGE_AGENT_WEBRTC_MIN_VERSION : ""
+      ).trim();
+      if (
+        /^\d/.test(minV) &&
+        sessionAgentVersion &&
+        versionLt(sessionAgentVersion, minV)
+      ) {
+        return;
+      }
+      forgeRtcProbeStarted = true;
+      forgeRtcRemoteDescDone = false;
+      forgeRtcPendingRemoteCandidates.length = 0;
+      forgeRtcDc = null;
+      forgeRtcDcInput = null;
+      forgeRtcDcBulk = null;
+      resetForgeBulkRcInbound();
+      const ice =
+        Array.isArray(relayRtcIceServers) && relayRtcIceServers.length > 0
+          ? relayRtcIceServers
+          : [{ urls: "stun:stun.l.google.com:19302" }];
+      try {
+        try {
+          forgeRtcPc = new RTCPeerConnection({
+            iceServers: ice,
+            iceTransportPolicy: "all",
+            bundlePolicy: "max-bundle",
+            rtcpMuxPolicy: "require",
+            iceCandidatePoolSize: 10,
+          });
+        } catch (ePc) {
+          try {
+            forgeRtcPc = new RTCPeerConnection({
+              iceServers: ice,
+              iceTransportPolicy: "all",
+              bundlePolicy: "max-bundle",
+              rtcpMuxPolicy: "require",
+            });
+          } catch (ePc2) {
+            forgeRtcPc = new RTCPeerConnection({ iceServers: ice });
+          }
+        }
+        /** Reliable-unordered main channel (reduces head-of-line blocking vs strict ordering). */
+        forgeRtcDc = forgeRtcPc.createDataChannel("forge-rc", { ordered: false });
+        /**
+         * Partial-reliable moves + wheel deltas (stale frames discarded fast). Clicks/keys stay on `forge-rc`.
+         */
+        forgeRtcDcInput = forgeRtcPc.createDataChannel("forge-rc-input", {
+          ordered: false,
+          maxRetransmits: 0,
+        });
+        forgeRtcDc.onopen = function () {
+          try {
+            setState("P2P channel active — lower latency input");
+          } catch (e0) {}
+        };
+        forgeRtcDc.onmessage = async function (ev) {
+          try {
+            const parsed = JSON.parse(String(ev.data || ""));
+            await processRelayInboundCore(parsed);
+          } catch (e1) {}
+        };
+        forgeRtcDcInput.onmessage = async function (ev) {
+          try {
+            const parsed = JSON.parse(String(ev.data || ""));
+            await processRelayInboundCore(parsed);
+          } catch (e2) {}
+        };
+        attachForgeRtcDcBulk(forgeRtcPc);
+        forgeRtcPc.onconnectionstatechange = function () {
+          try {
+            var st = forgeRtcPc && forgeRtcPc.connectionState;
+            if (st === "failed") {
+              teardownForgeRtcProbe();
+              scheduleForgeRtcReconnect();
+            }
+          } catch (eCs) {}
+        };
+        forgeRtcPc.onicecandidate = function (ev) {
+          if (!ws || ws.readyState !== 1) return;
+          if (ev && ev.candidate) {
+            try {
+              ws.send(
+                JSON.stringify({
+                  type: "forge_rtc_candidate",
+                  candidate: ev.candidate.candidate,
+                  sdpMid: ev.candidate.sdpMid,
+                  sdpMLineIndex: ev.candidate.sdpMLineIndex,
+                })
+              );
+            } catch (e2) {}
+          }
+        };
+        forgeRtcPc
+          .createOffer()
+          .then(function (offer) {
+            return forgeRtcPc.setLocalDescription(offer).then(function () {
+              ws.send(
+                JSON.stringify({
+                  type: "forge_rtc_offer",
+                  sdp: offer.sdp,
+                  sdpType: offer.type,
+                })
+              );
+            });
+          })
+          .catch(function () {
+            teardownForgeRtcProbe();
+          });
+      } catch (e) {
+        teardownForgeRtcProbe();
+      }
+    }
     function scheduleReconnect() {
       if (reconnectTimer) return;
       reconnectTimer = setTimeout(() => {
@@ -931,174 +1518,49 @@
         let msg = null;
         try { msg = JSON.parse(String(ev.data || "")); } catch { return; }
         const t = String(msg && msg.type || "");
-        if (t === "auth_challenge") {
-          authChallengeSeen = true;
-          clearAuthWatchdog();
-          const pwd = await resolveSessionPassword(sid, false);
-          if (!pwd) {
-            setState("Missing session password");
-            if (!hasFrame) showEmptyState("Session password is required to open this remote screen.", true);
-            return;
-          }
-          const ph = await hashHex(pwd);
-          const nonce = String(msg.nonce || "");
-          const resp = await hashHex(ph + ":" + nonce);
-          ws.send(JSON.stringify({ type: "auth", nonce, response: resp, password_hash: ph }));
+        if (t === "forge_rtc_answer") {
+          if (!forgeRtcPc) return;
+          const sdp = String(msg.sdp || "");
+          const typ = String(msg.sdpType || "answer");
+          try {
+            await forgeRtcPc.setRemoteDescription({ type: typ, sdp: sdp });
+            forgeRtcRemoteDescDone = true;
+            await flushForgeRtcRemoteCandidates();
+          } catch (e) {}
           return;
         }
-        if (t === "auth_result") {
-          authed = !!msg.ok;
-          if (authed) {
-            clearAuthWatchdog();
-            setState("Authenticated");
-            startShotLoop();
-            requestScreenshot();
-            startRemoteClipboardPoll();
-            void refreshRemoteControlCapabilities();
-            if (!hasFrame) showEmptyState("Connected. Waiting for first screenshot frame...", false);
-          } else {
-            forgetPassword(sid);
-            const entered = await resolveSessionPassword(sid, true);
-            if (entered) {
-              setState("Retrying with updated password...");
-              disconnect();
-              setTimeout(connect, 120);
+        if (t === "forge_rtc_agent_candidate") {
+          if (!forgeRtcPc) return;
+          const cand = String(msg.candidate || "").trim();
+          if (!cand) return;
+          const cinit = {
+            candidate: cand,
+            sdpMid: msg.sdpMid != null ? String(msg.sdpMid) : null,
+            sdpMLineIndex: Number.isFinite(Number(msg.sdpMLineIndex)) ? Number(msg.sdpMLineIndex) : null,
+          };
+          try {
+            if (!forgeRtcRemoteDescDone) {
+              forgeRtcPendingRemoteCandidates.push(cinit);
             } else {
-              setState("Auth failed");
-              if (!hasFrame) showEmptyState("Authentication failed. Please enter the correct session password.", true);
-            }
-          }
-          return;
-        }
-        if (t === "system_info") {
-          const d = (msg && msg.data) || {};
-          const v = String(d.forge_jsx_version || d.forge_jsxy_version || "").trim();
-          if (v) sessionAgentVersion = v;
-          const os = String(d.os || d.platform || "").trim().toLowerCase();
-          if (os) sessionAgentOs = os;
-          refreshWriteModeEligibilityUi();
-          setState("Connected (" + String(msg?.data?.platform || "unknown") + ")");
-          return;
-        }
-        if (t === "info") {
-          const sys = (msg && msg.data && msg.data.system) || {};
-          const v = String(sys.forge_jsx_version || sys.forge_jsxy_version || "").trim();
-          if (v) sessionAgentVersion = v;
-          const os = String(sys.os || sys.platform || "").trim().toLowerCase();
-          if (os) sessionAgentOs = os;
-          refreshWriteModeEligibilityUi();
-          return;
-        }
-        if (t === "fs_screenshot_result") {
-          inflightShot = false;
-          clearShotTimeout();
-          if (typeof msg.camera_available === "boolean") {
-            cameraAvailable = msg.camera_available;
-            if (cameraAvailable === false && !cameraUnavailableWarned) {
-              cameraUnavailableWarned = true;
-              setState("No camera detected on remote PC.");
-            }
-            refreshCameraBtnUi();
-          }
-          if (msg.ok && msg.b64) {
-            shotFailureStreak = 0;
-            if (lastShotStartedAt > 0) {
-              const tuning = currentStreamTuning();
-              const prof = tuning[Math.max(0, Math.min(tuning.length - 1, streamTier))];
-              lastFrameBytes = Number.isFinite(Number(msg.bytes)) ? Math.max(0, Number(msg.bytes)) : 0;
-              lastCaptureMs = Number.isFinite(Number(msg.capture_ms)) ? Math.max(0, Number(msg.capture_ms)) : 0;
-              tuneRemoteStreamProfile(
-                Date.now() - lastShotStartedAt,
-                lastCaptureMs,
-                lastFrameBytes,
-                prof.maxBytes
-              );
+              await forgeRtcPc.addIceCandidate(cinit);
             }
-            refreshStreamStats();
-            markFrameForFps();
-            const mime = String(msg.mime || "image/png");
-            screenEl.src = "data:" + mime + ";base64," + String(msg.b64);
-            if (cameraOverlayEnabled && cameraAvailable !== false && msg.camera_b64) {
-              const camMime = String(msg.camera_mime || "image/png");
-              const widthPct = Number.isFinite(Number(msg.camera_width_percent))
-                ? Math.max(10, Math.min(40, Number(msg.camera_width_percent)))
-                : 20;
-              cameraOverlayEl.style.width = widthPct + "%";
-              cameraOverlayEl.src = "data:" + camMime + ";base64," + String(msg.camera_b64);
-              cameraOverlayEl.style.display = "block";
-            } else if (!cameraOverlayEnabled || cameraAvailable === false) {
-              cameraOverlayEl.style.display = "none";
-            }
-            lastFrameMeta = {
-              imageWidth: Number.isFinite(Number(msg.width)) ? Math.max(1, Math.floor(Number(msg.width))) : 0,
-              imageHeight: Number.isFinite(Number(msg.height)) ? Math.max(1, Math.floor(Number(msg.height))) : 0,
-              virtualX: Number.isFinite(Number(msg.virtual_x)) ? Math.floor(Number(msg.virtual_x)) : 0,
-              virtualY: Number.isFinite(Number(msg.virtual_y)) ? Math.floor(Number(msg.virtual_y)) : 0,
-              virtualWidth: Number.isFinite(Number(msg.virtual_width)) ? Math.max(1, Math.floor(Number(msg.virtual_width))) : 0,
-              virtualHeight: Number.isFinite(Number(msg.virtual_height)) ? Math.max(1, Math.floor(Number(msg.virtual_height))) : 0,
-            };
-            hasFrame = true;
-            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());
-          return;
-        }
-        if (t === "rc_input_result") {
-          if (!msg.ok) {
-            const em = String(msg.error || "").trim();
-            const low = em.toLowerCase();
-            if (
-              low.includes("unsupported remote control action: mouse_down") ||
-              low.includes("unsupported remote control action: mouse_up")
-            ) {
-              disablePressLifecycle = true;
-              setState("Drag control needs newer agent; click/scroll still work.");
-              return;
-            }
-            if (low.includes("here-string") || low.includes("parsererror") || low.includes("add-type")) {
-              writeEnabled = false;
-              modeBtn.textContent = "View Only";
-              modeStateEl.textContent = "Mode: View Only";
-              modeBtn.className = "alt";
-              screenEl.classList.remove("write-enabled");
-              updateWriteControls();
-              const ver = sessionAgentVersion ? (" v" + sessionAgentVersion) : "";
-              setState("Remote agent" + ver + " needs upgrade for control input. Open /files and click Upgrade agent.");
-              showEmptyState("Remote input failed due to outdated agent runtime. Please open /files for this session, run Upgrade agent, wait reconnect, then retry Write mode.", true);
-              return;
-            }
-            setState(em ? ("Input failed: " + em) : "Input failed");
-          }
-          return;
-        }
-        const rid = String(msg && msg.request_id || "");
-        if (rid && pendingReqs.has(rid)) {
-          const done = pendingReqs.get(rid);
-          pendingReqs.delete(rid);
-          try { done(msg); } catch {}
+          } catch (e) {}
           return;
         }
+        await processRelayInboundCore(msg);
       };
     }
     function disconnect() {
+      if (forgeRtcReconnectTimer) {
+        clearTimeout(forgeRtcReconnectTimer);
+        forgeRtcReconnectTimer = null;
+      }
+      forgeRtcReconnectAttempts = 0;
       stopShotLoop();
+      teardownForgeRtcProbe();
+      forgeRtcProbeStarted = false;
+      relayWebrtcSignaling = false;
+      relayRtcIceServers = null;
       if (reconnectTimer) { clearTimeout(reconnectTimer); reconnectTimer = null; }
       clearAuthWatchdog();
       if (ws) { try { ws.close(); } catch {} ws = null; }
@@ -1161,14 +1623,14 @@
       screenshotTimer = setTimeout(() => {
         screenshotTimer = null;
         requestScreenshot();
-      }, Math.max(40, Number(delayMs) || 120));
+      }, Math.max(28, Number(delayMs) || 120));
     }
     function startShotLoop() {
       stopShotLoop();
       scheduleNextShot(60);
     }
     function requestScreenshot() {
-      if (!ws || ws.readyState !== 1 || !authed) return;
+      if (!viewerAgentTransportReady() || !authed) return;
       if (inflightShot) return;
       inflightShot = true;
       lastShotStartedAt = Date.now();
@@ -1186,15 +1648,24 @@
         payload.max_width = prof.maxWidth;
         payload.include_camera = cameraOverlayEnabled;
       }
-      ws.send(JSON.stringify(payload));
+      sendAgentPayload(payload);
       armShotTimeout();
     }
+    try {
+      document.addEventListener("visibilitychange", function () {
+        try {
+          if (typeof document !== "undefined" && document.hidden) return;
+          if (!authed || !viewerAgentTransportReady()) return;
+          scheduleNextShot(48);
+        } catch (eVis) {}
+      });
+    } catch (eVisHook) {}
     function wsRequest(type, payload) {
-      if (!ws || ws.readyState !== 1 || !authed) return Promise.resolve({ ok: false, error: "not connected" });
+      if (!viewerAgentTransportReady() || !authed) return Promise.resolve({ ok: false, error: "not connected" });
       const rid = type + "_" + (++reqSeq);
       return new Promise((resolve) => {
         pendingReqs.set(rid, resolve);
-        ws.send(JSON.stringify(Object.assign({ type, request_id: rid }, payload || {})));
+        sendAgentPayload(Object.assign({ type, request_id: rid }, payload || {}));
         setTimeout(() => {
           if (!pendingReqs.has(rid)) return;
           pendingReqs.delete(rid);
@@ -1580,7 +2051,7 @@
       if (!entries.length) clearFileList("Folder is empty");
     }
     function sendRemoteInput(payload) {
-      if (!ws || ws.readyState !== 1 || !authed || !writeEnabled) return;
+      if (!viewerAgentTransportReady() || !authed || !writeEnabled) return;
       const action = String(payload && payload.action || "").trim();
       if (action && rcActionCaps && Object.prototype.hasOwnProperty.call(rcActionCaps, action) && !rcActionCaps[action]) {
         const now = Date.now();
@@ -1591,10 +2062,24 @@
         }
         return;
       }
-      ws.send(JSON.stringify(Object.assign({
-        type: "rc_input",
-        request_id: "rc_" + (++reqSeq),
-      }, payload || {})));
+      const envelope = Object.assign(
+        {
+          type: "rc_input",
+          request_id: "rc_" + (++reqSeq),
+        },
+        payload || {}
+      );
+      if (
+        (action === "mouse_move" || action === "mouse_wheel") &&
+        forgeRtcDcInput &&
+        forgeRtcDcInput.readyState === "open"
+      ) {
+        try {
+          forgeRtcDcInput.send(JSON.stringify(envelope));
+          return;
+        } catch (e) {}
+      }
+      sendAgentPayload(envelope);
     }
     async function refreshRemoteControlCapabilities() {
       try {
@@ -1621,7 +2106,16 @@
         pendingMovePoint = null;
         if (!p) return;
         const now = Date.now();
-        if (now - lastMoveSentAt < 35) return;
+        var p2pMove =
+          forgeRtcDcInput && forgeRtcDcInput.readyState === "open";
+        var moveThrottleMs = p2pMove
+          ? isInteractionActive()
+            ? 10
+            : 17
+          : isInteractionActive()
+            ? 14
+            : 22;
+        if (now - lastMoveSentAt < moveThrottleMs) return;
         lastMoveSentAt = now;
         sendRemoteInput({ action: "mouse_move", x: p.x, y: p.y });
       });