@remcp/runtime 0.2.82 → 0.2.83

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.83 — 2026-09-21
+
+- Linux X11 `record_screen` capability now requires both `ffmpeg` and a real `DISPLAY`; headless hosts no longer advertise a recorder that will fail.
+- The runtime no longer invents `:0.0` for headless X11 calls and fails closed with a clear display requirement before ffmpeg runs.
+- `wf-recorder` is selected only for actual Wayland sessions.
+- Regression coverage locks the headless capability and handler behavior; lockstep patch release at `0.2.83`.
+
 ## 0.2.82 — 2026-09-21
 
 - Clarified `set_config_value` routing so local runtime preferences stay separate from hosted account-level `device_action` administration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remcp/runtime",
-  "version": "0.2.82",
+  "version": "0.2.83",
   "description": "First-party ReMCP local device runtime: filesystem, terminal, computer-use, browser, diagnostics and document tools over MCP.",
   "type": "module",
   "license": "MIT",

package/src/extended/diagnostics.mjs

@@ -247,11 +247,12 @@ export async function powerAction(args) {
 export function recordScreenAvailable({
   platform = process.platform,
   wayland = platform === 'linux' ? isWaylandSession() : false,
+  display = process.env.DISPLAY || '',
   commandExistsFn = commandExists,
 } = {}) {
   if (platform === 'linux') {
     if (wayland) return commandExistsFn('wf-recorder') && commandExistsFn('timeout');
-    return commandExistsFn('ffmpeg');
+    return Boolean(String(display).trim()) && commandExistsFn('ffmpeg');
   }
   if (platform === 'darwin' || platform === 'win32') return commandExistsFn('ffmpeg');
   return false;
@@ -261,13 +262,17 @@ export async function recordScreen(args) {
   const seconds = clamp(args.duration_seconds, 5, 1, 120);
   const fps = clamp(args.fps, 15, 1, 60);
   const destination = args.destination ? await resolveSafePath(args.destination, 'destination') : path.join(os.tmpdir(), `remcp-screen-${Date.now()}.mp4`);
-  if (process.platform === 'linux' && commandExists('wf-recorder') && commandExists('timeout')) {
+  const wayland = process.platform === 'linux' && isWaylandSession();
+  if (wayland && commandExists('wf-recorder') && commandExists('timeout')) {
     const result = await runFile('timeout', ['--signal=INT', `${seconds}s`, 'wf-recorder', '-f',destination,'-r',String(fps),'-c','libx264'], { label:'screen recording', timeout:(seconds+10)*1000, allowFailure:true });
     if (![0, 124, 130].includes(Number(result.code))) throw new Error(result.stderr.trim() || `wf-recorder exited ${result.code}`);
   } else {
-    if (process.platform === 'linux' && isWaylandSession()) {
+    if (wayland) {
       unavailable('Screen recording', 'wf-recorder and timeout are required on Wayland');
     }
+    if (process.platform === 'linux' && !String(process.env.DISPLAY || '').trim()) {
+      unavailable('Screen recording', 'an active X11 DISPLAY is required on Linux X11');
+    }
     if (!commandExists('ffmpeg')) {
       if (process.platform === 'darwin') unavailable('Screen recording', 'ffmpeg is required on macOS');
       if (process.platform === 'win32') unavailable('Screen recording', 'ffmpeg is required on Windows');
@@ -276,7 +281,7 @@ export async function recordScreen(args) {
     let argv;
     if (process.platform === 'win32') argv=['-y','-f','gdigrab','-framerate',String(fps),'-i','desktop','-t',String(seconds),'-pix_fmt','yuv420p',destination];
     else if (process.platform === 'darwin') argv=['-y','-f','avfoundation','-framerate',String(fps),'-i','1:none','-t',String(seconds),'-pix_fmt','yuv420p',destination];
-    else argv=['-y','-f','x11grab','-framerate',String(fps),'-i',process.env.DISPLAY || ':0.0','-t',String(seconds),'-pix_fmt','yuv420p',destination];
+    else argv=['-y','-f','x11grab','-framerate',String(fps),'-i',process.env.DISPLAY,'-t',String(seconds),'-pix_fmt','yuv420p',destination];
     await runFile('ffmpeg', argv, { label:'screen recording', timeout:(seconds+20)*1000, maxBuffer:8*1024*1024 });
   }
   const info = await stat(destination);