remotelink 0.4.7 → 0.4.8

package/README.md

@@ -23,6 +23,20 @@ On first run, `remotelink`:
 No public IP, VPN, router port forwarding, repository clone, or manual token
 copy is required.
 
+<!-- latest-release:start -->
+## Latest release
+
+**remotelink 0.4.8 — Device-local execution logs in Dashboard**
+
+Published 2026-10-08
+
+- Add a live Device execution log to Dashboard → Activity & details, read on demand from the paired computer's local Remote Arc operation log.
+- Show recent tool calls, completion/failure state, reconnect and recovery events without turning the hosted audit store into a file-content or stdout archive.
+- Keep logs local when a device is offline and surface a clear update requirement for older remotelink Agents that do not support on-demand log reads.
+
+See the [full Remote Arc release history](https://remotearc.app/releases) or the [GitHub changelog](https://github.com/yaohuangguan/remote-arc/blob/master/CHANGELOG.md).
+<!-- latest-release:end -->
+
 ## Connect your AI client
 
 Remote MCP endpoint:
@@ -53,7 +67,7 @@ npx remotelink --help          Show help
 
 The package also exposes the aliases `remote-link` and `remote-arc`.
 
-In 0.4.7, 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.
+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 +76,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.7 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. If a saved device pairing has been revoked from Dashboard, interactive startup now validates it before viewer/background attach, stops the known local background owner, clears the revoked credential and begins fresh pairing. Unknown 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, the current CLI 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. If a saved device pairing has been revoked from Dashboard, interactive startup now validates it before viewer/background attach, stops the known local background owner, clears the revoked credential and begins fresh pairing. Unknown processes still fail closed instead of being killed automatically.
 
 ## Native execution core
 

package/dist/index.js

@@ -6890,6 +6890,38 @@ async function readAgentEvents(directory, cursor) {
     await handle?.close();
   }
 }
+async function readAgentEventTail(directory, requestedLimit = 100) {
+  const limit = Math.max(20, Math.min(200, Math.trunc(requestedLimit || 100)));
+  const file = path5.join(directory, "events.log");
+  let handle;
+  try {
+    handle = await fs5.open(file, "r");
+    const stat = await handle.stat();
+    const start = Math.max(0, stat.size - 128 * 1024);
+    const buffer = Buffer.alloc(Math.min(stat.size - start, 128 * 1024));
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, start);
+    let lines = buffer.subarray(0, bytesRead).toString("utf8").split("\n");
+    if (start > 0) lines = lines.slice(1);
+    lines = lines.map((line) => line.trimEnd()).filter(Boolean);
+    return {
+      source: "local-device",
+      lines: lines.slice(-limit),
+      total_bytes: stat.size,
+      truncated: start > 0 || lines.length > limit,
+      updated_at: stat.mtime.toISOString()
+    };
+  } catch {
+    return {
+      source: "local-device",
+      lines: [],
+      total_bytes: 0,
+      truncated: false,
+      updated_at: null
+    };
+  } finally {
+    await handle?.close();
+  }
+}
 async function superviseAgent(options) {
   let delay = options.delayMs ?? 1e3;
   while (!options.signal.aborted && await options.enabled()) {
@@ -7433,7 +7465,7 @@ var {
 } = createBackgroundController();
 
 // src/index.ts
-var VERSION = "0.4.7";
+var VERSION = "0.4.8";
 var DEFAULT_ORIGIN = "https://mcp.remotearc.app";
 var CONFIG_DIR = path7.join(os4.homedir(), ".remotearc");
 var CONFIG_PATH = path7.join(CONFIG_DIR, "config.json");
@@ -7698,7 +7730,7 @@ async function connectAgent(config) {
     `Permission profile: ${isLocalSafeMode(config.mode) ? green("safe local cap") : cyan("dashboard-managed")}`
   );
   const tools = await core.tools();
-  const internalTools = ["background_agent_status", "set_background_agent", "set_task_keep_awake", "goal_workspace"];
+  const internalTools = ["background_agent_status", "set_background_agent", "set_task_keep_awake", "goal_workspace", "agent_execution_log"];
   let keepAwake = createTaskKeepAwakeManager();
   logLine("success", `Local tools ready: ${tools.length} exposed`);
   process3.stdout.write("       " + dim(tools.map((tool) => tool.name).join(" \xB7 ")) + "\n");
@@ -7900,6 +7932,11 @@ async function connectAgent(config) {
                 enabled: status.enabled,
                 desired_enabled: config.backgroundEnabled ?? null
               };
+            } else if (message.tool === "agent_execution_log") {
+              result = await readAgentEventTail(
+                path7.join(CONFIG_DIR, "logs"),
+                Number(message.arguments?.limit || 100)
+              );
             } else if (message.tool === "set_background_agent") {
               const enabled = message.arguments?.enabled;
               if (typeof enabled !== "boolean") {