@remcp/runtime 0.2.195 → 0.2.196

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remcp/runtime",
-  "version": "0.2.195",
+  "version": "0.2.196",
   "description": "First-party ReMCP local device runtime: filesystem, terminal, computer-use, browser, diagnostics and document tools over MCP.",
   "type": "module",
   "license": "MIT",

package/src/tools/darwin-memory-pressure.mjs

@@ -0,0 +1,27 @@
+// Read-only macOS kernel telemetry. These readings are not physical RAM occupancy.
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const exec = promisify(execFile);
+const options = { timeout: 1200, maxBuffer: 4096, windowsHide: true };
+const command = (file, args) => exec(file, args, options).then(({ stdout }) => stdout).catch(() => '');
+
+export function parseDarwinMemoryPressure(output, levelOutput) {
+  const match = /^System-wide memory free percentage:\s*(\d{1,3})%\s*$/m.exec(String(output).slice(0, 4096));
+  const free = match ? Number(match[1]) : NaN;
+  const level = /^\s*([124])\s*$/.exec(String(levelOutput).slice(0, 32))?.[1];
+  return {
+    effectiveFreeRatio: Number.isInteger(free) && free >= 0 && free <= 100 ? free / 100 : null,
+    effectiveFreeMethod: Number.isInteger(free) && free >= 0 && free <= 100 ? 'darwin-memory_pressure-Q' : null,
+    pressureLevel: ({ '1': 'normal', '2': 'warning', '4': 'critical' })[level] ?? null,
+    pressureMethod: level ? 'darwin-kernel-sysctl' : null,
+  };
+}
+
+export async function readDarwinMemoryPressure(runner = command) {
+  const [free, level] = await Promise.all([
+    runner('/usr/bin/memory_pressure', ['-Q']),
+    runner('/usr/sbin/sysctl', ['-n', 'kern.memorystatus_vm_pressure_level']),
+  ]);
+  return parseDarwinMemoryPressure(free, level);
+}

package/src/tools/system.mjs

@@ -6,6 +6,7 @@ import { runtimeConfig } from '../config.mjs';
 import { clampInteger, fail, requireInteger, text } from '../util.mjs';
 import { cpuUtilizationRatio, cpuFrequencyMHz, cpuPerCoreUtilizationRatios } from './cpu-telemetry.mjs';
 import { diskVolumes, networkRates, thermalReadings } from './system-telemetry.mjs';
+import { readDarwinMemoryPressure } from './darwin-memory-pressure.mjs';
 
 const run = promisify(execFile);
 
@@ -50,6 +51,7 @@ export async function getSystemInfoTool() {
   const volumesPromise = diskVolumes();
   const thermalPromise = thermalReadings();
   const networkPromise = networkRates();
+  const memoryPressurePromise = process.platform === 'darwin' ? readDarwinMemoryPressure() : Promise.resolve(null);
   const sampledCpus = await new Promise(resolve => setTimeout(() => resolve(os.cpus()), 140));
   const utilizationRatio = cpuUtilizationRatio(cpus, sampledCpus);
   const frequencyMHz = cpuFrequencyMHz(sampledCpus);
@@ -74,6 +76,8 @@ export async function getSystemInfoTool() {
       totalBytes: totalMem,
       freeBytes: freeMem,
       usedRatio: totalMem ? Number(((totalMem - freeMem) / totalMem).toFixed(3)) : 0,
+      usedMethod: 'os.freemem-physical-occupancy',
+      ...(await memoryPressurePromise),
     },
     disk: await diskPromise,
     volumes: await volumesPromise,