@remcp/runtime 0.2.80 → 0.2.81

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.2.81 — 2026-09-21
+
+- `record_screen` is advertised only when the current OS/session has a recorder backend the runtime can actually invoke.
+- macOS/Windows require `ffmpeg`; Linux Wayland requires `wf-recorder + timeout`; Linux X11 requires `ffmpeg`.
+- Availability errors are platform-specific, and regression coverage locks the capability matrix.
+- Lockstep patch release with the ReMCP client/server at `0.2.81`.
+
 ## 0.2.80 — 2026-09-21
 
 - Wayland `type_text` can replace text in an inactive explicitly targeted native window without compositor focus when exactly one editable accessibility control is present.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remcp/runtime",
-  "version": "0.2.80",
+  "version": "0.2.81",
   "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, runFile } from './common.mjs';
 import { desktopHandlers } from './desktop.mjs';
-import { diagnosticHandlers } from './diagnostics.mjs';
+import { diagnosticHandlers, recordScreenAvailable } from './diagnostics.mjs';
 import { documentHandlers } from './documents.mjs';
 
 const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
@@ -623,7 +623,7 @@ export async function capabilitySnapshot() {
     apps: win || mac || commandExists('dpkg-query') || commandExists('rpm'),
     audio: win || mac || commandExists('wpctl') || commandExists('pactl') || commandExists('amixer'),
     power: win || mac || commandExists('systemctl') || commandExists('loginctl'),
-    record: win || mac || commandExists('wf-recorder') || commandExists('ffmpeg'),
+    record: recordScreenAvailable({ platform:process.platform, wayland }),
     ooxml: win || (commandExists('zip') && commandExists('unzip')),
   };
 }

package/src/extended/diagnostics.mjs

@@ -5,6 +5,7 @@ import path from 'node:path';
 import process from 'node:process';
 import { stat } from 'node:fs/promises';
 import { assertAllowedCommand } from '../policy.mjs';
+import { isWaylandSession } from '../screenshot-portal.mjs';
 import { resolveSafePath, text } from '../util.mjs';
 import {
   clamp,
@@ -243,6 +244,19 @@ export async function powerAction(args) {
   return text(`${policy.note ? `${policy.note}\n` : ''}Power action ${action} requested.`);
 }
 
+export function recordScreenAvailable({
+  platform = process.platform,
+  wayland = platform === 'linux' ? isWaylandSession() : false,
+  commandExistsFn = commandExists,
+} = {}) {
+  if (platform === 'linux') {
+    if (wayland) return commandExistsFn('wf-recorder') && commandExistsFn('timeout');
+    return commandExistsFn('ffmpeg');
+  }
+  if (platform === 'darwin' || platform === 'win32') return commandExistsFn('ffmpeg');
+  return false;
+}
+
 export async function recordScreen(args) {
   const seconds = clamp(args.duration_seconds, 5, 1, 120);
   const fps = clamp(args.fps, 15, 1, 60);
@@ -251,7 +265,14 @@ export async function recordScreen(args) {
     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 (!commandExists('ffmpeg')) unavailable('Screen recording', 'install wf-recorder on Wayland or ffmpeg');
+    if (process.platform === 'linux' && isWaylandSession()) {
+      unavailable('Screen recording', 'wf-recorder and timeout are required on Wayland');
+    }
+    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');
+      unavailable('Screen recording', 'ffmpeg is required on X11');
+    }
     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];