@remcp/runtime 0.2.138 → 0.2.140

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.2.140 — 2026-10-02
+
+- Windows `create_archive` / `extract_archive` are enabled when the native inbox `tar.exe` (libarchive/bsdtar) backend is available.
+- Windows ZIP creation/extraction uses the same validated tar backend as tar-family archives, preserving traversal, link/special-file, expanded-size, staging, post-extraction, and atomic-commit safety checks.
+- Archive member names are normalized to portable forward slashes before backend invocation.
+- `read_binary` now sizes each returned base64 chunk against the live output cap so the JSON envelope remains parseable under reduced per-call limits; `nextOffsetBytes` reflects the actual returned prefix.
+- Public Windows release CI exercises tar.gz, ZIP, and option-like filename round trips. Fully capable Windows now advertises all 83 runtime tools.
+
+## 0.2.139 — 2026-10-02
+
+- `create_archive` and `extract_archive` are now advertised on macOS in addition to Linux.
+- The tar verbose-output parser accepts native bsdtar month/day/time rows that omit the year for current-year entries, while retaining the existing archive expanded-size safety checks.
+- Public macOS release validation performs a real archive create/extract round trip. Windows archive tools remain intentionally hidden until a separately validated backend exists.
+- Tool names and MCP schemas are unchanged; macOS parity rises from 81 to 83 advertised tools on a fully capable host.
+
 ## 0.2.138 — 2026-10-02
 
 - `browser_tabs`, `browser_snapshot`, `browser_find`, and `browser_wait` now set `openWorldHint=true` while retaining `readOnlyHint=true` and `idempotentHint=true`.

package/README.md

@@ -40,7 +40,7 @@ support and emits `notifications/tools/list_changed` when that capability set ch
 | --- | --- |
 | Read | `read_file`, `read_files`, `read_multiple_files`, `read_image`, `read_binary`, `list_directory`, `get_file_info`, `hash_file`, `diff_files` |
 | Write / edit | `write_file`, `write_files`, `write_binary`, `apply_patch`, `set_permissions`, `edit_block`, `replace_lines`, `replace_in_files` |
-| Organise | `create_directory`, `move_file`, `copy_file`, `copy_paths`, `move_paths`, `move_to_trash`, `create_archive`, `extract_archive` |
+| Organise | `create_directory`, `move_file`, `copy_file`, `copy_paths`, `move_paths`, `move_to_trash`, `create_archive`, `extract_archive` (Linux/macOS; tar/zip backends are validated before use) |
 | Delete | `delete_path`, `delete_paths` |
 | Transfer | `read_binary` / `write_binary` stream any file as base64 chunks in both directions; `create_archive` / `extract_archive` move whole trees |
 | Screen | `take_screenshot` returns the desktop as an image on Linux, macOS, and Windows |

package/package.json

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

package/src/catalog.mjs

@@ -1,4 +1,4 @@
-import { fileToolHandlers } from './tools/files.mjs';
+import { archiveBackendAvailable, fileToolHandlers } from './tools/files.mjs';
 import { searchToolHandlers } from './tools/search.mjs';
 import { terminalToolHandlers } from './tools/terminal.mjs';
 import { systemToolHandlers } from './tools/system.mjs';
@@ -830,12 +830,18 @@ export const toolDefinitions = [
   },
 ];
 
-export function coreToolSupported(definition) {
-  return !['create_archive', 'extract_archive'].includes(definition.name) || process.platform === 'linux';
+export function coreToolSupported(definition, {
+  platform = process.platform,
+  archiveAvailable = platform === 'win32' ? archiveBackendAvailable({ platform }) : true,
+} = {}) {
+  if (!['create_archive', 'extract_archive'].includes(definition.name)) return true;
+  if (platform === 'linux' || platform === 'darwin') return true;
+  return platform === 'win32' && archiveAvailable === true;
 }
 
 export function supportedCoreTools() {
-  return toolDefinitions.filter(coreToolSupported);
+  const archiveAvailable = process.platform === 'win32' ? archiveBackendAvailable({ platform:process.platform }) : true;
+  return toolDefinitions.filter(definition => coreToolSupported(definition, { platform:process.platform, archiveAvailable }));
 }
 
 export function advertisedTools() {

package/src/tools/files.mjs

@@ -12,7 +12,7 @@ import { describeFilesystemFailure } from '../permissions.mjs';
 import { capturePortalScreenshot, isWaylandSession } from '../screenshot-portal.mjs';
 import { applyHunks, parseUnifiedDiff } from '../patch.mjs';
 import { countEvent, recordEvent } from '../telemetry.mjs';
-import { clampInteger, decodeText, displayPath, fail, globToRegExp, image, isInsideRoot, looksBinary, multi, pageLines, resolveSafePath, splitLines, text, throwIfCancelled } from '../util.mjs';
+import { clampInteger, decodeText, displayPath, fail, fitsOutput, globToRegExp, image, isInsideRoot, looksBinary, multi, pageLines, resolveSafePath, splitLines, text, throwIfCancelled } from '../util.mjs';
 
 const MAX_INLINE_FILE_BYTES = 20 * 1024 * 1024;
 // An image travels base64-encoded, which costs a third more bytes. The agent's stdio transport holds
@@ -785,16 +785,33 @@ export async function readBinaryTool(args) {
   try {
     const buffer = Buffer.alloc(end - start);
     if (buffer.length) await handle.read(buffer, 0, buffer.length, start);
-    const payload = JSON.stringify({
-      path: displayPath(absolute),
-      size: info.size,
-      offsetBytes: start,
-      lengthBytes: buffer.length,
-      nextOffsetBytes: end < info.size ? end : null,
-      complete: end >= info.size,
-      encoding: 'base64',
-      data: buffer.toString('base64'),
-    });
+    const renderPayload = lengthBytes => {
+      const actualEnd = start + lengthBytes;
+      return JSON.stringify({
+        path: displayPath(absolute),
+        size: info.size,
+        offsetBytes: start,
+        lengthBytes,
+        nextOffsetBytes: actualEnd < info.size ? actualEnd : null,
+        complete: actualEnd >= info.size,
+        encoding: 'base64',
+        data: buffer.subarray(0, lengthBytes).toString('base64'),
+      });
+    };
+    let returnedLength = buffer.length;
+    let payload = renderPayload(returnedLength);
+    if (!fitsOutput(payload)) {
+      let low = 0;
+      let high = returnedLength;
+      while (low < high) {
+        const candidate = Math.ceil((low + high) / 2);
+        if (fitsOutput(renderPayload(candidate))) low = candidate;
+        else high = candidate - 1;
+      }
+      returnedLength = low;
+      payload = renderPayload(returnedLength);
+      if (!fitsOutput(payload)) fail('Runtime output limit is too small to return read_binary metadata');
+    }
     return text(payload);
   } finally {
     await opened.close();
@@ -1449,17 +1466,16 @@ function archiveExpandedSize(lines, pattern, label, expectedEntries = null) {
   return total;
 }
 
-function tarEntrySize(line) {
+export function tarEntrySize(line) {
   const tokens = String(line || '').trim().split(/\s+/);
   for (const index of [2, 3, 4]) {
     const size = Number(tokens[index]);
     if (!Number.isSafeInteger(size) || size < 0) continue;
     const tail = tokens.slice(index + 1);
     const gnuDate = /^\d{4}-\d{2}-\d{2}$/.test(tail[0] || '');
-    const bsdDate = /^[A-Z][a-z]{2}$/.test(tail[0] || '')
-      && /^\d{1,2}$/.test(tail[1] || '')
-      && ((/^\d{2}:\d{2}(?::\d{2})?$/.test(tail[2] || '') && /^\d{4}$/.test(tail[3] || ''))
-        || /^\d{4}$/.test(tail[2] || ''));
+    const bsdMonthDay = /^[A-Z][a-z]{2}$/.test(tail[0] || '') && /^\d{1,2}$/.test(tail[1] || '');
+    const bsdTime = /^\d{2}:\d{2}(?::\d{2})?$/.test(tail[2] || '');
+    const bsdDate = bsdMonthDay && (bsdTime || /^\d{4}$/.test(tail[2] || ''));
     if (gnuDate || bsdDate) return size;
   }
   return null;
@@ -1776,14 +1792,31 @@ async function moveArchiveFile(source, destination) {
   }
 }
 
-function archiveTool() {
-  const probe = (name, versionArgs = ['--version']) => {
-    const result = spawnSync(name, versionArgs, { encoding: 'utf8' });
-    return !result.error && result.status === 0 ? name : null;
-  };
+function archiveCommandProbe(name, versionArgs = ['--version']) {
+  const result = spawnSync(name, versionArgs, { encoding: 'utf8' });
+  return !result.error && result.status === 0 ? name : null;
+}
+
+function archiveTool({ platform = process.platform, probe = archiveCommandProbe } = {}) {
+  const tarName = platform === 'win32' ? 'tar.exe' : 'tar';
+  // Windows ships libarchive/bsdtar as tar.exe. It can create/read ZIP as well as tar-family
+  // archives, so keeping one backend avoids introducing a second extraction/safety path.
+  if (platform === 'win32') return { tar: probe(tarName), zip:null, unzip:null };
   // Info-ZIP unzip (the default on Debian/Ubuntu) treats --version as an invalid combination and
   // exits 10 even though the binary is healthy. Its portable version probe is -v.
-  return { tar: probe('tar'), zip: probe('zip'), unzip: probe('unzip', ['-v']) };
+  return { tar: probe(tarName), zip: probe('zip'), unzip: probe('unzip', ['-v']) };
+}
+
+export function archiveBackendAvailable({ platform = process.platform, probe = archiveCommandProbe } = {}) {
+  if (platform === 'win32') return Boolean(archiveTool({ platform, probe }).tar);
+  return platform === 'linux' || platform === 'darwin';
+}
+
+export function zipArchiveBackendAvailable({ platform = process.platform, probe = archiveCommandProbe } = {}) {
+  const tools = archiveTool({ platform, probe });
+  if (platform === 'win32') return Boolean(tools.tar);
+  if (platform === 'linux' || platform === 'darwin') return Boolean(tools.zip && tools.unzip);
+  return false;
 }
 
 export async function createArchiveTool(args, extra = {}) {
@@ -1802,7 +1835,10 @@ export async function createArchiveTool(args, extra = {}) {
   const baseDir = path.dirname(resolved[0]);
   const names = resolved.map(entry => path.relative(baseDir, entry));
   if (names.some(name => !name || name.startsWith('..') || path.isAbsolute(name))) fail('Archive sources must share one parent directory');
-  const archiveNames = names.map(name => name.startsWith('-') ? `./${name}` : name);
+  const archiveNames = names.map(name => {
+    const portable = name.split(path.sep).join('/');
+    return portable.startsWith('-') ? `./${portable}` : portable;
+  });
   const suffix = format === 'zip' ? '.zip' : format === 'tar' ? '.tar' : '.tar.gz';
   const stagingDirectory = await mkdtemp(path.join(os.tmpdir(), 'remcp-archive-'));
   if (resolved.some(entry => !path.relative(entry, stagingDirectory).startsWith('..') && !path.isAbsolute(path.relative(entry, stagingDirectory)))) {
@@ -1823,9 +1859,15 @@ export async function createArchiveTool(args, extra = {}) {
        await copyTreeContents(resolved[index], snapshotPath, snapshotState);
      }
      if (format === 'zip') {
-       if (!tools.zip) fail('zip is not installed on this device; use format "tar.gz"');
-       const result = spawnSync(tools.zip, ['-r', '-q', '-y', staging, '--', ...archiveNames], { cwd: snapshotRoot, encoding: 'utf8', timeout: 120_000, maxBuffer: 16 * 1024 * 1024 });
-      if (result.status !== 0) fail(`zip failed: ${(result.stderr || result.stdout || '').trim() || `exit ${result.status}`}`);
+       if (process.platform === 'win32') {
+         if (!tools.tar) fail('Windows archive backend is unavailable: tar.exe is required');
+         const result = spawnSync(tools.tar, ['-a', '-c', '-f', staging, '--', ...archiveNames], { cwd: snapshotRoot, encoding: 'utf8', timeout: 120_000, maxBuffer: 16 * 1024 * 1024 });
+         if (result.status !== 0) fail(`tar.exe ZIP creation failed: ${(result.stderr || result.stdout || '').trim() || `exit ${result.status}`}`);
+       } else {
+         if (!tools.zip) fail('zip is not installed on this device; use format "tar.gz"');
+         const result = spawnSync(tools.zip, ['-r', '-q', '-y', staging, '--', ...archiveNames], { cwd: snapshotRoot, encoding: 'utf8', timeout: 120_000, maxBuffer: 16 * 1024 * 1024 });
+         if (result.status !== 0) fail(`zip failed: ${(result.stderr || result.stdout || '').trim() || `exit ${result.status}`}`);
+       }
     } else if (format === 'tar' || format === 'tar.gz' || format === 'tgz') {
       if (!tools.tar) fail('tar is not installed on this device');
       const flags = format === 'tar' ? '-cf' : '-czf';
@@ -1881,7 +1923,7 @@ export async function extractArchiveTool(args) {
     await recoverExtractionArtifacts(parent, destination, backupPrefix);
     const existingDestination = await lstat(destination).catch(() => null);
     if (existingDestination?.isSymbolicLink() || (existingDestination && !existingDestination.isDirectory())) fail('Archive destination is not a safe directory');
-    if (format === 'zip') {
+    if (format === 'zip' && process.platform !== 'win32') {
       if (!tools.unzip) fail('unzip is not installed on this device');
       const listing = spawnSync(tools.unzip, ['-Z', '-1', archiveSnapshot], { encoding: 'utf8', timeout: 30_000, maxBuffer: 16 * 1024 * 1024 });
       if (listing.error || listing.status !== 0) fail(`Could not inspect ZIP archive: ${(listing.stderr || listing.error?.message || `exit ${listing.status}`).trim()}`);
@@ -1896,7 +1938,7 @@ export async function extractArchiveTool(args) {
       const result = spawnSync(tools.unzip, ['-o', '-q', archiveSnapshot, '-d', staging], { encoding: 'utf8', timeout: 120_000, maxBuffer: 16 * 1024 * 1024 });
       if (result.status !== 0) fail(`unzip failed: ${(result.stderr || result.stdout || '').trim() || `exit ${result.status}`}`);
     } else {
-      if (!tools.tar) fail('tar is not installed on this device');
+      if (!tools.tar) fail(process.platform === 'win32' ? 'Windows archive backend is unavailable: tar.exe is required' : 'tar is not installed on this device');
       const listFlags = format === 'tar.gz' ? '-tzf' : format === 'tar.bz2' ? '-tjf' : format === 'tar.xz' ? '-tJf' : '-tf';
       const listing = spawnSync(tools.tar, [listFlags, archiveSnapshot], { encoding: 'utf8', timeout: 30_000, maxBuffer: 16 * 1024 * 1024 });
       if (listing.error || listing.status !== 0) fail(`Could not inspect archive: ${(listing.stderr || listing.error?.message || `exit ${listing.status}`).trim()}`);

package/src/util.mjs

@@ -136,10 +136,16 @@ function frameBytes(text) {
   return Buffer.byteLength(JSON.stringify(String(text)), 'utf8');
 }
 
+export function fitsOutput(text, maxBytes) {
+  const limit = maxBytes || liveConfig('maxOutputBytes');
+  const value = String(text);
+  return Buffer.byteLength(value, 'utf8') <= limit && frameBytes(value) <= limit;
+}
+
 export function truncate(text, maxBytes) {
   const limit = maxBytes || liveConfig('maxOutputBytes');
   const value = String(text);
-  if (Buffer.byteLength(value, 'utf8') <= limit && frameBytes(value) <= limit) return value;
+  if (fitsOutput(value, limit)) return value;
   // Shrink until the escaped frame fits, so the escaped size is what the caller gets is bounded.
   let size = Math.min(Buffer.byteLength(value, 'utf8'), limit);
   let rendered = '';