remotelink 0.4.5 → 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 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.
+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. 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.
+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

@@ -7339,19 +7339,11 @@ 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) {
-        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."
-          );
-        }
+      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);
@@ -7374,6 +7366,27 @@ WantedBy=default.target
             "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")
@@ -7383,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(
@@ -7414,7 +7433,7 @@ var {
 } = createBackgroundController();
 
 // src/index.ts
-var VERSION = "0.4.5";
+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");
@@ -7539,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("Persistent agent runtime for your computers") + "\n\n");
+  process3.stdout.write(dim("Controlled remote access for AI") + "\n\n");
 }
 function argFlag(name) {
   return process3.argv.includes(name);
@@ -7787,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: [