@andrian.yablonskyy/thub-agent 1.1.22 → 1.1.24

package/RELEASE.md

@@ -2,8 +2,56 @@
 
 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.24 — 2026-10-16
+
+### Added
+
+- **`thub connect --json` streams NDJSON events** for tools such as the VS Code extension. The first line is `{"event": "ready", …}`: the same object as before, with `event` added, so existing readers still work. Then there's one line per change:
+  - `status` (`waiting` / `ready`, with the reservation's end);
+  - `disconnected` (retry delay, reason) and `connected` (`again`);
+  - `video` (the camera streams, or why not);
+  - `fatal` (e.g. *The reservation ended*), just before it exits.
+
+  The human messages still go to stderr.
+- **`thub whoami --json`**: whose key it is (`kind`, `user` or `name`, `group`), as the Agent API's `/me` returns it.
+
+## 1.1.23 — 2026-10-15
+
+### Changed
+
+- Requires thub-common 2.2.4.
+
+## 1.1.22 — 2026-10-15
+
+### Changed
+
+- **`thub connect` shows the camera's state.** The Video line says whether the board's camera is streaming, and if not, why, for example `(not streaming — ffmpeg isn't installed on this Client host …)`. Each change is printed as it happens (`Video: streaming`, `Video: not streaming — …`), with no viewer needed. Needs Client 1.1.26.
+
+## 1.1.21 — 2026-10-15
+
+### Fixed
+
+- **`thub connect` and `thub console` behind a proxy without WebSocket support** stop with the reason instead of retrying forever: *The Coordinator answered HTTP 302 → /login instead of opening a WebSocket: a reverse proxy in front of the Coordinator isn't passing WebSocket upgrades …* The same goes for `426` (Coordinator 1.1.41). Other refusals (`401`, `403`, `404`, `409`) were already final.
+
 ## 1.1.20 — 2026-10-15
 
+### Added
+
+- **`thub reserve <client> [--for <dur>]`** holds a runner for your own jobs (README §5.5).
+  - **Duration:** whole minutes (`30m`, `2h`; 1 h by default), up to the runner's maximum. Running it again extends the reservation from now.
+  - **Output:** the end time, how to use the runner, and the reservation's own remote access link.
+  - **Release:** **`thub release <client>`** ends it; maintainers and admins can end anyone's.
+- **`thub resources`** has a RESERVED column (who, until when). With `--json`, each runner has its `reservation`, and for your own reservation its `id` and `link`.
+- **`thub connect <client>`** keeps a live connection to your reserved board (README §5.6) and prints that reservation's link and a local port per device:
+  - **UARTs:** `127.0.0.1:5001` and up (`--uart-port`), for socat, picocom or pyserial's `socket://`.
+  - **ST-Links:** a GDB port each, `127.0.0.1:3333` and up (`--gdb-port`). Each connection starts its own OpenOCD on the Client; `--target <name>` gives the OpenOCD target.
+  - **Camera:** if the board has one (README §5.7), `http://127.0.0.1:8090/<reservation id>/video.ts` (`--video-port`) for VLC, ffplay or mpv. The URL is that reservation's own. `--video-udp <port>` also sends it as UDP.
+  - **Reconnecting:** it reconnects by itself (1 s, 2 s … 30 s). Serial terminals and video viewers stay connected through a reconnect; GDB has to connect again.
+  - **Exiting:** it exits with the reason when the reservation ends.
+  - **Options:** `--bind` and `--json`.
+- **`thub console <client> [--uart <n>]`** puts one UART of your reserved board in the terminal. Ctrl-] quits.
+- New dependency: `ws` 8.21.3.
+
 ### Changed
 
 - Requires thub-common 2.2.3.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrian.yablonskyy/thub-agent",
-  "version": "1.1.22",
+  "version": "1.1.24",
   "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": "^2.2.3",
+    "@andrian.yablonskyy/thub-common": "^2.2.4",
     "commander": "^13.1.0",
     "ws": "8.21.3"
   },

package/src/cli.js

@@ -487,7 +487,7 @@ program
   .option('--bind <address>', 'Local address to listen on (another than loopback shares the board with your network)', '127.0.0.1')
   .option('--video-port <port>', 'Local HTTP port of the board\'s USB camera stream, if it has one', (v) => Number(v), 8090)
   .option('--video-udp <port>', 'Also send the camera stream as UDP (MPEG-TS) to this local port, e.g. 5600', (v) => Number(v))
-  .option('--json', 'Print the ports as JSON once connected', false)
+  .option('--json', 'NDJSON on stdout: "ready" with the ports once connected, then status/disconnected/connected/video/fatal events', false)
   .action(async (name, opts) => {
     try {
       if (opts.target !== undefined && !OPENOCD_TARGET_RE.test(opts.target)){
@@ -500,7 +500,16 @@ program
         }
       }
       const session = await remoteSession(name),
-        log = (m) => console.error(m);
+        log = (m) => console.error(m),
+        // --json: NDJSON on stdout — `ready` (the ports, below), then one line
+        // per change, for tools such as the VS Code extension. The human
+        // messages still go to stderr.
+        emit = opts.json ? (e) => console.log(JSON.stringify(e)) : () => {};
+      session.on('status', (st) => emit({ event: 'status', state: st.state, client: st.client, until: st.until }));
+      session.on('disconnected', ({ retryMs, reason }) => emit({ event: 'disconnected', retryMs, reason: reason || null }));
+      session.on('connected', ({ again }) => emit({ event: 'connected', again }));
+      session.on('fatal', (message) => emit({ event: 'fatal', message }));
+      session.on('devices', (d) => d.camera && emit({ event: 'video', streaming: Boolean(d.camera.streaming), error: d.camera.error || null }));
       let listening = null,
         until = null;
       const cleanup = () => {
@@ -564,7 +573,7 @@ program
 function printConnection(name, link, until, ports, devices, opts, video){
   if (opts.json){
     return console.log(JSON.stringify({
-      client: name, link, until, ports: ports.map((p) => ({ kind: p.kind, ...p.device, host: opts.bind, port: p.port })),
+      event: 'ready', client: name, link, until, ports: ports.map((p) => ({ kind: p.kind, ...p.device, host: opts.bind, port: p.port })),
       video: video ? { camera: devices.camera.name, url: video.url, udp: video.udp } : null
     }));
   }
@@ -730,9 +739,11 @@ function describeMe(me){
 program
   .command('whoami')
   .description('Show whose access key this Agent uses')
-  .action(async () => {
+  .option('--json', 'Machine-readable output', false)
+  .action(async (opts) => {
     try {
-      console.log(describeMe(await client().get('/me')));
+      const me = await client().get('/me');
+      console.log(opts.json ? JSON.stringify(me) : describeMe(me));
     }
     catch (err){
       fail(err);