@termhub/agent 0.2.1 → 0.2.2

package/README.md

@@ -35,6 +35,13 @@ starts the agent at login/boot and restarts it on failure. `termhub-agent servic
 `termhub-agent service uninstall` manage it afterwards. On Linux, run
 `loginctl enable-linger $USER` once so the service keeps running after you log out.
 
+The service is deliberately kept apart from the tmux server that holds your terminals: on Linux
+the unit sets `KillMode=process`, so restarting or updating the agent signals only the agent
+itself and leaves tmux — and whatever is running inside it — alone, and the agent reattaches to
+the existing sessions when it comes back (macOS needs nothing: launchd does not follow tmux once
+it daemonises). A unit installed by an older agent is rewritten to the current template the first
+time the new agent starts.
+
 ## Other commands
 
 - `termhub-agent status` — shows the paired server, machine name and whether the agent can reach

package/dist/cli.js

@@ -1267,15 +1267,15 @@ function renderPlist({ label, node, script, logPath }) {
 </plist>
 `;
 }
-function plistPath() {
-  return path6.join(os4.homedir(), "Library", "LaunchAgents", `${LABEL}.plist`);
+function plistPath(home = os4.homedir()) {
+  return path6.join(home, "Library", "LaunchAgents", `${LABEL}.plist`);
 }
 function gui() {
   return `gui/${process.getuid ? process.getuid() : 0}`;
 }
 async function install2(opts, deps = {}) {
   const runFn = deps.run ?? run;
-  const file = plistPath();
+  const file = plistPath(deps.home);
   const plist = renderPlist({ label: LABEL, node: opts.node, script: opts.script, logPath: opts.logPath });
   fs4.mkdirSync(path6.dirname(file), { recursive: true });
   fs4.writeFileSync(file, plist, "utf8");
@@ -1287,7 +1287,7 @@ async function install2(opts, deps = {}) {
 }
 async function uninstall2(deps = {}) {
   const runFn = deps.run ?? run;
-  const file = plistPath();
+  const file = plistPath(deps.home);
   await runFn("launchctl", ["bootout", gui(), file]);
   try {
     fs4.unlinkSync(file);
@@ -1315,7 +1315,7 @@ import fs5 from "fs";
 import os5 from "os";
 import path7 from "path";
 var UNIT_NAME = "termhub-agent";
-function renderUnit({ node, script, logPath }) {
+function renderUnit({ node, script, logPath, pathEnv }) {
   const lines = [
     "[Unit]",
     "Description=termhub agent",
@@ -1323,10 +1323,11 @@ function renderUnit({ node, script, logPath }) {
     "",
     "[Service]",
     `ExecStart=${node} ${script} run`,
+    "KillMode=process",
     "Restart=on-failure",
     "RestartSec=2",
     "RestartPreventExitStatus=78",
-    `Environment=PATH=${agentEnv().PATH ?? ""}`
+    `Environment=PATH=${pathEnv ?? agentEnv().PATH ?? ""}`
   ];
   if (logPath) {
     lines.push(`StandardOutput=append:${logPath}`, `StandardError=append:${logPath}`);
@@ -1334,12 +1335,12 @@ function renderUnit({ node, script, logPath }) {
   lines.push("", "[Install]", "WantedBy=default.target", "");
   return lines.join("\n");
 }
-function unitPath() {
-  return path7.join(os5.homedir(), ".config", "systemd", "user", `${UNIT_NAME}.service`);
+function unitPath(home = os5.homedir()) {
+  return path7.join(home, ".config", "systemd", "user", `${UNIT_NAME}.service`);
 }
 async function install3(opts, deps = {}) {
   const runFn = deps.run ?? run;
-  const file = unitPath();
+  const file = unitPath(deps.home);
   const unit = renderUnit({ node: opts.node, script: opts.script, logPath: opts.logPath });
   fs5.mkdirSync(path7.dirname(file), { recursive: true });
   fs5.writeFileSync(file, unit, "utf8");
@@ -1349,11 +1350,31 @@ async function install3(opts, deps = {}) {
   if (enable.code !== 0) throw new Error(`systemctl enable --now failed (code ${enable.code}): ${enable.stderr.trim()}`);
   console.log("Para o agente continuar ap\xF3s o logout: loginctl enable-linger $USER");
 }
+function unitPathEnv(unit) {
+  return /^Environment=PATH=(.*)$/m.exec(unit)?.[1];
+}
+async function refreshUnit(opts, deps = {}) {
+  const file = unitPath(deps.home);
+  let current;
+  try {
+    current = fs5.readFileSync(file, "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") return false;
+    throw err;
+  }
+  const unit = renderUnit({ node: opts.node, script: opts.script, logPath: opts.logPath, pathEnv: unitPathEnv(current) });
+  if (unit === current) return false;
+  fs5.writeFileSync(file, unit, "utf8");
+  const runFn = deps.run ?? run;
+  const reload = await runFn("systemctl", ["--user", "daemon-reload"]);
+  if (reload.code !== 0) throw new Error(`systemctl daemon-reload failed (code ${reload.code}): ${reload.stderr.trim()}`);
+  return true;
+}
 async function uninstall3(deps = {}) {
   const runFn = deps.run ?? run;
   await runFn("systemctl", ["--user", "disable", "--now", UNIT_NAME]);
   try {
-    fs5.unlinkSync(unitPath());
+    fs5.unlinkSync(unitPath(deps.home));
   } catch (err) {
     if (err.code !== "ENOENT") throw err;
   }
@@ -1383,6 +1404,10 @@ async function install4() {
   if (platform === "darwin") await install2(opts);
   else await install3(opts);
 }
+async function refresh() {
+  if (process.platform !== "linux") return false;
+  return refreshUnit(serviceFileOptions());
+}
 async function uninstall4() {
   const platform = process.platform;
   assertSupported(platform);
@@ -1397,7 +1422,7 @@ async function status3() {
 }
 
 // src/version.ts
-var AGENT_VERSION = "0.2.1";
+var AGENT_VERSION = "0.2.2";
 
 // src/rpc/update.ts
 var PACKAGE = "@termhub/agent";
@@ -1766,6 +1791,11 @@ async function runCommand(log2) {
   if (!config) {
     return exitWithoutRestart("Nenhuma configura\xE7\xE3o. Rode: termhub-agent connect --url <url>");
   }
+  try {
+    if (await refresh()) log2("service definition refreshed");
+  } catch (err) {
+    log2("service definition could not be refreshed", { error: err instanceof Error ? err.message : String(err) });
+  }
   await runForegroundUntilSignal(config, log2);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termhub/agent",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Agente do termhub: conecta esta máquina ao servidor por WebSocket de saída (sem SSH) e expõe os terminais tmux no navegador.",
   "license": "MIT",
   "private": false,