remotelink 0.4.4 → 0.4.6

package/README.md

@@ -53,7 +53,7 @@ npx remotelink --help          Show help
 
 The package also exposes the aliases `remote-link` and `remote-arc`.
 
-In the 0.4.4 candidate, background recovery and Relay reconnect are separate.
+In 0.4.6, background recovery and Relay reconnect are separate. A normal npx remotelink@latest launch can safely hand off a known older background Agent to the current release without creating two executors.
 Recovery installs a user service (macOS/Linux) or a hidden login supervisor
 (Windows), which takes over when the executing Agent ends. Only one updated
 Agent owns execution; additional terminals follow its operation log and offer
@@ -62,7 +62,7 @@ execution lease. Turning recovery off preserves current execution. Explicit
 Stop background Agent also ends that Agent's work. Windows recovery needs the
 supervisor to remain running; killing it requires a local relaunch or login.
 Sleep/power loss still makes the device unavailable. All concurrent instances
-must be updated; pre-0.4.4 Agents do not participate in the execution lease.
+must be updated; pre-0.4.4 Agents do not participate in the execution lease. When the installed version is identified as an older release, 0.4.6 performs a controlled handoff even when that older Agent still owns the execution lease: it stops the known Remote Arc worker and supervisor, waits for the lease to release, preserves pairing and policy, installs the replacement bundle, and verifies that the replacement worker owns execution. Unknown processes still fail closed instead of being killed automatically. Unknown legacy processes still fail closed instead of being killed automatically.
 
 ## Native execution core
 

package/dist/index.js

@@ -6959,6 +6959,20 @@ import fs6 from "fs/promises";
 import { spawn as spawn4 } from "child_process";
 var LegacyBackgroundAgentError = class extends Error {
 };
+function parseReleaseVersion(value) {
+  if (!value) return null;
+  const match = value.trim().match(/^(\d+)\.(\d+)\.(\d+)$/);
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isOlderRelease(current, target) {
+  const a = parseReleaseVersion(current);
+  const b = parseReleaseVersion(target);
+  if (!a || !b) return false;
+  if (a[0] !== b[0]) return a[0] < b[0];
+  if (a[1] !== b[1]) return a[1] < b[1];
+  return a[2] < b[2];
+}
 function windowsSupervisorLaunchScript(node, bundle) {
   const quote = (value) => "'" + value.replaceAll("'", "''") + "'";
   return "Start-Process -FilePath " + quote(node) + " -ArgumentList " + quote('"' + bundle + '" --supervise') + " -WindowStyle Hidden | Out-Null";
@@ -7325,16 +7339,55 @@ WantedBy=default.target
   async function enableBackgroundAgent2(sourcePath, options2 = {}) {
     const preserveCurrent = options2.preserveCurrent ?? false;
     const before = await backgroundAgentStatus2();
+    let upgradeHandoff = false;
     if (before.workerPid && before.workerPid !== process.pid) {
-      let participates = await leaseActive(AGENT_DIR);
-      for (let attempt = 0; !participates && attempt < 6; attempt++) {
-        await wait(500);
-        participates = await leaseActive(AGENT_DIR);
-      }
-      if (!participates)
-        throw new LegacyBackgroundAgentError(
-          "An existing background Agent does not hold the execution lease. Stop the older Agent locally before upgrading; this launch will not create a competing executor."
-        );
+      const knownOlderRelease = before.enabled && isOlderRelease(before.version, options2.version);
+      if (knownOlderRelease) {
+        upgradeHandoff = true;
+        if (platform === "darwin") await disableMac(true);
+        else if (platform === "win32") await disableWindows(true);
+        else if (platform === "linux") await disableLinux(true);
+        else {
+          throw new LegacyBackgroundAgentError(
+            "The existing background Agent is older, but automatic handoff is not supported on this operating system."
+          );
+        }
+        let stopped = false;
+        for (let attempt = 0; attempt < 40; attempt++) {
+          const status2 = await backgroundAgentStatus2();
+          if (!status2.workerPid) {
+            stopped = true;
+            break;
+          }
+          await wait(250);
+        }
+        if (!stopped) {
+          throw new LegacyBackgroundAgentError(
+            "The older background Agent did not stop cleanly. Automatic upgrade was aborted before installing the new executor."
+          );
+        }
+        let leaseReleased = !await leaseActive(AGENT_DIR);
+        for (let attempt = 0; !leaseReleased && attempt < 60; attempt++) {
+          await wait(250);
+          leaseReleased = !await leaseActive(AGENT_DIR);
+        }
+        if (!leaseReleased) {
+          throw new LegacyBackgroundAgentError(
+            "The older background Agent stopped, but its execution lease did not release in time. Automatic upgrade was aborted before starting the replacement executor."
+          );
+        }
+      } else {
+        let participates = await leaseActive(AGENT_DIR);
+        for (let attempt = 0; !participates && attempt < 6; attempt++) {
+          await wait(500);
+          participates = await leaseActive(AGENT_DIR);
+        }
+        if (!participates) {
+          throw new LegacyBackgroundAgentError(
+            "An existing background Agent does not hold the execution lease and cannot be identified as a safe older release. Stop it locally before retrying; this launch will not create a competing executor."
+          );
+        }
+      }
     }
     if (platform === "darwin")
       await enableMac(sourcePath, preserveCurrent, options2.version);
@@ -7343,11 +7396,17 @@ WantedBy=default.target
     else if (platform === "linux")
       await enableLinux(sourcePath, preserveCurrent, options2.version);
     else return backgroundAgentStatus2();
-    for (let attempt = 0; attempt < 20; attempt++) {
+    const verifyAttempts = upgradeHandoff ? 80 : 20;
+    for (let attempt = 0; attempt < verifyAttempts; attempt++) {
       const status2 = await backgroundAgentStatus2();
-      if (status2.enabled && status2.active) return status2;
+      if (status2.enabled && status2.active) {
+        if (!upgradeHandoff) return status2;
+        const versionMatches = !options2.version || status2.version === options2.version;
+        const workerOwnsLease = Boolean(status2.workerPid) && await leaseActive(AGENT_DIR);
+        if (versionMatches && workerOwnsLease) return status2;
+      }
       if (!status2.supported) return status2;
-      await wait(200);
+      await wait(upgradeHandoff ? 250 : 200);
     }
     const status = await backgroundAgentStatus2();
     throw new Error(
@@ -7374,7 +7433,7 @@ var {
 } = createBackgroundController();
 
 // src/index.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.6";
 var DEFAULT_ORIGIN = "https://mcp.remotearc.app";
 var CONFIG_DIR = path7.join(os4.homedir(), ".remotearc");
 var CONFIG_PATH = path7.join(CONFIG_DIR, "config.json");
@@ -7499,7 +7558,7 @@ function logLine(level, message) {
 function banner() {
   process3.stdout.write("\n");
   process3.stdout.write(bold("Remote Arc") + "  " + dim(`v${VERSION}`) + "\n");
-  process3.stdout.write(dim("Secure remote MCP bridge") + "\n\n");
+  process3.stdout.write(dim("Controlled remote access for AI") + "\n\n");
 }
 function argFlag(name) {
   return process3.argv.includes(name);
@@ -7747,7 +7806,8 @@ async function connectAgent(config) {
               recoveryEnabled: recovery?.enabled ?? false,
               supervisorActive: recovery?.active,
               supervisorPid: recovery?.pid,
-              supervisorService: recovery?.service
+              supervisorService: recovery?.service,
+              recoveryVersion: recovery?.version ?? null
             },
             tools: [...tools.map((tool) => tool.name), ...internalTools],
             capabilities: [
@@ -8032,6 +8092,13 @@ async function main() {
     if (agentMode && config.backgroundEnabled !== true) return;
     if (!agentMode && !foregroundMode && config.backgroundEnabled === true) {
       try {
+        const existing = await backgroundAgentStatus().catch(() => null);
+        if (existing?.active && existing.version && existing.version !== VERSION) {
+          logLine(
+            "info",
+            `Background Agent v${existing.version} detected \xB7 checking safe handoff to v${VERSION}\u2026`
+          );
+        }
         const status = await enableBackgroundAgent(SELF_PATH, { version: VERSION });
         if (status.supported && status.enabled && status.active) {
           banner();