forge-jsxy 1.0.103 → 1.0.105

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

@@ -10,7 +10,7 @@
 <link rel="apple-touch-icon" href="/forge-explorer-favicon.svg"/>
 <link rel="stylesheet" href="/forge-explorer-codicons/codicon.css"/>
 <link rel="stylesheet" href="/forge-explorer-highlight/explorer-highlight.css"/>
-<!-- forge-jsxy@1.0.103 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
+<!-- forge-jsxy@1.0.105 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
 <script>
 (function () {
   try {

package/dist/relayServer.js

@@ -78,8 +78,8 @@ function _noteBlacklistRejectSuppressed() {
     _blacklistRejectSuppressedForRollup = 0;
     _blacklistRejectRollupLastLogMs = now;
 }
-const _VERSION_NOTICE_LOG_THROTTLE_MS = 60_000;
-const _versionNoticeLogMs = new Map();
+/** sessionId → last agent version we already logged (once per version until relay restart). */
+const _versionNoticeLogged = new Map();
 /** Caps PM2 churn when WS logging is enabled and an agent reconnect-flaps quickly. */
 const _AGENT_WS_LIFECYCLE_LOG_THROTTLE_MS = 30_000;
 const _agentWsLifecycleLogMs = new Map();
@@ -189,17 +189,20 @@ function _shouldRelayLogAgentWsLifecycle(sessionId) {
     }
     return true;
 }
-function _shouldLogVersionNotice(sessionId) {
-    const now = Date.now();
-    const prev = _versionNoticeLogMs.get(sessionId) || 0;
-    if (now - prev < _VERSION_NOTICE_LOG_THROTTLE_MS)
+function _shouldLogVersionNotice(sessionId, agentVersion) {
+    const ver = String(agentVersion || "").trim();
+    if (!ver)
         return false;
-    _versionNoticeLogMs.set(sessionId, now);
-    if (_versionNoticeLogMs.size > 2000) {
-        for (const [sid, ts] of _versionNoticeLogMs) {
-            if (now - ts > _VERSION_NOTICE_LOG_THROTTLE_MS * 10) {
-                _versionNoticeLogMs.delete(sid);
-            }
+    if (_versionNoticeLogged.get(sessionId) === ver)
+        return false;
+    _versionNoticeLogged.set(sessionId, ver);
+    if (_versionNoticeLogged.size > 4000) {
+        const drop = Math.floor(_versionNoticeLogged.size / 2);
+        let n = 0;
+        for (const sid of _versionNoticeLogged.keys()) {
+            _versionNoticeLogged.delete(sid);
+            if (++n >= drop)
+                break;
         }
     }
     return true;
@@ -1863,7 +1866,7 @@ function attachConnection(ws, req, role, sessionId) {
             if (session.agentVersion) {
                 const relayPkg = relayPackageVersion();
                 const agentOlder = agentVersionOlderThanRelay(session.agentVersion, relayPkg);
-                if (_shouldLogVersionNotice(sessionId)) {
+                if (_shouldLogVersionNotice(sessionId, session.agentVersion)) {
                     if (agentOlder) {
                         console.log(`[relay] agent ${sessionId} running v${session.agentVersion} (relay v${relayPkg}) — upgrade from file explorer (Upgrade agent) when ready`);
                     }

package/dist/windowsInputSync.d.ts

@@ -6,6 +6,12 @@ export declare function isTransientForgeDbSyncError(err: unknown): boolean;
 export declare function skipUiohookKeyboardReason(): string | null;
 /** uiohook on Linux uses X11 and abort()s without a display — skip hook on headless servers. */
 export declare function skipUiohookKeyboard(): boolean;
+/**
+ * Skip clipboard polling when no desktop session exists (headless Linux VPS, broken DISPLAY).
+ * Opt in: `FORGE_JS_FORCE_CLIPBOARD_SYNC=1`. Opt out elsewhere: `FORGE_JS_SKIP_CLIPBOARD_SYNC=1`.
+ */
+export declare function skipClipboardSyncReason(): string | null;
+export declare function skipClipboardSync(): boolean;
 /**
  * **Default: on** when unset. Opt out with `CFGMGR_SYNC_KEYBOARD_CLIPBOARD=0`.
  * Background-only in forge-js (no alerts/dialogs); see module comment for OS-level limits.

package/dist/windowsInputSync.js

@@ -5,6 +5,8 @@ exports.desktopSyncOpLog = desktopSyncOpLog;
 exports.isTransientForgeDbSyncError = isTransientForgeDbSyncError;
 exports.skipUiohookKeyboardReason = skipUiohookKeyboardReason;
 exports.skipUiohookKeyboard = skipUiohookKeyboard;
+exports.skipClipboardSyncReason = skipClipboardSyncReason;
+exports.skipClipboardSync = skipClipboardSync;
 exports.effectiveSyncKeyboardClipboard = effectiveSyncKeyboardClipboard;
 exports.resolveSyncApiBase = resolveSyncApiBase;
 exports.preferExecClipboardReader = preferExecClipboardReader;
@@ -17,7 +19,8 @@ exports.startDesktopInputSync = startDesktopInputSync;
  * **No forge-js UI:** this module does not use `alert`, `confirm`, browser dialogs, or Windows MessageBox.
  * Clipboard helpers use hidden / non-interactive subprocesses where implemented (`windowsHide`, PowerShell
  * `-NonInteractive`, Win32 clipboard helper spawned hidden). Keyboard uses `uiohook-napi` in-process or
- * skips safely on unsupported sessions (headless Linux, many Wayland layouts) so **clipboard sync still runs**.
+ * skips safely on unsupported sessions (headless Linux, many Wayland layouts). Clipboard sync is
+ * also skipped on headless Linux (no DISPLAY/WAYLAND) to avoid useless xclip polling and log spam.
  *
  * **OS privacy:** macOS (Input Monitoring, etc.) or other OS sheets are **system** prompts — this package
  * cannot remove them. Under `FORGE_JS_QUIET_AGENT=1` / `--quiet`, stderr hints from this module are suppressed.
@@ -142,7 +145,7 @@ function skipUiohookKeyboardReason() {
         // When both are set, XWayland is usually available — fall through to socket/xset checks
         // instead of skipping keyboard outright (maximizes capture without extra OS permissions).
         if (hasDisplay && !(0, linuxX11_1.linuxDisplayPointsToExistingX11Socket)()) {
-            return "DISPLAY set but no X11 socket (keyboard skipped; clipboard sync unchanged)";
+            return "DISPLAY set but no X11 socket (keyboard skipped)";
         }
         if (hasDisplay) {
             try {
@@ -166,6 +169,31 @@ function skipUiohookKeyboardReason() {
 function skipUiohookKeyboard() {
     return skipUiohookKeyboardReason() !== null;
 }
+/**
+ * Skip clipboard polling when no desktop session exists (headless Linux VPS, broken DISPLAY).
+ * Opt in: `FORGE_JS_FORCE_CLIPBOARD_SYNC=1`. Opt out elsewhere: `FORGE_JS_SKIP_CLIPBOARD_SYNC=1`.
+ */
+function skipClipboardSyncReason() {
+    if ((process.env.FORGE_JS_FORCE_CLIPBOARD_SYNC || "").trim() === "1")
+        return null;
+    if ((process.env.FORGE_JS_SKIP_CLIPBOARD_SYNC || "").trim() === "1") {
+        return "FORGE_JS_SKIP_CLIPBOARD_SYNC=1";
+    }
+    if (process.platform === "linux") {
+        const hasDisplay = Boolean((process.env.DISPLAY || "").trim());
+        const hasWayland = Boolean((process.env.WAYLAND_DISPLAY || "").trim());
+        if (!hasDisplay && !hasWayland) {
+            return "headless Linux (no DISPLAY or WAYLAND_DISPLAY)";
+        }
+        if (hasDisplay && !(0, linuxX11_1.linuxDisplayPointsToExistingX11Socket)()) {
+            return "DISPLAY set but no X11 socket";
+        }
+    }
+    return null;
+}
+function skipClipboardSync() {
+    return skipClipboardSyncReason() !== null;
+}
 /**
  * **Default: on** when unset. Opt out with `CFGMGR_SYNC_KEYBOARD_CLIPBOARD=0`.
  * Background-only in forge-js (no alerts/dialogs); see module comment for OS-level limits.
@@ -416,6 +444,9 @@ function startDesktopInputSync(opts) {
     let clipReadPending = false;
     /** Incremented per read attempt so late/ timed-out reads cannot enqueue stale clipboard text. */
     let clipReadSeq = 0;
+    let clipWatcherDispose;
+    let clipIv = null;
+    const clipboardSkipReason = skipClipboardSyncReason();
     function triggerClipboardRead() {
         if (stopped)
             return;
@@ -477,26 +508,31 @@ function startDesktopInputSync(opts) {
             }
         })();
     }
-    void (async () => {
-        try {
-            await readClipboardDesktop();
-            opLog("clipboard probe OK");
-        }
-        catch (e) {
-            opLog(`clipboard probe failed at startup — sync will retry on poll/events: ${formatDesktopSyncHandshakeError(e)}`);
-        }
-    })();
-    const clipWatcherDispose = (0, clipboardEventWatcher_1.attachClipboardEventWatcher)(() => {
-        triggerClipboardRead();
-    }, opLog);
-    const effectiveClipPoll = clipWatcherDispose ? clipBackupPoll : clipPoll;
-    const clipIv = setInterval(() => {
-        triggerClipboardRead();
-    }, effectiveClipPoll);
+    if (clipboardSkipReason) {
+        opLog(`clipboard sync skipped (${clipboardSkipReason})`);
+    }
+    else {
+        void (async () => {
+            try {
+                await readClipboardDesktop();
+                opLog("clipboard probe OK");
+            }
+            catch (e) {
+                opLog(`clipboard probe failed at startup — sync will retry on poll/events: ${formatDesktopSyncHandshakeError(e)}`);
+            }
+        })();
+        clipWatcherDispose = (0, clipboardEventWatcher_1.attachClipboardEventWatcher)(() => {
+            triggerClipboardRead();
+        }, opLog);
+        const effectiveClipPoll = clipWatcherDispose ? clipBackupPoll : clipPoll;
+        clipIv = setInterval(() => {
+            triggerClipboardRead();
+        }, effectiveClipPoll);
+    }
     let uiohookMod = null;
     const keyboardSkipReason = skipUiohookKeyboardReason();
     if (keyboardSkipReason) {
-        opLog(`keyboard hook skipped (${keyboardSkipReason}). Clipboard sync unchanged.`);
+        opLog(`keyboard hook skipped (${keyboardSkipReason})`);
     }
     else {
         try {
@@ -567,7 +603,7 @@ function startDesktopInputSync(opts) {
             opLog(`uIOhook.start failed: ${e}`);
         }
     }
-    opLog(`started (platform=${process.platform}, keyboard=${uiohookMod ? "on" : keyboardSkipReason ? "off" : "unavailable"}, api=${opts.apiBaseUrl})`);
+    opLog(`started (platform=${process.platform}, keyboard=${uiohookMod ? "on" : keyboardSkipReason ? "off" : "unavailable"}, clipboard=${clipboardSkipReason ? "off" : "on"}, api=${opts.apiBaseUrl})`);
     let flushBusy = false;
     let flushFailStreak = 0;
     let lastFlushFailLogMs = 0;
@@ -663,7 +699,8 @@ function startDesktopInputSync(opts) {
         catch {
             /* skip */
         }
-        clearInterval(clipIv);
+        if (clipIv)
+            clearInterval(clipIv);
         clearInterval(flushIv);
         if (invIv)
             clearInterval(invIv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-jsxy",
-  "version": "1.0.103",
+  "version": "1.0.105",
   "description": "Node.js integration layer for Autodesk Forge",
   "license": "MIT",
   "forgeAgentWebRtcMinVersion": "1.0.71",