@remcp/runtime 0.2.172 → 0.2.173

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.173 — 2026-10-22
+
+- Return initial terminal output promptly after a bounded 175 ms grace when a long-running process writes without exiting.
+- Preserve exit-status reporting for immediately completing commands, timeout upper bounds and process-session read/termination semantics.
+- Add terminal regression tests; retain 83 runtime operation routes and unchanged authorization and device safety controls.
+
+
 ## 0.2.172 — 2026-10-22
 
 - Add bounded host-wide CPU utilization sampling based on deltas from `os.cpus().times` so the dashboard can display real CPU percentages instead of treating load average as CPU%.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remcp/runtime",
-  "version": "0.2.172",
+  "version": "0.2.173",
   "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/terminal.mjs

@@ -14,7 +14,6 @@ import {
   readNewOutput,
   readOutputRange,
   totalLines,
-  waitForProcessExit,
   waitForProcessActivity,
 } from '../sessions.mjs';
 import { clampInteger, fail, requireInteger, requireString, structured, text, truncate } from '../util.mjs';
@@ -66,6 +65,21 @@ function terminalStructured(value, fallbackText) {
   return structured(bounded, fallbackText);
 }
 
+// The start call promises initial output, not process completion. Return once
+// useful output arrives, keeping a short grace window so quick commands can
+// still report their real exit status without requiring a follow-up tool call.
+// Explicit timeout_ms remains an upper bound, including for silent commands.
+async function waitForInitialOutput(session, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  const graceUntil = Date.now() + Math.min(175, timeoutMs);
+  while (!session.exited) {
+    const now = Date.now();
+    if (now >= deadline || (now >= graceUntil && hasNewOutput(session))) break;
+    const wakeAt = now < graceUntil ? Math.min(deadline, graceUntil) : deadline;
+    await waitForProcessActivity(session, Math.min(100, Math.max(1, wakeAt - now)));
+  }
+}
+
 export async function startProcessTool(args, extra = {}) {
   const command = requireString(args.command, 'command');
   const verdict = assertAllowedCommand(command);
@@ -105,7 +119,7 @@ export async function startProcessTool(args, extra = {}) {
   child.on('exit', (code, signal) => markProcessExited(session, code, signal));
   child.on('close', (code, signal) => markProcessExited(session, code, signal));
 
-  await waitForProcessExit(session, timeoutMs);
+  await waitForInitialOutput(session, timeoutMs);
   const headline = session.exited
     ? `Process ${session.pid} finished${session.exitCode === null ? '' : ` with code ${session.exitCode}`}${session.signal ? ` (${session.signal})` : ''}.`
     : `Process ${session.pid} is running.`;