remotelink 0.4.4 → 0.4.5

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.5, 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.5 stops that legacy background process, preserves pairing and policy, installs the replacement bundle, and verifies the replacement service. 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";
@@ -7331,10 +7345,36 @@ WantedBy=default.target
         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."
-        );
+      if (!participates) {
+        const canUpgradeLegacy = isOlderRelease(before.version, options2.version) && before.enabled;
+        if (!canUpgradeLegacy) {
+          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 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."
+          );
+        }
+      }
     }
     if (platform === "darwin")
       await enableMac(sourcePath, preserveCurrent, options2.version);
@@ -7374,7 +7414,7 @@ var {
 } = createBackgroundController();
 
 // src/index.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.5";
 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 +7539,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("Persistent agent runtime for your computers") + "\n\n");
 }
 function argFlag(name) {
   return process3.argv.includes(name);
@@ -8032,6 +8072,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();