@andrian.yablonskyy/thub-agent 1.1.13 → 1.1.15

package/README.md

@@ -1,8 +1,18 @@
 # @andrian.yablonskyy/thub-agent
 
-The Agent CLI (`thub`) is a self-hosted job network that lets CI/CD pipelines and individual developers run firmware tests on real hardware or emulators in a private lab. `thub` is the single entry point for both: it's stateless, everything it knows comes from the [Coordinator](https://github.com/andrianyablonskyy/thub-coordinator) API, and it runs identically on a GitHub-hosted runner and a developer laptop — a developer reproducing a CI failure runs exactly the same command the pipeline runs.
+The Agent CLI (`thub`) is a self-hosted job network that lets CI/CD pipelines and individual developers run firmware tests on real hardware or emulators in a private lab. `thub` is the single entry point for both: it's stateless, everything it knows comes from the [Coordinator](https://github.com/users/andrianyablonskyy/packages/container/package/thub-coordinator) API, and it runs identically on a GitHub-hosted runner and a developer laptop — a developer reproducing a CI failure runs exactly the same command the pipeline runs.
 
-See how this fits with the [Coordinator](https://github.com/andrianyablonskyy/thub-coordinator) and the [Client](https://github.com/andrianyablonskyy/thub-client).
+See how this fits with the [Coordinator](https://github.com/users/andrianyablonskyy/packages/container/package/thub-coordinator) and the [Client](https://github.com/andrianyablonskyy/thub-client). The Coordinator runs from its Docker image, `ghcr.io/andrianyablonskyy/thub-coordinator`:
+
+```bash
+docker run -d --name thub -p 8080:8080 -v thub-data:/var/lib/thub \
+  -e THUB_PUBLIC_URL=https://thub.example.com \
+  -e THUB_SESSION_SECRET="$(openssl rand -hex 32)" -e THUB_CLIENT_JOIN_KEY="$(openssl rand -hex 24)" \
+  -e THUB_ADMIN_PASSWORD='<first admin password>' -e THUB_LICENSE='<license>' \
+  ghcr.io/andrianyablonskyy/thub-coordinator:latest
+```
+
+Then create a CI token or an access key on its dashboard for `thub`.
 
 ## Install
 
@@ -14,7 +24,7 @@ npx -y @andrian.yablonskyy/thub-agent run --type sw --download-file "$IMAGE_URL"
 
 ## Configuration
 
-Read from flags (`--url`, `--key`), then environment (`THUB_URL`, `THUB_KEY`; the old names `--token`/`THUB_TOKEN` still work), then `~/.config/thub/agent.json`, then a bundled default. `url`/`token` are required by the time a command actually talks to the Coordinator; `group`/`user` are optional everywhere.
+Read from flags (`--url`, `--key`), then environment (`THUB_URL`, `THUB_KEY`), then `~/.config/thub/agent.json`, then a bundled default. `url`/`key` are required by the time a command actually talks to the Coordinator; `group`/`user` are optional everywhere.
 
 `npm install -g` creates `~/.config/thub/agent.json` for you (blank `url`/`token`, so nothing works until you set them) if it doesn't already exist — a re-install never overwrites it. Fill it in with `thub config set`:
 

package/RELEASE.md

@@ -2,6 +2,13 @@
 
 What changed in each release, newest first. `## Unreleased` collects the changes since the version on npm; `bin/publish` turns that heading into the version and date it releases.
 
+## 1.1.14 — 2026-10-09
+
+### Removed
+
+- **`--token`, `THUB_TOKEN` and the config file's `token`.** Use `--key`, `THUB_KEY` and `key`; `thub config set` accepts `url` and `key` only.
+- The unused `PLATFORMS` export of `report.js`.
+
 ## 1.1.13 — 2026-10-09
 
 Changes since 1.1.12.

package/eslint.config.js

@@ -29,6 +29,9 @@ module.exports = [
     },
     rules: {
       // Core JS
+      // Dead code: unused variables, imports and functions. Unused trailing
+      // arguments are fine when named _x (an Express error handler's next).
+      'no-unused-vars': ['error', { args: 'after-used', argsIgnorePattern: '^_', caughtErrors: 'none', ignoreRestSiblings: true }],
       'prefer-const': 'error',
       strict: ['error', 'global'],
       camelcase: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrian.yablonskyy/thub-agent",
-  "version": "1.1.13",
+  "version": "1.1.15",
   "description": "TestHub Agent CLI — the single entry point CI/CD and developers use to submit and follow test jobs",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Andrian Yablonskyy <andrian.yablonskyy@gmail.com>",
@@ -15,7 +15,7 @@
     "lint:fix": "eslint . --fix"
   },
   "dependencies": {
-    "@andrian.yablonskyy/thub-common": "^1.1.12",
+    "@andrian.yablonskyy/thub-common": "^2.0.1",
     "commander": "^13.1.0"
   },
   "devDependencies": {

package/src/cli.js

@@ -15,7 +15,7 @@
 
 'use strict';
 
-const { Command, Option } = require('commander'),
+const { Command } = require('commander'),
   {
     ApiClient, EXIT_CODES, ACTIVE_JOB_STATES, exitCodeForJobState, PACKAGES, fetchLatestVersion, isNewer, isValidVersion, formatDateTime,
     parseEnvList, POWER_ACTIONS, DEFAULT_RESET_DELAY_SEC, MAX_RESET_DELAY_SEC, powerRequestErrors
@@ -33,7 +33,6 @@ program
   .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('--key <key>', 'Your access key (overrides THUB_KEY / config file)')
-  .addOption(new Option('--token <token>', 'Old name of --key').hideHelp())
   .version(version);
 
 // An admin-requested self-update (README §10.2) is applied at the start of
@@ -436,19 +435,12 @@ config
   .argument('<name>', 'url | key')
   .argument('<value>')
   .action((name, value) => {
-    // `token` is the old name of `key`.
-    const setting = name === 'token' ? 'key' : name;
-    if (!['url', 'key'].includes(setting)){
-      console.error(setting === 'group'
-        ? 'Error: a job\'s group is set on the dashboard now (Users / CI tokens), not in the Agent'
-        : setting === 'user'
-          ? 'Error: a job\'s user comes from your access key now (thub whoami shows it), not from the Agent'
-          : 'Error: the setting must be "url" or "key"');
+    if (!['url', 'key'].includes(name)){
+      console.error('Error: the setting must be "url" or "key"');
       process.exit(EXIT_CODES.USAGE);
     }
-    const { token: _old, ...current } = readConfigFile();
-    writeConfigFile({ ...(setting === 'key' ? current : { ...current, ...(_old ? { token: _old } : {}) }), [setting]: value });
-    console.log(`Saved ${setting} to config`);
+    writeConfigFile({ ...readConfigFile(), [name]: value });
+    console.log(`Saved ${name} to config`);
   });
 
 // Who this access key belongs to (§10.3).
@@ -498,8 +490,7 @@ keyCommand
       const { keySource } = resolveConnection(program.opts()),
         { key, username } = await client().post('/me/key/rotate');
       if (keySource === 'file'){
-        const { token: _old, ...current } = readConfigFile();
-        writeConfigFile({ ...current, key });
+        writeConfigFile({ ...readConfigFile(), key });
         console.log(`New access key for ${username} saved to ${CONFIG_PATH} — the old one has stopped working.`);
       }
       else {

package/src/config.js

@@ -1,6 +1,6 @@
 /**
  * @file        packages/agent/src/config.js
- * @description Agent config resolution: flags > env > config file > bundled default (url/token/user)
+ * @description Agent config resolution: flags > env > config file > bundled default (url and access key)
  *
  * @author      Andrian Yablonskyy
  * @copyright   Copyright (c) 2026 Andrian Yablonskyy. All rights reserved.
@@ -18,8 +18,7 @@ const fs = require('node:fs'),
   path = require('node:path');
 
 // §7: "Configuration is read from flags, then environment (THUB_URL,
-// THUB_KEY), then ~/.config/thub/agent.json." The access key (§10.3) used to
-// be called a token: --token, THUB_TOKEN and a saved `token` still work.
+// THUB_KEY), then ~/.config/thub/agent.json."
 const CONFIG_PATH = path.join(os.homedir(), '.config', 'thub', 'agent.json'),
 
   // Bundled with the package as a last-resort default, below the user's own
@@ -51,9 +50,9 @@ function writeConfigFile(config){
 function resolveConnection(flags = {}){
   const file = { ...readJsonFile(PACKAGE_DEFAULT_CONFIG_PATH), ...readConfigFile() },
     url = flags.url || process.env.THUB_URL || file.url,
-    [token, keySource] = flags.key || flags.token ? [flags.key || flags.token, 'flag']
-      : process.env.THUB_KEY || process.env.THUB_TOKEN ? [process.env.THUB_KEY || process.env.THUB_TOKEN, process.env.THUB_KEY ? 'THUB_KEY' : 'THUB_TOKEN']
-        : file.key || file.token ? [file.key || file.token, 'file'] : [null, null];
+    [token, keySource] = flags.key ? [flags.key, 'flag']
+      : process.env.THUB_KEY ? [process.env.THUB_KEY, 'THUB_KEY']
+        : file.key ? [file.key, 'file'] : [null, null];
   if (!url || !token){
     const err = new Error(
       'Missing Coordinator URL or access key. Set them with `thub config set url <url>` and `thub config set key <key>`, ' +

package/src/report.js

@@ -303,4 +303,4 @@ async function report(api, baseUrl, jobId, opts, { env = process.env, out = cons
   return result;
 }
 
-module.exports = { report, PLATFORMS };
+module.exports = { report };