@remcp/runtime 0.2.124 → 0.2.125

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.125 — 2026-10-01
+
+- Windows `audio` now controls the default render endpoint through the native Core Audio `IAudioEndpointVolume` interface hosted by inbox PowerShell `Add-Type`.
+- `status` returns the actual 0–100 master level and mute state; `set_volume` is absolute; `mute`/`unmute` use idempotent `SetMute(true/false)` instead of a shared toggle key.
+- Windows release CI compiles the interop definition with PowerShell 5.1 on `windows-latest`. No third-party runtime dependency is added and the 83 tool schemas are unchanged.
+
 ## 0.2.124 — 2026-10-01
 
 - P3 document capability discovery is cross-platform: Windows uses the native .NET OOXML archive backend, while macOS/Linux require both `zip` and `unzip` before advertising the XLSX/DOCX editor tools.

package/package.json

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

@@ -183,6 +183,117 @@ export async function environmentTool(args) {
   });
 }
 
+const WINDOWS_AUDIO_CORE_CSHARP = String.raw`
+using System;
+using System.Runtime.InteropServices;
+
+namespace ReMCP {
+  enum EDataFlow { eRender = 0, eCapture = 1, eAll = 2 }
+  enum ERole { eConsole = 0, eMultimedia = 1, eCommunications = 2 }
+
+  [ComImport]
+  [Guid("BCDE0395-E52F-467C-8E3D-C4579291692E")]
+  class MMDeviceEnumeratorComObject { }
+
+  [ComImport]
+  [Guid("A95664D2-9614-4F35-A746-DE8DB63617E6")]
+  [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+  interface IMMDeviceEnumerator {
+    [PreserveSig] int EnumAudioEndpoints(EDataFlow dataFlow, uint stateMask, out IntPtr devices);
+    [PreserveSig] int GetDefaultAudioEndpoint(EDataFlow dataFlow, ERole role, out IMMDevice endpoint);
+  }
+
+  [ComImport]
+  [Guid("D666063F-1587-4E43-81F1-B948E807363F")]
+  [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+  interface IMMDevice {
+    [PreserveSig] int Activate(ref Guid iid, uint clsCtx, IntPtr activationParams, [MarshalAs(UnmanagedType.IUnknown)] out object instance);
+  }
+
+  [ComImport]
+  [Guid("5CDF2C82-841E-4546-9722-0CF74078229A")]
+  [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+  interface IAudioEndpointVolume {
+    [PreserveSig] int RegisterControlChangeNotify(IntPtr notify);
+    [PreserveSig] int UnregisterControlChangeNotify(IntPtr notify);
+    [PreserveSig] int GetChannelCount(out uint count);
+    [PreserveSig] int SetMasterVolumeLevel(float levelDb, ref Guid eventContext);
+    [PreserveSig] int SetMasterVolumeLevelScalar(float level, ref Guid eventContext);
+    [PreserveSig] int GetMasterVolumeLevel(out float levelDb);
+    [PreserveSig] int GetMasterVolumeLevelScalar(out float level);
+    [PreserveSig] int SetChannelVolumeLevel(uint channel, float levelDb, ref Guid eventContext);
+    [PreserveSig] int SetChannelVolumeLevelScalar(uint channel, float level, ref Guid eventContext);
+    [PreserveSig] int GetChannelVolumeLevel(uint channel, out float levelDb);
+    [PreserveSig] int GetChannelVolumeLevelScalar(uint channel, out float level);
+    [PreserveSig] int SetMute([MarshalAs(UnmanagedType.Bool)] bool muted, ref Guid eventContext);
+    [PreserveSig] int GetMute([MarshalAs(UnmanagedType.Bool)] out bool muted);
+    [PreserveSig] int GetVolumeStepInfo(out uint step, out uint stepCount);
+    [PreserveSig] int VolumeStepUp(ref Guid eventContext);
+    [PreserveSig] int VolumeStepDown(ref Guid eventContext);
+    [PreserveSig] int QueryHardwareSupport(out uint mask);
+    [PreserveSig] int GetVolumeRange(out float minDb, out float maxDb, out float incrementDb);
+  }
+
+  public static class WindowsAudio {
+    const uint CLSCTX_ALL = 23;
+
+    static IAudioEndpointVolume Endpoint() {
+      IMMDeviceEnumerator enumerator = (IMMDeviceEnumerator)(new MMDeviceEnumeratorComObject());
+      IMMDevice device;
+      Marshal.ThrowExceptionForHR(enumerator.GetDefaultAudioEndpoint(EDataFlow.eRender, ERole.eMultimedia, out device));
+      Guid iid = typeof(IAudioEndpointVolume).GUID;
+      object endpoint;
+      Marshal.ThrowExceptionForHR(device.Activate(ref iid, CLSCTX_ALL, IntPtr.Zero, out endpoint));
+      return (IAudioEndpointVolume)endpoint;
+    }
+
+    public static string GetStateJson() {
+      IAudioEndpointVolume endpoint = Endpoint();
+      float scalar;
+      bool muted;
+      Marshal.ThrowExceptionForHR(endpoint.GetMasterVolumeLevelScalar(out scalar));
+      Marshal.ThrowExceptionForHR(endpoint.GetMute(out muted));
+      int volume = (int)Math.Round(Math.Max(0.0f, Math.Min(1.0f, scalar)) * 100.0f, MidpointRounding.AwayFromZero);
+      return "{\"volume\":" + volume.ToString() + ",\"muted\":" + (muted ? "true" : "false") + "}";
+    }
+
+    public static void SetVolume(int volume) {
+      if (volume < 0 || volume > 100) throw new ArgumentOutOfRangeException("volume");
+      IAudioEndpointVolume endpoint = Endpoint();
+      Guid context = Guid.Empty;
+      Marshal.ThrowExceptionForHR(endpoint.SetMasterVolumeLevelScalar(volume / 100.0f, ref context));
+    }
+
+    public static void SetMuted(bool muted) {
+      IAudioEndpointVolume endpoint = Endpoint();
+      Guid context = Guid.Empty;
+      Marshal.ThrowExceptionForHR(endpoint.SetMute(muted, ref context));
+    }
+  }
+}
+`;
+
+export function windowsAudioPowerShell(action = 'status', volume = 50, { compileOnly = false } = {}) {
+  const selected = requireEnum(action, 'action', ['status','set_volume','mute','unmute']);
+  const normalizedVolume = clamp(volume, 50, 0, 100);
+  const mutation = selected === 'set_volume'
+    ? `[ReMCP.WindowsAudio]::SetVolume(${normalizedVolume})`
+    : selected === 'mute'
+      ? '[ReMCP.WindowsAudio]::SetMuted($true)'
+      : selected === 'unmute'
+        ? '[ReMCP.WindowsAudio]::SetMuted($false)'
+        : '';
+  return [
+    "$ErrorActionPreference='Stop'",
+    "$source=@'",
+    WINDOWS_AUDIO_CORE_CSHARP,
+    "'@",
+    'Add-Type -TypeDefinition $source -Language CSharp -ErrorAction Stop',
+    compileOnly ? "Write-Output 'compiled'" : mutation,
+    compileOnly ? '' : '[Console]::Out.WriteLine([ReMCP.WindowsAudio]::GetStateJson())',
+  ].filter(Boolean).join('\n');
+}
+
 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);
@@ -196,12 +307,13 @@ export async function audioTool(args) {
   }
   if (process.platform === 'win32') {
     if (!commandExists('powershell.exe') && !process.env.SystemRoot) unavailable('Windows audio control');
-    if (action === 'status') return text('Windows master-volume status requires the CoreAudio adapter; use set_volume/mute/unmute or install a system audio helper.');
-    // Windows has no stable built-in CLI for CoreAudio; use media keys for mute/volume changes.
-    const key = action === 'mute' || action === 'unmute' ? '{VOLUME_MUTE}' : null;
-    if (key) await runPowerShell(`$w=New-Object -ComObject WScript.Shell;$w.SendKeys('${key}')`, { label:'audio control' });
-    else throw new Error('set_volume on Windows requires an installed CoreAudio helper; exact absolute volume is not exposed by a stable built-in command');
-    return text(`Audio action ${action} requested.`);
+    const { stdout } = await runPowerShell(windowsAudioPowerShell(action, volume), { label:'Windows CoreAudio control', timeout:30_000 });
+    const rendered = stdout.trim();
+    try {
+      return jsonResult(JSON.parse(rendered));
+    } 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());