@remcp/runtime 0.2.133 → 0.2.135

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.2.135 — 2026-10-02
+
+- Linux `audio` status is normalized across `wpctl`, `pactl`, and `amixer` into structured `volume`, `muted`, `action`, and `backend` fields; mutating audio actions re-read and return the verified state.
+- Windows Core Audio and macOS audio responses expose the same `action`/`backend` fields.
+- The additive `backend` output-schema field changes the tool-surface digest without changing tool names or the 83-tool count.
+
+## 0.2.134 — 2026-10-02
+
+- `power_action delay_seconds` is bounded to 0–90 seconds in schema and runtime validation so a delayed destructive call cannot intentionally outlive the hosted ~110-second device-call lifetime.
+- Delayed power actions use the propagated MCP AbortSignal; cancellation clears the timer and stops before any OS lock/sleep/restart/shutdown command is sent.
+- A second cancellation check runs immediately before platform dispatch. Regression tests cover pre-cancelled, mid-delay-cancelled, and schema-bound behavior.
+- Runtime tool names remain unchanged; this is a safety/correctness tightening of the existing power tool.
+
 ## 0.2.133 — 2026-10-02
 
 - Explicit `computer_action type target=window` now keeps top-level window selectors separate from semantic element selectors; `window_id` is never rewritten into the UI-element `id` before `type_text`.

package/README.md

@@ -49,7 +49,7 @@ support and emits `notifications/tools/list_changed` when that capability set ch
 | Runtime | `get_system_info`, `get_runtime_info`, `get_runtime_stats`, `set_config_value` |
 | Computer use | `computer_snapshot`, `computer_action`, `list_windows`, `window_action`, `launch_app`, `ui_snapshot`, `ui_find`, `ui_action`, `type_text`, `keyboard`, `pointer`, `drag_drop`, `scroll`, `wait_for_ui`, `clipboard`, `display_inventory`, `screenshot_region`, `open_path`, `reveal_path`, `notification` |
 | Browser | `browser_tabs`, `browser_navigate`, `browser_snapshot`, `browser_find`, `browser_action`, `browser_wait`, `browser_evaluate` |
-| Diagnostics | `service`, `event_log`, `network`, `installed_apps`, `environment`, `audio`, `power_action`, `record_screen` |
+| Diagnostics | `service`, `event_log`, `network`, `installed_apps`, `environment`, `audio`, `power_action`, `record_screen` — `audio` returns stable structured `volume`, `muted`, `action`, and `backend` fields across supported OS backends |
 | Documents | `read_document`, `edit_spreadsheet`, `edit_document`, `pdf_action` |
 
 The hosted ReMCP endpoint does not append those 83 granular operation names to its discovery list.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remcp/runtime",
-  "version": "0.2.133",
+  "version": "0.2.135",
   "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

@@ -214,7 +214,7 @@ const OUTPUT_FIELDS = Object.freeze({
   network: { hostname:outputString(), interfaces:outputObject(), dns:outputArray(outputString()), servers:outputArray(outputString()), host:outputString(), port:outputNumber(), ok:outputBoolean(), latency_ms:outputNumber(), interface_count:outputNumber(), interface_count_returned:outputNumber(), address_count:outputNumber(), address_count_returned:outputNumber(), interfaces_truncated:outputBoolean(), addresses_truncated:outputBoolean(), data:outputArray(outputObject()) },
   installed_apps: { data:outputArray(outputObject('Installed app/package with name/version/path where available.')) },
   environment: { platform:outputString(), arch:outputString(), hostname:outputString(), release:outputString(), shell:outputString(), path:outputString(), node:outputString(), env:outputObject() },
-  audio: { volume:outputNumber(), muted:outputBoolean(), action:outputString(), text:outputString() },
+  audio: { volume:outputNumber(), muted:outputBoolean(), action:outputString(), backend:outputString(), text:outputString() },
   power_action: { text:outputString(), action:outputString() },
   record_screen: { path:outputString(), bytes:outputNumber(), duration_seconds:outputNumber(), format:outputString() },
   read_document: { text:outputString(), path:outputString(), data:{}, sheets:outputArray(outputObject()), sheet:outputString(), rows:outputArray({}), cells:outputArray({}) },
@@ -656,7 +656,7 @@ export const extendedToolDefinitions = [
   define('installed_apps', 'Installed applications', 'Inventory installed applications or packages with versions and publishers where available using native package/application inventories.', o({ filter:s('Name substring.'), limit:n('Maximum results; default 1000.') }), readOnly, diagnosticHandlers.installed_apps, ['apps']),
   define('environment', 'Runtime environment', 'Report platform, architecture, Node version, working/home/temp paths, shell, PATH, and optionally environment variables. Environment variables are opt-in and secret-looking or credential-bearing values are masked.', o({ include_env:b('Include sanitized environment variables; default false.') }), readOnly, diagnosticHandlers.environment),
   define('audio', 'Audio control', 'Read or change default output volume or mute state using native operating-system audio controls when available.', o({ action:e(['status','set_volume','mute','unmute']), volume:n('0..100 for set_volume.') }, ['action']), mutatingNonDestructive, diagnosticHandlers.audio, ['audio']),
-  define('power_action', 'Power action', 'Lock, sleep, restart, or shut down the paired computer using native operating-system power facilities. The action passes through ReMCP command policy.', o({ action:e(['lock','sleep','restart','shutdown']), delay_seconds:n('Optional delay, maximum 3600 seconds.') }, ['action']), mutating, diagnosticHandlers.power_action, ['power']),
+  define('power_action', 'Power action', 'Lock, sleep, restart, or shut down the paired computer using native operating-system power facilities. The action passes through ReMCP command policy. Delayed actions are cancelled if the client stops waiting.', o({ action:e(['lock','sleep','restart','shutdown']), delay_seconds:{ type:'number', minimum:0, maximum:90, description:'Optional delay in seconds, maximum 90. Longer delays are rejected because hosted calls expire before they can complete safely.' } }, ['action']), mutating, diagnosticHandlers.power_action, ['power']),
   define('record_screen', 'Record screen', 'Record a short bounded desktop video to a permitted local file for debugging and return its path and size. Uses native/available recording helpers.', o({ duration_seconds:n('1..120 seconds.'), fps:n('1..60.'), destination:s('Permitted output path. If an extension is supplied, use .webm for native GNOME Wayland recording and .mp4 for the other recorder backends.') }), mutating, diagnosticHandlers.record_screen, ['record']),
 
   define('read_document', 'Read document', 'Read PDF, DOCX, XLSX, TXT, Markdown, CSV, JSON, or XML. PDF/DOCX extraction is built in and XLSX is parsed from its OOXML worksheet cells.', o({ path:s('Document path.'), sheet:s('Worksheet name for XLSX.'), max_cells:n() }, ['path']), readOnly, documentHandlers.read_document, ['documents']),

package/src/extended/diagnostics.mjs

@@ -9,7 +9,7 @@ import { lstat, mkdtemp, open, rename, rm, stat, unlink, writeFile } from 'node:
 import { assertAllowedCommand } from '../policy.mjs';
 import { isWaylandSession } from '../screenshot-portal.mjs';
 import { openDirectoryPath } from '../tools/files.mjs';
-import { resolveSafePath, text } from '../util.mjs';
+import { resolveSafePath, text, throwIfCancelled, ToolError } from '../util.mjs';
 import {
   clamp,
   commandExists,
@@ -367,52 +367,130 @@ export function windowsAudioPowerShell(action = 'status', volume = 50, { compile
   ].filter(Boolean).join('\n');
 }
 
+export function parseWpctlAudioStatus(output) {
+  const match = String(output || '').match(/\bVolume:\s*([0-9]+(?:\.[0-9]+)?)(?:\s+\[(MUTED)\])?/i);
+  if (!match) throw new Error('wpctl returned an unrecognized volume status');
+  const scalar = Number(match[1]);
+  if (!Number.isFinite(scalar)) throw new Error('wpctl returned a non-numeric volume');
+  return { volume:Math.round(Math.max(0, Math.min(1, scalar)) * 100), muted:Boolean(match[2]) };
+}
+
+export function parsePactlAudioStatus(volumeOutput, muteOutput) {
+  const volumeMatch = String(volumeOutput || '').match(/\b(\d{1,3})%/);
+  const muteMatch = String(muteOutput || '').match(/\bMute:\s*(yes|no)\b/i);
+  if (!volumeMatch || !muteMatch) throw new Error('pactl returned an unrecognized volume/mute status');
+  return {
+    volume:Math.max(0, Math.min(100, Number(volumeMatch[1]))),
+    muted:muteMatch[1].toLowerCase() === 'yes',
+  };
+}
+
+export function parseAmixerAudioStatus(output) {
+  const rendered = String(output || '');
+  const volumeMatch = rendered.match(/\[(\d{1,3})%\]/);
+  const states = [...rendered.matchAll(/\[(on|off)\]/gi)].map(match => match[1].toLowerCase());
+  if (!volumeMatch || !states.length) throw new Error('amixer returned an unrecognized Master status');
+  return {
+    volume:Math.max(0, Math.min(100, Number(volumeMatch[1]))),
+    muted:states.every(state => state === 'off'),
+  };
+}
+
+async function linuxAudioStatus(backend) {
+  if (backend === 'wpctl') {
+    const { stdout } = await runFile('wpctl', ['get-volume','@DEFAULT_AUDIO_SINK@'], { label:'audio status' });
+    return parseWpctlAudioStatus(stdout);
+  }
+  if (backend === 'pactl') {
+    const volumeResult = await runFile('pactl', ['get-sink-volume','@DEFAULT_SINK@'], { label:'audio status' });
+    const muteResult = await runFile('pactl', ['get-sink-mute','@DEFAULT_SINK@'], { label:'audio status' });
+    return parsePactlAudioStatus(volumeResult.stdout, muteResult.stdout);
+  }
+  const { stdout } = await runFile('amixer', ['get','Master'], { label:'audio status' });
+  return parseAmixerAudioStatus(stdout);
+}
+
 export async function audioTool(args) {
   const action = requireEnum(args.action || 'status', 'action', ['status','set_volume','mute','unmute']);
   const volume = clamp(args.volume, 50, 0, 100);
   if (process.platform === 'darwin') {
-    if (action === 'status') {
+    const readState = async () => {
       const { stdout } = await runOsa('set v to output volume of (get volume settings)\nset m to output muted of (get volume settings)\nreturn (v as text) & tab & (m as text)', { label:'audio status' });
-      const [v,m] = stdout.trim().split('\t'); return jsonResult({ volume:Number(v), muted:m === 'true' });
+      const [v,m] = stdout.trim().split('\t');
+      return { volume:Number(v), muted:m === 'true' };
+    };
+    if (action !== 'status') {
+      await runOsa(action === 'set_volume' ? `set volume output volume ${volume}` : action === 'mute' ? 'set volume with output muted' : 'set volume without output muted', { label:'audio control' });
     }
-    await runOsa(action === 'set_volume' ? `set volume output volume ${volume}` : action === 'mute' ? 'set volume with output muted' : 'set volume without output muted', { label:'audio control' });
-    return audioTool({ action:'status' });
+    return jsonResult({ ...(await readState()), action, backend:'osascript' });
   }
   if (process.platform === 'win32') {
     if (!commandExists('powershell.exe') && !process.env.SystemRoot) unavailable('Windows audio control');
     const { stdout } = await runPowerShell(windowsAudioPowerShell(action, volume), { label:'Windows CoreAudio control', timeout:30_000 });
     const rendered = stdout.trim();
     try {
-      return jsonResult(JSON.parse(rendered));
+      return jsonResult({ ...JSON.parse(rendered), action, backend:'coreaudio' });
     } catch {
       throw new Error(`Windows CoreAudio returned an invalid state payload: ${rendered || '(empty)'}`);
     }
   }
-  if (commandExists('wpctl')) {
-    if (action === 'status') return text((await runFile('wpctl', ['get-volume','@DEFAULT_AUDIO_SINK@'], { label:'audio status' })).stdout.trim());
-    if (action === 'set_volume') await runFile('wpctl', ['set-volume','@DEFAULT_AUDIO_SINK@',`${volume}%`], { label:'audio control' });
-    else await runFile('wpctl', ['set-mute','@DEFAULT_AUDIO_SINK@',action === 'mute' ? '1' : '0'], { label:'audio control' });
-    return text(`Audio action ${action} completed.`);
-  }
-  if (commandExists('pactl')) {
-    if (action === 'status') return text(`${(await runFile('pactl',['get-sink-volume','@DEFAULT_SINK@'],{label:'audio status'})).stdout}${(await runFile('pactl',['get-sink-mute','@DEFAULT_SINK@'],{label:'audio status'})).stdout}`.trim());
-    if (action === 'set_volume') await runFile('pactl', ['set-sink-volume','@DEFAULT_SINK@',`${volume}%`], { label:'audio control' });
-    else await runFile('pactl', ['set-sink-mute','@DEFAULT_SINK@',action === 'mute' ? '1' : '0'], { label:'audio control' });
-    return text(`Audio action ${action} completed.`);
+
+  const backend = commandExists('wpctl') ? 'wpctl' : commandExists('pactl') ? 'pactl' : commandExists('amixer') ? 'amixer' : null;
+  if (!backend) unavailable('Audio control', 'wpctl, pactl or amixer is required on Linux');
+
+  if (action !== 'status') {
+    if (backend === 'wpctl') {
+      if (action === 'set_volume') await runFile('wpctl', ['set-volume','@DEFAULT_AUDIO_SINK@',`${volume}%`], { label:'audio control' });
+      else await runFile('wpctl', ['set-mute','@DEFAULT_AUDIO_SINK@',action === 'mute' ? '1' : '0'], { label:'audio control' });
+    } else if (backend === 'pactl') {
+      if (action === 'set_volume') await runFile('pactl', ['set-sink-volume','@DEFAULT_SINK@',`${volume}%`], { label:'audio control' });
+      else await runFile('pactl', ['set-sink-mute','@DEFAULT_SINK@',action === 'mute' ? '1' : '0'], { label:'audio control' });
+    } else {
+      await runFile('amixer', action === 'set_volume' ? ['set','Master',`${volume}%`] : ['set','Master',action === 'mute' ? 'mute' : 'unmute'], { label:'audio control' });
+    }
   }
-  if (commandExists('amixer')) {
-    if (action === 'status') return text((await runFile('amixer',['get','Master'],{label:'audio status'})).stdout);
-    await runFile('amixer', action === 'set_volume' ? ['set','Master',`${volume}%`] : ['set','Master',action === 'mute' ? 'mute' : 'unmute'], { label:'audio control' });
-    return text(`Audio action ${action} completed.`);
+  return jsonResult({ ...(await linuxAudioStatus(backend)), action, backend });
+}
+
+export const POWER_ACTION_MAX_DELAY_SECONDS = 90;
+
+export function normalizePowerActionDelay(value) {
+  if (value === undefined || value === null || value === '') return 0;
+  const delay = Number(value);
+  if (!Number.isFinite(delay) || delay < 0 || delay > POWER_ACTION_MAX_DELAY_SECONDS) {
+    throw new Error(`delay_seconds must be between 0 and ${POWER_ACTION_MAX_DELAY_SECONDS}`);
   }
-  unavailable('Audio control', 'wpctl, pactl or amixer is required on Linux');
+  return delay;
+}
+
+export async function waitForPowerActionDelay(delaySeconds, signal) {
+  throwIfCancelled(signal);
+  if (delaySeconds <= 0) return;
+
+  await new Promise((resolve, reject) => {
+    let settled = false;
+    const finish = (fn, value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      signal?.removeEventListener?.('abort', onAbort);
+      fn(value);
+    };
+    const onAbort = () => finish(reject, new ToolError('Cancelled by the client; power action was not executed.'));
+    const timer = setTimeout(() => finish(resolve), delaySeconds * 1000);
+    if (signal?.aborted) onAbort();
+    else signal?.addEventListener?.('abort', onAbort, { once:true });
+  });
+
+  throwIfCancelled(signal);
 }
 
-export async function powerAction(args) {
+export async function powerAction(args, extra = {}) {
   const action = requireEnum(args.action, 'action', ['lock','sleep','restart','shutdown']);
   const policy = assertAllowedCommand(action === 'restart' ? 'reboot' : action === 'shutdown' ? 'shutdown' : action);
-  const delay = clamp(args.delay_seconds, 0, 0, 3600);
-  if (delay) await new Promise(resolve => setTimeout(resolve, delay * 1000));
+  const delay = normalizePowerActionDelay(args.delay_seconds);
+  await waitForPowerActionDelay(delay, extra.signal);
+  throwIfCancelled(extra.signal);
   if (process.platform === 'win32') {
     if (action === 'lock') await runPowerShell('rundll32.exe user32.dll,LockWorkStation', { label:'lock workstation' });
     else if (action === 'sleep') await runPowerShell('rundll32.exe powrprof.dll,SetSuspendState 0,1,0', { label:'sleep workstation' });