@andrian.yablonskyy/thub-agent 1.0.7 → 1.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrian.yablonskyy/thub-agent",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "TestHub Agent CLI — the single entry point CI/CD and developers use to submit and follow test jobs",
   "bin": {
     "thub": "./src/cli.js"

package/src/cli.js

@@ -16,21 +16,41 @@
 'use strict';
 
 const { Command } = require('commander'),
-  { ApiClient, EXIT_CODES, ACTIVE_JOB_STATES, exitCodeForJobState } = require('@andrian.yablonskyy/thub-common'),
+  { ApiClient, EXIT_CODES, ACTIVE_JOB_STATES, exitCodeForJobState, PACKAGES, fetchLatestVersion, isNewer, isValidVersion } =
+    require('@andrian.yablonskyy/thub-common'),
   { resolveConnection, resolveGroup, resolveUser, writeConfigFile, readConfigFile } = require('./config'),
   { parseDurationSec } = require('./duration'),
-  { followJob } = require('./streaming');
+  { followJob } = require('./streaming'),
+  { applyRequestedUpdate, installAgent, version } = require('./self-update');
 
 const program = new Command();
 program
   .name('thub')
   .description('TestHub Agent — submit test jobs and follow them, from CI or your laptop')
   .option('--url <url>', 'Coordinator URL (overrides THUB_URL / config file)')
-  .option('--token <token>', 'Agent token (overrides THUB_TOKEN / config file)');
+  .option('--token <token>', 'Agent token (overrides THUB_TOKEN / config file)')
+  .version(version);
+
+// An admin-requested self-update (README §10.2) is applied at the start of
+// the next run of any command that talks to the Coordinator.
+const NO_UPDATE_CHECK = new Set(['config', 'set', 'check-update', 'self-update']);
+program.hook('preAction', async (thisCommand, actionCommand) => {
+  if (NO_UPDATE_CHECK.has(actionCommand.name())){
+    return;
+  }
+  let api;
+  try {
+    api = client();
+  }
+  catch {
+    return; // not configured — the command itself reports that
+  }
+  await applyRequestedUpdate(api);
+});
 
 function client(){
   const { url, token } = resolveConnection(program.opts());
-  return new ApiClient({ baseUrl: url, token });
+  return new ApiClient({ baseUrl: url, token, userAgent: `thub-agent/${version}` });
 }
 
 function fail(err){
@@ -231,6 +251,42 @@ config
     console.log(`Saved ${key} to config`);
   });
 
+program
+  .command('check-update')
+  .description('Compare this Agent with the latest published version')
+  .action(async () => {
+    try {
+      const latest = await fetchLatestVersion(PACKAGES.agent);
+      console.log(`Installed: v${version}  Latest: v${latest}`);
+      console.log(isNewer(latest, version) ? 'Update available: thub self-update' : 'Up to date.');
+    }
+    catch (err){
+      fail(err);
+    }
+  });
+
+program
+  .command('self-update')
+  .description('Update this Agent to the latest (or a given) version with npm i -g')
+  .option('--to <x.y.z>', 'Install this version instead of the latest')
+  .action(async (opts) => {
+    try {
+      const target = opts.to || await fetchLatestVersion(PACKAGES.agent);
+      if (!isValidVersion(target)){
+        throw new Error(`Invalid version "${target}"`);
+      }
+      if (!opts.to && !isNewer(target, version)){
+        console.log(`Already on v${version}.`);
+        return;
+      }
+      console.log(`Updating v${version} -> v${target}`);
+      process.exit(installAgent(target) ? 0 : 1);
+    }
+    catch (err){
+      fail(err);
+    }
+  });
+
 function collectRepeatable(value, previous){
   return [...previous, value];
 }

package/src/self-update.js

@@ -0,0 +1,77 @@
+/**
+ * @file        packages/agent/src/self-update.js
+ * @description Agent self-update: an admin-requested update applied at the start of the next run, plus the
+ *              manual `thub check-update` / `thub self-update` commands (README §10.2)
+ *
+ * @author      Andrian Yablonskyy
+ * @copyright   Copyright (c) 2026 Andrian Yablonskyy. All rights reserved.
+ *
+ * This file is part of TestHub and is proprietary and confidential.
+ * Unauthorized copying, modification, distribution, or use of this file,
+ * via any medium, is strictly prohibited without prior written permission
+ * from AdSystem.PRO.
+ */
+
+'use strict';
+
+const { spawnSync } = require('node:child_process'),
+  { PACKAGES, isNewer, npmBin, npmInstallGlobal } = require('@andrian.yablonskyy/thub-common'),
+  { version } = require('../package.json');
+
+// npm's output goes to stderr so a command's own stdout (e.g. JSON a CI
+// script parses) stays clean.
+const NPM_STDIO = ['inherit', 2, 2],
+  CHECK_TIMEOUT_MS = 5000;
+
+// Tries a plain `npm i -g` first (nvm, a user-owned prefix, or root in
+// CI); if that fails on an interactive terminal, retries through sudo
+// for a system-wide install. Never throws — returns whether it worked.
+function installAgent(target){
+  try {
+    if (npmInstallGlobal(PACKAGES.agent, target, { stdio: NPM_STDIO }) === 0){
+      return true;
+    }
+    if (process.getuid?.() !== 0 && process.stdin.isTTY){
+      console.error('thub: retrying with sudo');
+      return spawnSync('sudo', [npmBin(), 'i', '-g', `${PACKAGES.agent}@${target}`], { stdio: NPM_STDIO }).status === 0;
+    }
+  }
+  catch (err){
+    console.error(`thub: self-update failed: ${err.message}`);
+  }
+  return false;
+}
+
+// Runs before every command that talks to the Coordinator. If an admin
+// requested an update (Agents page) and it's newer than this Agent,
+// installs it and re-runs the same command line on the new version. Any
+// failure — Coordinator unreachable, no permission to install — just
+// falls through to running the command on the current version.
+async function applyRequestedUpdate(api){
+  if (process.env.THUB_NO_SELF_UPDATE || process.env.THUB_SELF_UPDATED){
+    return;
+  }
+  let updateTo;
+  try {
+    ({ updateTo } = await api.get('/agents/me/update', { signal: AbortSignal.timeout(CHECK_TIMEOUT_MS) }));
+  }
+  catch {
+    return; // older Coordinator, or unreachable — the command reports that itself
+  }
+  if (!isNewer(updateTo, version)){
+    return;
+  }
+
+  console.error(`thub: updating v${version} -> v${updateTo} (requested by the Coordinator)`);
+  if (!installAgent(updateTo)){
+    console.error(`thub: update failed — continuing on v${version}. To update by hand: sudo npm i -g ${PACKAGES.agent}@${updateTo}`);
+    return;
+  }
+  const rerun = spawnSync(process.execPath, process.argv.slice(1), {
+    stdio: 'inherit',
+    env: { ...process.env, THUB_SELF_UPDATED: '1' }
+  });
+  process.exit(rerun.status ?? 1);
+}
+
+module.exports = { applyRequestedUpdate, installAgent, version };