@remcp/runtime 0.2.140 → 0.2.141

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.141 — 2026-10-02
+
+- Linux `display_inventory` capability discovery now uses the same real backend resolver as execution instead of treating every Wayland session as supported.
+- wlroots compositors gain a native `wlr-randr` parser for connector metadata, logical position/size, scale, transform, pixel mode and refresh rate; the fallback chain is Mutter → wlr-randr → xrandr.
+- Unsupported Wayland sessions without one of those working backends stop advertising `display_inventory`, and dynamic capability polling can add/remove the tool through `tools/list_changed`.
+- Live GNOME Wayland verification still returns the ASUS eDP-1 through Mutter with the 83-tool desktop surface unchanged.
+
 ## 0.2.140 — 2026-10-02
 
 - Windows `create_archive` / `extract_archive` are enabled when the native inbox `tar.exe` (libarchive/bsdtar) backend is available.

package/README.md

@@ -84,7 +84,7 @@ Desktop capabilities additionally require an active graphical session (`DISPLAY`
 headless hosts do not advertise window/UI/input/clipboard/display/screenshot/launch/open/reveal/notification
 operations merely because desktop helper binaries happen to be installed. The universal `computer_snapshot`
 remains available on those hosts but skips unavailable desktop probes instead of reporting synthetic backend
-errors. On Linux, `screenshot_region` is advertised only when the current session has a real matching capture
+errors. Linux `display_inventory` follows the real monitor backend chain (GNOME Mutter DisplayConfig → `wlr-randr` → `xrandr`) and is hidden on Wayland when none of those backends can return a display. On Linux, `screenshot_region` is advertised only when the current session has a real matching capture
 backend (Wayland grim/GNOME/portal path or X11 ImageMagick), not merely because `ffmpeg` is installed.
 
 The generated hosted reference covers the current **10 hosted production definitions**, all model-visible

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remcp/runtime",
-  "version": "0.2.140",
+  "version": "0.2.141",
   "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/catalog.mjs

@@ -9,7 +9,7 @@ import { isWaylandSession } from '../screenshot-portal.mjs';
 import { waylandPortalCandidate } from '../wayland-remote-desktop.mjs';
 import { commandExists, desktopSessionAvailable, runFile } from './common.mjs';
 import { desktopHandlers } from './desktop.mjs';
-import { regionScreenshotBackends } from './desktop-linux.mjs';
+import { displayInventoryAvailable, regionScreenshotBackends } from './desktop-linux.mjs';
 import { diagnosticHandlers, gnomeScreencastSupported, recordScreenAvailable } from './diagnostics.mjs';
 import { documentHandlers } from './documents.mjs';
 
@@ -760,6 +760,7 @@ export async function capabilitySnapshot() {
   const portalCandidate = wayland && waylandPortalCandidate();
   const portalInput = portalCandidate;
   const x11Input = linux && desktopSession && !wayland && (commandExists('wdotool') || commandExists('xdotool'));
+  const displayInventoryReady = linux && desktopSession ? await displayInventoryAvailable() : false;
   const browserCdp = browserRemoteEnabled() && await browserControlAvailable(undefined, 500);
   const documentCapabilities = documentCapabilitySnapshot();
   return {
@@ -770,7 +771,7 @@ export async function capabilitySnapshot() {
     pointer: win || mac || (desktopSession && (portalInput || x11Input)),
     drag: win || mac || (desktopSession && (portalInput || x11Input)),
     clipboard: win || mac || (desktopSession && (commandExists('wl-paste') || commandExists('xclip') || commandExists('xsel'))),
-    displays: win || mac || (desktopSession && ((wayland && linux) || commandExists('wlr-randr') || commandExists('xrandr'))),
+    displays: win || mac || displayInventoryReady,
     screen_region: win || mac || (desktopSession && regionScreenshotBackends({ wayland, portalCandidate }).length > 0),
     notifications: win || mac || (desktopSession && commandExists('notify-send')),
     browser_cdp: browserCdp,

package/src/extended/desktop-linux.mjs

@@ -1445,24 +1445,165 @@ async function mutterDisplayInventory() {
   }
 }
 
-export async function displayInventory() {
-  const mutter = await mutterDisplayInventory();
-  if (mutter) return jsonResult(mutter);
-  if (!commandExists('xrandr')) unavailable('Display inventory', 'GNOME Mutter DisplayConfig or xrandr is required');
-  const { stdout } = await runFile('xrandr', ['--query'], { label: 'display inventory' });
-  let scale = Number(process.env.GDK_SCALE || process.env.QT_SCALE_FACTOR || 0);
+export function parseWlrRandrOutput(stdout) {
+  const rows = [];
+  let current = null;
+
+  const finish = () => {
+    if (!current || current.enabled === false) return;
+    const mode = current.currentMode || current.firstMode;
+    if (!mode) return;
+    const scale = Number.isFinite(current.scale) && current.scale > 0 ? current.scale : 1;
+    const rotated = /(?:^|\D)(?:90|270)(?:\D|$)/.test(current.transform || '');
+    const pixelWidth = mode.width;
+    const pixelHeight = mode.height;
+    rows.push({
+      name:current.name,
+      display_name:current.description || current.model || current.name,
+      primary:false,
+      x:Number.isFinite(current.x) ? current.x : null,
+      y:Number.isFinite(current.y) ? current.y : null,
+      width:Math.round((rotated ? pixelHeight : pixelWidth) / scale),
+      height:Math.round((rotated ? pixelWidth : pixelHeight) / scale),
+      pixel_width:pixelWidth,
+      pixel_height:pixelHeight,
+      scale,
+      refresh_hz:mode.refresh_hz,
+      transform:current.transform || 'normal',
+      builtin:/^(?:eDP|LVDS|DSI)-/i.test(current.name),
+      vendor:current.make || null,
+      product:current.model || null,
+      serial:current.serial || null,
+      backend:'wlr-randr',
+    });
+  };
+
+  for (const rawLine of String(stdout || '').split(/\r?\n/)) {
+    if (rawLine && !/^\s/.test(rawLine)) {
+      finish();
+      const header = rawLine.match(/^(\S+)(?:\s+"([^"]*)")?\s*$/);
+      current = header ? {
+        name:header[1],
+        description:header[2] || '',
+        enabled:true,
+        scale:1,
+        transform:'normal',
+        currentMode:null,
+        firstMode:null,
+      } : null;
+      continue;
+    }
+    if (!current) continue;
+    const line = rawLine.trim();
+    let match;
+    if ((match = line.match(/^Enabled:\s*(yes|no)$/i))) current.enabled = match[1].toLowerCase() === 'yes';
+    else if ((match = line.match(/^Position:\s*(-?\d+)\s*,\s*(-?\d+)$/i))) {
+      current.x = Number(match[1]);
+      current.y = Number(match[2]);
+    } else if ((match = line.match(/^Scale:\s*(\d+(?:\.\d+)?)$/i))) current.scale = Number(match[1]);
+    else if ((match = line.match(/^Transform:\s*(.+)$/i))) current.transform = match[1].trim();
+    else if ((match = line.match(/^Make:\s*(.*)$/i))) current.make = match[1].trim();
+    else if ((match = line.match(/^Model:\s*(.*)$/i))) current.model = match[1].trim();
+    else if ((match = line.match(/^Serial:\s*(.*)$/i))) current.serial = match[1].trim();
+    else if ((match = line.match(/^(\d+)x(\d+)\s+px,\s*([\d.]+)\s+Hz(?:\s+\(([^)]*)\))?/i))) {
+      const mode = { width:Number(match[1]), height:Number(match[2]), refresh_hz:Number(match[3]) };
+      current.firstMode ||= mode;
+      if (/\bcurrent\b/i.test(match[4] || '')) current.currentMode = mode;
+    }
+  }
+  finish();
+  return rows;
+}
+
+export function parseXrandrDisplayOutput(stdout, scale = 1) {
+  const rows = [];
+  for (const line of String(stdout || '').split(/\r?\n/)) {
+    const match = line.match(/^(\S+) connected( primary)?(?: (\d+)x(\d+)\+(-?\d+)\+(-?\d+))?/);
+    if (match) rows.push({
+      name:match[1],
+      display_name:match[1],
+      primary:Boolean(match[2]),
+      width:match[3]?Number(match[3]):null,
+      height:match[4]?Number(match[4]):null,
+      pixel_width:match[3]?Number(match[3]):null,
+      pixel_height:match[4]?Number(match[4]):null,
+      x:match[5]?Number(match[5]):null,
+      y:match[6]?Number(match[6]):null,
+      scale,
+      backend:'xrandr',
+    });
+  }
+  return rows;
+}
+
+async function xrandrDisplayScale({ commandExistsFn = commandExists, runFileFn = runFile, env = process.env } = {}) {
+  let scale = Number(env.GDK_SCALE || env.QT_SCALE_FACTOR || 0);
   if (!Number.isFinite(scale) || scale <= 0) scale = 0;
-  if (!scale && commandExists('gsettings')) {
-    const probe = await runFile('gsettings', ['get','org.gnome.desktop.interface','scaling-factor'], { label:'display scale', allowFailure:true, timeout:1500 });
+  if (!scale && commandExistsFn('gsettings')) {
+    const probe = await runFileFn('gsettings', ['get','org.gnome.desktop.interface','scaling-factor'], { label:'display scale', allowFailure:true, timeout:1500 });
     const parsed = Number(String(probe.stdout || '').match(/(\d+(?:\.\d+)?)/)?.[1]);
     if (Number.isFinite(parsed) && parsed > 0) scale = parsed;
   }
-  if (!scale) scale = 1;
-  const rows = [];
-  for (const line of stdout.split('\n')) {
-    const match = line.match(/^(\S+) connected( primary)?(?: (\d+)x(\d+)\+(-?\d+)\+(-?\d+))?/);
-    if (match) rows.push({ name:match[1], display_name:match[1], primary:Boolean(match[2]), width:match[3]?Number(match[3]):null, height:match[4]?Number(match[4]):null, pixel_width:match[3]?Number(match[3]):null, pixel_height:match[4]?Number(match[4]):null, x:match[5]?Number(match[5]):null, y:match[6]?Number(match[6]):null, scale, backend:'xrandr' });
+  return scale || 1;
+}
+
+export async function resolveLinuxDisplayInventory({
+  wayland = isWaylandSession(),
+  mutterProbe = mutterDisplayInventory,
+  commandExistsFn = commandExists,
+  runFileFn = runFile,
+  env = process.env,
+} = {}) {
+  if (wayland) {
+    const mutter = await mutterProbe().catch(() => null);
+    if (Array.isArray(mutter) && mutter.length) return mutter;
+
+    if (commandExistsFn('wlr-randr')) {
+      const result = await runFileFn('wlr-randr', [], { label:'display inventory', allowFailure:true, timeout:2500, maxBuffer:4*1024*1024 });
+      if (result.code === 0) {
+        const rows = parseWlrRandrOutput(result.stdout);
+        if (rows.length) return rows;
+      }
+    }
   }
+
+  if (commandExistsFn('xrandr')) {
+    const result = await runFileFn('xrandr', ['--query'], { label:'display inventory', allowFailure:true, timeout:2500, maxBuffer:4*1024*1024 });
+    if (result.code === 0) {
+      const scale = await xrandrDisplayScale({ commandExistsFn, runFileFn, env });
+      const rows = parseXrandrDisplayOutput(result.stdout, scale);
+      if (rows.length) return rows;
+    }
+  }
+  return null;
+}
+
+let displayCapabilityCache = { value:false, expiresAt:0, pending:null };
+
+export async function displayInventoryAvailable(options) {
+  if (options && Object.keys(options).length) {
+    return Boolean((await resolveLinuxDisplayInventory(options))?.length);
+  }
+  const now = Date.now();
+  if (displayCapabilityCache.expiresAt > now) return displayCapabilityCache.value;
+  if (displayCapabilityCache.pending) return displayCapabilityCache.pending;
+  const pending = resolveLinuxDisplayInventory()
+    .then(rows => {
+      const value = Boolean(rows?.length);
+      displayCapabilityCache = { value, expiresAt:Date.now() + 5000, pending:null };
+      return value;
+    })
+    .catch(() => {
+      displayCapabilityCache = { value:false, expiresAt:Date.now() + 5000, pending:null };
+      return false;
+    });
+  displayCapabilityCache.pending = pending;
+  return pending;
+}
+
+export async function displayInventory() {
+  const rows = await resolveLinuxDisplayInventory();
+  if (!rows?.length) unavailable('Display inventory', 'GNOME Mutter DisplayConfig, wlr-randr or xrandr is required');
   return jsonResult(rows);
 }