charness 3.6.1 → 3.8.0

package/dist/remoteRun/runnerWait.d.ts

@@ -0,0 +1,68 @@
+import { type InterruptSignal } from './exitCodes';
+import { type RunnerCapability, type RunnerReport } from './probe';
+import type { RunnerPick } from './runners';
+import type { RunnersConfig } from './runnersConfig';
+/** @name RunnerWaitPlan @description What a failed pick is worth waiting for. */
+export interface RunnerWaitPlan {
+    /** The offline paired runners that, when they were last seen, could do the job. */
+    runnerNames: string[];
+    /** «mac offline since 2026-11-01 14:02 UTC», for the line that says the command is waiting. */
+    description: string;
+}
+/**
+ * @description Is there an offline PAIRED runner worth waiting for? Only when a capability is needed and no runner is named: a runner is
+ * worth it when its last snapshot had the capability and Pueue and nobody paused it (a paused one would be skipped when it came back).
+ * `null` = fail now.
+ */
+export declare function planRunnerWait(config: RunnersConfig, reports: readonly RunnerReport[], wanted: {
+    runner: string | null;
+    needs: RunnerCapability | null;
+}): RunnerWaitPlan | null;
+/** @description `15 min`, `90 s`, `2 h`, `1 h 30 min`: a wait in the words a person would use. */
+export declare function formatWaitDuration(totalSeconds: number): string;
+/** The least an attempt made DURING the wait is worth: a probe through ssh cannot answer in less, so with less left the wait is over. */
+export declare const minWaitAttemptMs = 1000;
+/** One try at choosing a runner: the choice, or why there is none and whether it is worth waiting. */
+export type RunnerAttempt<TChoice> = {
+    ok: true;
+    choice: TChoice;
+} | {
+    ok: false;
+    failure: Extract<RunnerPick, {
+        ok: false;
+    }>;
+    wait: RunnerWaitPlan | null;
+};
+export interface RunnerWaitLoop<TChoice> {
+    /**
+     * Probe and pick once. `budgetMs` is what is left of the wait once it has begun (the probe must end within it), `null` for the first attempt.
+     * `stop` aborts when the user interrupts: the attempt ends what it started (its ssh calls) at once, and whatever it returns after that is not used.
+     */
+    attempt: (budgetMs: number | null, stop: AbortSignal) => Promise<RunnerAttempt<TChoice>>;
+    needs: RunnerCapability | null;
+    /** `--runner-wait` in seconds; `0` = never wait. */
+    waitSeconds: number;
+    pollMs: number;
+    now: () => number;
+    /** Resolves after `ms`, or at once when `stop` aborts. */
+    sleep: (ms: number, stop: AbortSignal) => Promise<void>;
+    /** Calls `onInterrupt` with the signal when the user interrupts (Ctrl-C, SIGTERM, SIGHUP), until the returned function is called. */
+    watchInterrupts: (onInterrupt: (signal: InterruptSignal) => void) => () => void;
+    say: (line: string) => void;
+}
+/**
+ * @description Choose a runner, waiting for an offline paired one when that is worth it: the choice as soon as an attempt gives one IN TIME;
+ * a {@link RemoteRunError} with the pick's own message (and, after waiting, how long it waited) when nothing can be waited for or the wait
+ * ran out; and, if the user interrupts, the interrupt's exit code (130 / 143 / 129).
+ *
+ * An interrupt is heard from the first attempt to the last, in a sleep AND in a probe: it aborts what is in flight, and after every await the
+ * loop looks at it first — a runner an attempt picked after the interrupt is not taken, and no other attempt starts.
+ *
+ * `--runner-wait` is a promise about when the command stops waiting, so once the wait has begun no attempt starts with less than
+ * {@link minWaitAttemptMs} left, every attempt is told the time it has (its probe is cut at it), and an answer that comes after the
+ * deadline is refused — the job is not started late. The last sleep is cut so that one more look still fits before the deadline.
+ */
+export declare function chooseRunnerWithWait<TChoice>(loop: RunnerWaitLoop<TChoice>): Promise<TChoice>;
+/** @description `sleep` for {@link chooseRunnerWithWait}: ends after `ms`, or at once when `stop` aborts; its timer never outlives the call. */
+export declare function sleepUntilStopped(ms: number, stop: AbortSignal): Promise<void>;
+//# sourceMappingURL=runnerWait.d.ts.map

package/dist/remoteRun/runnerWait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerWait.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runnerWait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAA2D,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAcrD,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,GAAG,cAAc,GAAG,IAAI,CAahL;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAOD,yIAAyI;AACzI,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,sGAAsG;AACtG,MAAM,MAAM,aAAa,CAAC,OAAO,IAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;QAAE,EAAE,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAAC;AAE5F,MAAM,WAAW,cAAc,CAAC,OAAO;IACrC;;;OAGG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACzF,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,qIAAqI;IACrI,eAAe,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAChF,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA2CnG;AAED,gJAAgJ;AAChJ,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9E"}

package/dist/remoteRun/runnerWait.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minWaitAttemptMs = void 0;
+exports.planRunnerWait = planRunnerWait;
+exports.formatWaitDuration = formatWaitDuration;
+exports.chooseRunnerWithWait = chooseRunnerWithWait;
+exports.sleepUntilStopped = sleepUntilStopped;
+const exitCodes_1 = require("./exitCodes");
+const probe_1 = require("./probe");
+const remoteRunError_1 = require("./remoteRunError");
+/**
+ * @description The wait of `charness remote-run --needs <capability>`: when the only runners that could take the job are PAIRED ones
+ * that are offline right now (a laptop that slept, a link that restarts), the command waits for one of them instead of failing — it says
+ * so once, looks again every few seconds and gives up after `--runner-wait` (default 15 min, `0` = fail at once). A runner nothing is known
+ * to be able to do the job (no runner with the capability at all, or one never seen) is not waited for: that is exit 125 at once, as in
+ * phase 1. Hand-made runners (plain ssh) are never waited for either — their offline state is not part of a design.
+ */
+const msPerSecond = 1000;
+const secondsPerMinute = 60;
+const secondsPerHour = 3600;
+/**
+ * @description Is there an offline PAIRED runner worth waiting for? Only when a capability is needed and no runner is named: a runner is
+ * worth it when its last snapshot had the capability and Pueue and nobody paused it (a paused one would be skipped when it came back).
+ * `null` = fail now.
+ */
+function planRunnerWait(config, reports, wanted) {
+    const needs = wanted.needs;
+    if (needs === null || wanted.runner !== null)
+        return null;
+    const candidates = reports.filter((report) => {
+        if (report.status !== 'offline' || report.lastProbe === null)
+            return false;
+        const isPaired = config.runners.some((runner) => runner.name === report.name && runner.paired !== undefined);
+        return isPaired && !(0, probe_1.checkIsRunnerPaused)(report) && report.lastProbe.pueueVersion !== null && (0, probe_1.checkHasCapability)(report.lastProbe, needs);
+    });
+    if (candidates.length === 0)
+        return null;
+    return {
+        runnerNames: candidates.map((report) => report.name),
+        description: candidates.map((report) => `${report.name} offline${report.lastSeenAtMs === null ? '' : ` since ${(0, probe_1.formatLastSeen)(report.lastSeenAtMs)}`}`).join(', '),
+    };
+}
+/** @description `15 min`, `90 s`, `2 h`, `1 h 30 min`: a wait in the words a person would use. */
+function formatWaitDuration(totalSeconds) {
+    if (totalSeconds < secondsPerMinute)
+        return `${totalSeconds} s`;
+    const hours = Math.floor(totalSeconds / secondsPerHour);
+    const minutes = Math.floor((totalSeconds % secondsPerHour) / secondsPerMinute);
+    const seconds = totalSeconds % secondsPerMinute;
+    const parts = [...(hours > 0 ? [`${hours} h`] : []), ...(minutes > 0 ? [`${minutes} min`] : []), ...(hours === 0 && seconds > 0 ? [`${seconds} s`] : [])];
+    return parts.join(' ');
+}
+/** The poll as a person reads it: «10 s», or «500 ms» for the test window's sub-second polls. */
+function formatPoll(pollMs) {
+    return pollMs < msPerSecond ? `${pollMs} ms` : formatWaitDuration(Math.round(pollMs / msPerSecond));
+}
+/** The least an attempt made DURING the wait is worth: a probe through ssh cannot answer in less, so with less left the wait is over. */
+exports.minWaitAttemptMs = 1000;
+/**
+ * @description Choose a runner, waiting for an offline paired one when that is worth it: the choice as soon as an attempt gives one IN TIME;
+ * a {@link RemoteRunError} with the pick's own message (and, after waiting, how long it waited) when nothing can be waited for or the wait
+ * ran out; and, if the user interrupts, the interrupt's exit code (130 / 143 / 129).
+ *
+ * An interrupt is heard from the first attempt to the last, in a sleep AND in a probe: it aborts what is in flight, and after every await the
+ * loop looks at it first — a runner an attempt picked after the interrupt is not taken, and no other attempt starts.
+ *
+ * `--runner-wait` is a promise about when the command stops waiting, so once the wait has begun no attempt starts with less than
+ * {@link minWaitAttemptMs} left, every attempt is told the time it has (its probe is cut at it), and an answer that comes after the
+ * deadline is refused — the job is not started late. The last sleep is cut so that one more look still fits before the deadline.
+ */
+async function chooseRunnerWithWait(loop) {
+    const startedAtMs = loop.now();
+    const deadlineMs = startedAtMs + loop.waitSeconds * msPerSecond;
+    /** Set once the wait has begun (announced): the attempt that made it worth waiting, then the latest failed one. */
+    let waiting = null;
+    const stop = new AbortController();
+    const interrupted = { signal: null };
+    const stopWatching = loop.watchInterrupts((signal) => {
+        interrupted.signal ??= signal;
+        stop.abort();
+    });
+    const throwIfInterrupted = () => {
+        if (interrupted.signal === null)
+            return;
+        throw new remoteRunError_1.RemoteRunError(waiting === null ? 'interrupted while looking for a runner' : 'interrupted while waiting for a runner', (0, exitCodes_1.planInterrupt)(interrupted.signal).exitCode);
+    };
+    const giveUp = (failure, endNote) => {
+        const waited = waiting === null ? '' : `\nwaited ${formatWaitDuration(Math.round((loop.now() - startedAtMs) / msPerSecond))} for a runner with "${loop.needs}" ${endNote}`;
+        throw new remoteRunError_1.RemoteRunError(`${failure.failure.message}${waited}`, failure.failure.exitCode);
+    };
+    try {
+        for (;;) {
+            if (waiting !== null && deadlineMs - loop.now() < exports.minWaitAttemptMs)
+                giveUp(waiting.lastFailure, 'to come back — none did');
+            const attempt = await loop.attempt(waiting === null ? null : deadlineMs - loop.now(), stop.signal);
+            throwIfInterrupted();
+            if (attempt.ok) {
+                if (waiting === null || loop.now() <= deadlineMs)
+                    return attempt.choice;
+                return giveUp(waiting.lastFailure, 'to come back — one answered only after the wait had ended, so the job was not started');
+            }
+            // The last sleep ends minWaitAttemptMs before the deadline, so the wait ends with one more look instead of with a sleep nobody answers; with
+            // less than that left there is nothing to wait for.
+            const sleepMs = Math.min(loop.pollMs, deadlineMs - loop.now() - exports.minWaitAttemptMs);
+            if (attempt.wait === null || loop.waitSeconds <= 0 || sleepMs <= 0)
+                return giveUp(attempt, 'to come back — none did');
+            if (waiting === null) {
+                loop.say(`waiting for a runner with ${loop.needs} (${attempt.wait.description}) — looking again every ${formatPoll(loop.pollMs)}, up to ${formatWaitDuration(loop.waitSeconds)}`);
+            }
+            waiting = { lastFailure: attempt };
+            await loop.sleep(sleepMs, stop.signal);
+            throwIfInterrupted();
+        }
+    }
+    finally {
+        stopWatching();
+    }
+}
+/** @description `sleep` for {@link chooseRunnerWithWait}: ends after `ms`, or at once when `stop` aborts; its timer never outlives the call. */
+function sleepUntilStopped(ms, stop) {
+    return new Promise((resolve) => {
+        if (stop.aborted) {
+            resolve();
+            return;
+        }
+        const onStop = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            stop.removeEventListener('abort', onStop);
+            resolve();
+        }, ms);
+        stop.addEventListener('abort', onStop, { once: true });
+    });
+}
+//# sourceMappingURL=runnerWait.js.map

package/dist/remoteRun/runnerWait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerWait.js","sourceRoot":"","sources":["../../src/remoteRun/runnerWait.ts"],"names":[],"mappings":"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"}

package/dist/remoteRun/runnerWaitTiming.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @description How long `charness remote-run --needs <capability>` waits for a paired runner that is offline, and how often it looks
+ * again — in a leaf module of its own so the CLI reads them without loading the bot (like `leaseTiming.ts`).
+ *
+ * The test seam `CHARNESS_TEST_TIMINGS` (`testTimings.ts`) may only SHORTEN the poll (key `remoteRunRunnerPollMs`); the CLI cannot import
+ * `testTimings.ts` (its graph reaches the bot), so it reads this one key tolerantly, as the lease does.
+ */
+/** `--runner-wait` when the command line does not say: a laptop that slept or a link that restarts is back well within this. */
+export declare const defaultRunnerWaitSeconds: number;
+/** How often the wait looks at the runners again. */
+export declare const runnerWaitPollMs: number;
+/** A shorter poll would probe every runner (an ssh call each) in a tight loop. */
+export declare const runnerWaitPollMinMs = 200;
+/** @description The poll in force: the production one, or the test seam's shorter `remoteRunRunnerPollMs` when it is a whole number of ms within [min, production]. */
+export declare function readRunnerWaitPollMs(env: NodeJS.ProcessEnv): number;
+//# sourceMappingURL=runnerWaitTiming.d.ts.map

package/dist/remoteRun/runnerWaitTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerWaitTiming.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runnerWaitTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,gIAAgI;AAChI,eAAO,MAAM,wBAAwB,QAAU,CAAC;AAChD,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AACjD,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,uKAAuK;AACvK,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAYnE"}

package/dist/remoteRun/runnerWaitTiming.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @description How long `charness remote-run --needs <capability>` waits for a paired runner that is offline, and how often it looks
+ * again — in a leaf module of its own so the CLI reads them without loading the bot (like `leaseTiming.ts`).
+ *
+ * The test seam `CHARNESS_TEST_TIMINGS` (`testTimings.ts`) may only SHORTEN the poll (key `remoteRunRunnerPollMs`); the CLI cannot import
+ * `testTimings.ts` (its graph reaches the bot), so it reads this one key tolerantly, as the lease does.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runnerWaitPollMinMs = exports.runnerWaitPollMs = exports.defaultRunnerWaitSeconds = void 0;
+exports.readRunnerWaitPollMs = readRunnerWaitPollMs;
+const msPerSecond = 1000;
+/** `--runner-wait` when the command line does not say: a laptop that slept or a link that restarts is back well within this. */
+exports.defaultRunnerWaitSeconds = 15 * 60;
+/** How often the wait looks at the runners again. */
+exports.runnerWaitPollMs = 10 * msPerSecond;
+/** A shorter poll would probe every runner (an ssh call each) in a tight loop. */
+exports.runnerWaitPollMinMs = 200;
+const testTimingsVariableName = 'CHARNESS_TEST_TIMINGS';
+/** @description The poll in force: the production one, or the test seam's shorter `remoteRunRunnerPollMs` when it is a whole number of ms within [min, production]. */
+function readRunnerWaitPollMs(env) {
+    const rawTestTimings = env[testTimingsVariableName];
+    if (rawTestTimings === undefined || rawTestTimings.trim() === '')
+        return exports.runnerWaitPollMs;
+    let overrides;
+    try {
+        overrides = JSON.parse(rawTestTimings);
+    }
+    catch {
+        return exports.runnerWaitPollMs;
+    }
+    const overrideMs = overrides?.remoteRunRunnerPollMs;
+    if (overrideMs === undefined || !Number.isInteger(overrideMs))
+        return exports.runnerWaitPollMs;
+    return overrideMs >= exports.runnerWaitPollMinMs && overrideMs <= exports.runnerWaitPollMs ? overrideMs : exports.runnerWaitPollMs;
+}
+//# sourceMappingURL=runnerWaitTiming.js.map

package/dist/remoteRun/runnerWaitTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerWaitTiming.js","sourceRoot":"","sources":["../../src/remoteRun/runnerWaitTiming.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAaH,oDAYC;AAvBD,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,gIAAgI;AACnH,QAAA,wBAAwB,GAAG,EAAE,GAAG,EAAE,CAAC;AAChD,qDAAqD;AACxC,QAAA,gBAAgB,GAAG,EAAE,GAAG,WAAW,CAAC;AACjD,kFAAkF;AACrE,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAEvC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAExD,uKAAuK;AACvK,SAAgB,oBAAoB,CAAC,GAAsB;IACzD,MAAM,cAAc,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,wBAAgB,CAAC;IAC1F,IAAI,SAAoD,CAAC;IACzD,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,wBAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,EAAE,qBAAqB,CAAC;IACpD,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC;QAAE,OAAO,wBAAgB,CAAC;IACvF,OAAO,UAAU,IAAI,2BAAmB,IAAI,UAAU,IAAI,wBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAgB,CAAC;AAC7G,CAAC"}

package/dist/remoteRun/runners.d.ts

@@ -0,0 +1,57 @@
+import { type RunnerCapability, type RunnerProbe, type RunnerReport } from './probe';
+import { type RunnerClient } from './runnerClient';
+import type { RunnerConfig, RunnersConfig } from './runnersConfig';
+/**
+ * @description Which runners exist right now: probe them (in parallel, bounded), remember each one's last answer so an offline runner
+ * still shows what it was, and pick the one a command should use — the named one, or the first in the catalog (`runners.json` entries,
+ * then the paired runners) that answers, is not paused and, with `--needs`, has the capability.
+ */
+/** The whole probing of all runners ends by then (a dead host costs its ssh connect timeout, once, in parallel with the others). */
+export declare const probeAllTimeoutMs: number;
+export declare function readLastProbe(cacheDir: string, runnerName: string): {
+    seenAtMs: number;
+    probe: RunnerProbe;
+} | null;
+/**
+ * @description Probe one runner: its report is `online` with what it said, or `offline` with why and the last snapshot taken when it
+ * was seen. `signal` is the deadline of the whole view (see {@link probeRunners}): when it fires the ssh calls in flight are killed and the
+ * runner is reported offline — with the snapshot, like any other way of not answering.
+ */
+export declare function probeRunner(client: RunnerClient, nowMs?: number, signal?: AbortSignal, deadlineMs?: number): Promise<RunnerReport>;
+/**
+ * @description Probe every client at once under ONE deadline (20 s): a runner that has not answered by then is reported offline with its
+ * last snapshot and its ssh calls are killed, so the view ends on time and nothing keeps the process alive afterwards. The others are not
+ * held back by it. `stop` ends the same ssh calls from outside — the user interrupted the command that asked.
+ */
+export declare function probeRunners(clients: readonly RunnerClient[], nowMs?: number, deadlineMs?: number, stop?: AbortSignal): Promise<RunnerReport[]>;
+export type RunnerPick = {
+    ok: true;
+    runnerName: string;
+} | {
+    ok: false;
+    message: string;
+    exitCode: number;
+};
+/** The `runners` view of why nothing fits, one block per runner. */
+export declare function formatRunnersView(reports: readonly RunnerReport[]): string;
+/**
+ * @description The runner a command should use. `wanted.runner` names one (it must exist, answer, have Pueue and not be paused);
+ * otherwise the first runner in `config` order that answers, has Pueue, is not paused and — with `wanted.needs` — the capability. None:
+ * the reason and the `runners` view, exit 125.
+ */
+export declare function pickRunner(config: RunnersConfig, reports: readonly RunnerReport[], wanted: {
+    runner: string | null;
+    needs: RunnerCapability | null;
+}): RunnerPick;
+/**
+ * @description The runner `exec` goes to. `exec` runs in the runner's copy "as the last job left it", so without `--runner` that is the
+ * runner of this project's last job (`lastRunnerName`), not the first one that answers — with several runners the first could hold no copy
+ * of the project, or an old one. No job yet: `null` (any online runner); a last runner that left `runners.json`: `null` and a note.
+ */
+export declare function chooseExecRunnerName(config: RunnersConfig, named: string | null, lastRunnerName: string | null): {
+    runnerName: string | null;
+    note: string | null;
+};
+/** @description The runner of a job id, from the config: an id of a runner that is no longer listed is an error. */
+export declare function findRunnerOfJob(config: RunnersConfig, runnerName: string): RunnerConfig;
+//# sourceMappingURL=runners.d.ts.map

package/dist/remoteRun/runners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runners.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;GAIG;AAEH,oIAAoI;AACpI,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAc3C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAQnH;AAOD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,GAAE,MAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,GAAE,MAA0B,GAAG,OAAO,CAAC,YAAY,CAAC,CAgCvK;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,GAAE,MAAmB,EAAE,UAAU,GAAE,MAA0B,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CASpL;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7G,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAE1E;AAuBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,GAAG,UAAU,CAqBjK;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAInK;AAED,oHAAoH;AACpH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAIvF"}

package/dist/remoteRun/runners.js

@@ -0,0 +1,209 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.probeAllTimeoutMs = void 0;
+exports.readLastProbe = readLastProbe;
+exports.probeRunner = probeRunner;
+exports.probeRunners = probeRunners;
+exports.formatRunnersView = formatRunnersView;
+exports.pickRunner = pickRunner;
+exports.chooseExecRunnerName = chooseExecRunnerName;
+exports.findRunnerOfJob = findRunnerOfJob;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const linkControl_1 = require("../runners/linkControl");
+const probe_1 = require("./probe");
+const remoteRunError_1 = require("./remoteRunError");
+const exitCodes_1 = require("./exitCodes");
+const runnerClient_1 = require("./runnerClient");
+/**
+ * @description Which runners exist right now: probe them (in parallel, bounded), remember each one's last answer so an offline runner
+ * still shows what it was, and pick the one a command should use — the named one, or the first in the catalog (`runners.json` entries,
+ * then the paired runners) that answers, is not paused and, with `--needs`, has the capability.
+ */
+/** The whole probing of all runners ends by then (a dead host costs its ssh connect timeout, once, in parallel with the others). */
+exports.probeAllTimeoutMs = 20 * 1000;
+const probeFileSuffix = '.probe.json';
+const millisecondsPerSecond = 1000;
+function getStoredProbePath(cacheDir, runnerName) {
+    return path.join(cacheDir, `${runnerName}${probeFileSuffix}`);
+}
+function readLastProbe(cacheDir, runnerName) {
+    try {
+        const stored = JSON.parse(fs.readFileSync(getStoredProbePath(cacheDir, runnerName), 'utf8'));
+        if (typeof stored.seenAtMs !== 'number' || typeof stored.text !== 'string')
+            return null;
+        return { seenAtMs: stored.seenAtMs, probe: (0, probe_1.parseProbeOutput)(stored.text) };
+    }
+    catch {
+        return null;
+    }
+}
+function writeLastProbe(cacheDir, runnerName, text, seenAtMs) {
+    const stored = { seenAtMs, text };
+    fs.writeFileSync(getStoredProbePath(cacheDir, runnerName), JSON.stringify(stored), { mode: 0o600 });
+}
+/**
+ * @description Probe one runner: its report is `online` with what it said, or `offline` with why and the last snapshot taken when it
+ * was seen. `signal` is the deadline of the whole view (see {@link probeRunners}): when it fires the ssh calls in flight are killed and the
+ * runner is reported offline — with the snapshot, like any other way of not answering.
+ */
+async function probeRunner(client, nowMs = Date.now(), signal, deadlineMs = exports.probeAllTimeoutMs) {
+    const runner = client.runner;
+    const groupLimits = { ...(runner.groups ?? {}) };
+    const isPausedByHub = runner.paired?.isPausedByHub ?? false;
+    const offline = (reason, linkLastSeenMs = null) => {
+        const last = readLastProbe(client.cacheDir, runner.name);
+        return {
+            name: runner.name,
+            status: 'offline',
+            reason: signal?.aborted === true ? `no answer within ${Math.round(deadlineMs / millisecondsPerSecond)} s` : reason,
+            // The link's own heartbeat is the better «last seen» of a paired runner: the last probe may be hours older than its last connection.
+            lastSeenAtMs: linkLastSeenMs ?? last?.seenAtMs ?? null,
+            lastProbe: last?.probe ?? null,
+            groupLimits,
+            isPausedByHub,
+        };
+    };
+    if (runner.paired !== undefined) {
+        // A paired runner is online when its link accepts a connection; asking is cheaper than an ssh call that fails through the proxy.
+        const link = await (0, linkControl_1.getRunnerLinkStatus)(runner.paired.hubDir, runner.paired.runnerId);
+        if (!link.isOnline)
+            return offline(runnerClient_1.notConnectedReason, link.lastSeenMs);
+    }
+    try {
+        await client.ensureScript(signal);
+    }
+    catch (error) {
+        if (error instanceof remoteRunError_1.RunnerUnreachableError)
+            return offline(error.reason);
+        return offline(error instanceof Error ? error.message : 'could not prepare the runner');
+    }
+    const result = await client.call('probe', [], { timeoutMs: deadlineMs, signal });
+    if (result.exitCode !== 0)
+        return offline((0, runnerClient_1.describeSshFailure)(result));
+    writeLastProbe(client.cacheDir, runner.name, result.stdout, nowMs);
+    return { name: runner.name, status: 'online', probe: (0, probe_1.parseProbeOutput)(result.stdout), groupLimits, isPausedByHub };
+}
+/**
+ * @description Probe every client at once under ONE deadline (20 s): a runner that has not answered by then is reported offline with its
+ * last snapshot and its ssh calls are killed, so the view ends on time and nothing keeps the process alive afterwards. The others are not
+ * held back by it. `stop` ends the same ssh calls from outside — the user interrupted the command that asked.
+ */
+async function probeRunners(clients, nowMs = Date.now(), deadlineMs = exports.probeAllTimeoutMs, stop) {
+    const deadline = new AbortController();
+    const timer = setTimeout(() => deadline.abort(), deadlineMs);
+    const signal = stop === undefined ? deadline.signal : AbortSignal.any([deadline.signal, stop]);
+    try {
+        return await Promise.all(clients.map((client) => probeRunner(client, nowMs, signal, deadlineMs)));
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** The `runners` view of why nothing fits, one block per runner. */
+function formatRunnersView(reports) {
+    return reports.map(probe_1.formatRunnerBlock).join('\n\n');
+}
+function checkIsUsable(report) {
+    return report.status === 'online' && report.probe.pueueVersion !== null && !(0, probe_1.checkIsRunnerPaused)(report);
+}
+/** Who paused a runner and the way back, for the message of a pick that refused it. */
+function describePause(report) {
+    const probe = report.status === 'online' ? report.probe : report.lastProbe;
+    return [
+        ...(report.isPausedByHub ? [`from the hub — \`charness runners resume ${report.name}\``] : []),
+        ...(probe?.isPaused === true ? ['on the runner — `charness-runner resume` there'] : []),
+    ].join(' and ');
+}
+/** « (paused, so not used: mac)» for the online runners a pick skipped only because they are paused (only those that could have done the job), else nothing. */
+function describeSkippedPaused(reports, needs) {
+    const names = reports
+        .filter((report) => report.status === 'online' && report.probe.pueueVersion !== null && (0, probe_1.checkIsRunnerPaused)(report) && (needs === null || (0, probe_1.checkHasCapability)(report.probe, needs)))
+        .map((report) => report.name);
+    return names.length === 0 ? '' : ` (paused, so not used: ${names.join(', ')})`;
+}
+/**
+ * @description The runner a command should use. `wanted.runner` names one (it must exist, answer, have Pueue and not be paused);
+ * otherwise the first runner in `config` order that answers, has Pueue, is not paused and — with `wanted.needs` — the capability. None:
+ * the reason and the `runners` view, exit 125.
+ */
+function pickRunner(config, reports, wanted) {
+    if (wanted.runner !== null) {
+        const report = reports.find((candidate) => candidate.name === wanted.runner);
+        if (report === undefined) {
+            return { ok: false, exitCode: exitCodes_1.remoteRunExitCodes.usage, message: `no runner named "${wanted.runner}" (configured: ${config.runners.map((runner) => runner.name).join(', ')})` };
+        }
+        if (report.status === 'offline')
+            return { ok: false, exitCode: exitCodes_1.remoteRunExitCodes.failed, message: `runner "${wanted.runner}" is offline (${report.reason})\n${formatRunnersView([report])}` };
+        if (report.probe.pueueVersion === null)
+            return { ok: false, exitCode: exitCodes_1.remoteRunExitCodes.failed, message: `runner "${wanted.runner}" has no Pueue (install it there, see docs/remote-run.md)\n${formatRunnersView([report])}` };
+        if ((0, probe_1.checkIsRunnerPaused)(report))
+            return { ok: false, exitCode: exitCodes_1.remoteRunExitCodes.failed, message: `runner "${wanted.runner}" is paused ${describePause(report)}\n${formatRunnersView([report])}` };
+        if (wanted.needs !== null && !(0, probe_1.checkHasCapability)(report.probe, wanted.needs)) {
+            return { ok: false, exitCode: exitCodes_1.remoteRunExitCodes.failed, message: `runner "${wanted.runner}" cannot do "${wanted.needs}"\n${formatRunnersView([report])}` };
+        }
+        return { ok: true, runnerName: report.name };
+    }
+    for (const runner of config.runners) {
+        const report = reports.find((candidate) => candidate.name === runner.name);
+        if (report === undefined || !checkIsUsable(report))
+            continue;
+        if (wanted.needs === null || (0, probe_1.checkHasCapability)(report.probe, wanted.needs))
+            return { ok: true, runnerName: runner.name };
+    }
+    const reason = wanted.needs === null ? 'no runner is online' : `no online runner can do "${wanted.needs}"`;
+    return { ok: false, exitCode: exitCodes_1.remoteRunExitCodes.failed, message: `${reason}${describeSkippedPaused(reports, wanted.needs)}\n${formatRunnersView(reports)}` };
+}
+/**
+ * @description The runner `exec` goes to. `exec` runs in the runner's copy "as the last job left it", so without `--runner` that is the
+ * runner of this project's last job (`lastRunnerName`), not the first one that answers — with several runners the first could hold no copy
+ * of the project, or an old one. No job yet: `null` (any online runner); a last runner that left `runners.json`: `null` and a note.
+ */
+function chooseExecRunnerName(config, named, lastRunnerName) {
+    if (named !== null || lastRunnerName === null)
+        return { runnerName: named, note: null };
+    if (config.runners.some((runner) => runner.name === lastRunnerName))
+        return { runnerName: lastRunnerName, note: null };
+    return { runnerName: null, note: `the runner of this project's last job, "${lastRunnerName}", is not a configured runner any more (not in runners.json, not paired) — using the first online runner` };
+}
+/** @description The runner of a job id, from the config: an id of a runner that is no longer listed is an error. */
+function findRunnerOfJob(config, runnerName) {
+    const runner = config.runners.find((candidate) => candidate.name === runnerName);
+    if (runner === undefined)
+        throw new remoteRunError_1.RemoteRunError(`the job belongs to runner "${runnerName}", which is not a configured runner any more (not in runners.json, not paired)`);
+    return runner;
+}
+//# sourceMappingURL=runners.js.map

package/dist/remoteRun/runners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.js","sourceRoot":"","sources":["../../src/remoteRun/runners.ts"],"names":[],"mappings":"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"}

package/dist/remoteRun/runnersCatalog.d.ts

@@ -0,0 +1,14 @@
+import type { ConfigFileLoad } from '../configDirFile';
+import { type RunnersConfig } from './runnersConfig';
+/**
+ * @description Every runner `remote-run` may use: the hand-made ones of `runners.json` (plain ssh, phase 1) and the paired ones of the
+ * hub's registry (`pairedRunners.ts`), as one list with the hand-made first — the order `pickRunner` walks. A name in both is an error
+ * that names it (a runner is addressed by name, in job ids too); pairing itself avoids the clash by renaming a newcomer (`-2`), so it can
+ * only come from a hand edit made afterwards. This is the only place that knows both sources; it is kept apart from `runnersConfig.ts`
+ * because the hub registry's schemas import that file.
+ *
+ * Both loads are stamp-cached, so the bot MCP can read the runners (`runnerSummary.ts`) on every connect for the cost of two `stat` calls.
+ */
+/** @description The runners of the user whose home is `homeDir`. `missing` = neither a `runners.json` nor a paired runner; `invalid` carries every problem and, when there is one, the last good (or best-effort) list. */
+export declare function loadRunnersCatalog(homeDir?: string): ConfigFileLoad<RunnersConfig>;
+//# sourceMappingURL=runnersCatalog.d.ts.map

package/dist/remoteRun/runnersCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnersCatalog.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runnersCatalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3F;;;;;;;;GAQG;AAEH,2NAA2N;AAC3N,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAqB,GAAG,cAAc,CAAC,aAAa,CAAC,CAgBhG"}