@remcp/runtime 0.2.134 → 0.2.135

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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.

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.134",
+  "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({}) },

package/src/extended/diagnostics.mjs

@@ -367,45 +367,89 @@ 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.`);
-  }
-  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.`);
+
+  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' });
+    }
   }
-  unavailable('Audio control', 'wpctl, pactl or amixer is required on Linux');
+  return jsonResult({ ...(await linuxAudioStatus(backend)), action, backend });
 }
 
 export const POWER_ACTION_MAX_DELAY_SECONDS = 90;