charness 3.7.0 → 3.8.0

package/dist/remoteRun/runnerClient.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shortCallTimeoutMs = void 0;
+exports.notConnectedReason = exports.shortCallTimeoutMs = void 0;
 exports.getRunnerScriptPath = getRunnerScriptPath;
 exports.readRunnerScript = readRunnerScript;
 exports.describeSshFailure = describeSshFailure;
@@ -62,6 +62,8 @@ function readRunnerScript(scriptPath = getRunnerScriptPath()) {
     const text = fs.readFileSync(scriptPath, 'utf8');
     return { name: `runner-${(0, crypto_1.createHash)('sha256').update(text).digest('hex').slice(0, scriptHashLength)}.sh`, text };
 }
+/** Why a paired runner whose link is down is offline — the words `charness runner-proxy` (`runners/runnerProxy.ts`) puts on stderr when nothing listens on the link's socket. */
+exports.notConnectedReason = 'the runner is not connected';
 /**
  * @description The first useful line of a failed ssh's stderr, for a message (never the whole text: it may quote the destination). A
  * rejected key from a process with no ssh-agent (`SSH_AUTH_SOCK` unset — a tracker agent such as Jira's starts with a minimal environment
@@ -70,6 +72,8 @@ function readRunnerScript(scriptPath = getRunnerScriptPath()) {
 function describeSshFailure(result, env = process.env) {
     if (result.isTimedOut)
         return 'ssh: the command ran past its deadline';
+    if (result.stderr.includes(exports.notConnectedReason))
+        return exports.notConnectedReason;
     const lines = result.stderr.split('\n').map((line) => line.trim()).filter((line) => line !== '');
     const text = lines.length === 0 ? `ssh exited with ${result.exitCode ?? 'a signal'}` : lines[lines.length - 1];
     if (/host key verification failed/i.test(result.stderr))

package/dist/remoteRun/runnerClient.js.map

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

package/dist/remoteRun/runnerSummary.d.ts

@@ -0,0 +1,24 @@
+import { type RunnerCapability, type RunnerProbe } from './probe';
+import type { RunnerConfig } from './runnersConfig';
+/** @description The OS text of a runner as a short plain label: letters, digits and a few signs; no line break, no markup, 40 characters at most. */
+export declare function sanitizeOsLabel(reportedOs: string): string;
+/** @name RunnerSummary @description What the instructions say of one runner. */
+export interface RunnerSummary {
+    name: string;
+    osLabel: string;
+    /** The capabilities it had when last probed, in the order `--needs` lists them. */
+    capabilities: RunnerCapability[];
+    /** Paused from the hub, or on the runner itself when last seen: not used for new jobs. */
+    isPaused: boolean;
+}
+/** @description The summary of `runner`; `probe` is its last snapshot, if it has one. */
+export declare function summarizeRunner(runner: RunnerConfig, probe: RunnerProbe | null): RunnerSummary;
+/** @description `mac — macOS 15.1, android, playwright`; `box1 (paused) — Ubuntu 24.04`; just the name when nothing else is known. */
+export declare function formatRunnerSummaryLine(summary: RunnerSummary): string;
+/**
+ * @description The lines for the instructions of a session that connects now: one per runner of the catalog (hand-made first, then paired; a
+ * catalog with an error still gives the runners that last loaded). Empty = no runner, and remote-run is not mentioned. The snapshots are
+ * read from the cache `env` names — the bot's own, which the agents share (`XDG_CACHE_HOME` is on the tracker agents' allowlist).
+ */
+export declare function getRunnerSummaryLines(homeDir?: string, env?: NodeJS.ProcessEnv): string[];
+//# sourceMappingURL=runnerSummary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runnerSummary.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runnerSummary.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAiBpD,qJAAqJ;AACrJ,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,CAQ9F;AAED,sIAAsI;AACtI,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAGtE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAAqB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAIpH"}

package/dist/remoteRun/runnerSummary.js

@@ -0,0 +1,86 @@
+"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.sanitizeOsLabel = sanitizeOsLabel;
+exports.summarizeRunner = summarizeRunner;
+exports.formatRunnerSummaryLine = formatRunnerSummaryLine;
+exports.getRunnerSummaryLines = getRunnerSummaryLines;
+const os = __importStar(require("os"));
+const probe_1 = require("./probe");
+const runners_1 = require("./runners");
+const runnersCatalog_1 = require("./runnersCatalog");
+const ssh_1 = require("./ssh");
+/**
+ * @description The one line per runner that the bot MCP's instructions give an agent — `mac — macOS 15.1, android, playwright`: the name, the
+ * OS and what the runner could do when it was last probed (`remote-run`'s own snapshot, so a runner nobody has probed yet shows only its name
+ * and the OS it reported at pairing). It is a hint for choosing `--needs`, read once per connect; the live state — online, load, jobs — stays
+ * in `charness remote-run runners`, which the bullet tells the agent to look at first.
+ *
+ * What a runner machine reported (its OS name) goes into an agent's instructions, so it is reduced to a short plain label here: a runner is
+ * code the operator attached, not a voice the agent should obey.
+ */
+const maxOsLabelLength = 40;
+/** `/` stays: `/etc/os-release` names are «Debian GNU/Linux 12»; a slash cannot start a line, a bullet or markup. */
+const unsafeLabelCharacters = /[^A-Za-z0-9 ._+()/-]/g;
+/** @description The OS text of a runner as a short plain label: letters, digits and a few signs; no line break, no markup, 40 characters at most. */
+function sanitizeOsLabel(reportedOs) {
+    return reportedOs.replace(unsafeLabelCharacters, '').replace(/\s+/g, ' ').trim().slice(0, maxOsLabelLength).trim();
+}
+/** @description The summary of `runner`; `probe` is its last snapshot, if it has one. */
+function summarizeRunner(runner, probe) {
+    const probedOs = probe === null ? '' : [probe.osName, probe.osVersion].filter((part) => part !== '').join(' ');
+    return {
+        name: runner.name,
+        osLabel: sanitizeOsLabel(probedOs !== '' ? probedOs : (runner.paired?.os ?? '')),
+        capabilities: probe === null ? [] : probe_1.runnerCapabilities.filter((capability) => probe.capabilities[capability].isAvailable),
+        isPaused: runner.paired?.isPausedByHub === true || probe?.isPaused === true,
+    };
+}
+/** @description `mac — macOS 15.1, android, playwright`; `box1 (paused) — Ubuntu 24.04`; just the name when nothing else is known. */
+function formatRunnerSummaryLine(summary) {
+    const details = [...(summary.osLabel === '' ? [] : [summary.osLabel]), ...summary.capabilities];
+    return `${summary.name}${summary.isPaused ? ' (paused)' : ''}${details.length === 0 ? '' : ` — ${details.join(', ')}`}`;
+}
+/**
+ * @description The lines for the instructions of a session that connects now: one per runner of the catalog (hand-made first, then paired; a
+ * catalog with an error still gives the runners that last loaded). Empty = no runner, and remote-run is not mentioned. The snapshots are
+ * read from the cache `env` names — the bot's own, which the agents share (`XDG_CACHE_HOME` is on the tracker agents' allowlist).
+ */
+function getRunnerSummaryLines(homeDir = os.homedir(), env = process.env) {
+    const runners = (0, runnersCatalog_1.loadRunnersCatalog)(homeDir).config?.runners ?? [];
+    const cacheDir = (0, ssh_1.getRemoteRunCacheDir)(env, homeDir);
+    return runners.map((runner) => formatRunnerSummaryLine(summarizeRunner(runner, (0, runners_1.readLastProbe)(cacheDir, runner.name)?.probe ?? null)));
+}
+//# sourceMappingURL=runnerSummary.js.map

package/dist/remoteRun/runnerSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerSummary.js","sourceRoot":"","sources":["../../src/remoteRun/runnerSummary.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,0CAEC;AAaD,0CAQC;AAGD,0DAGC;AAOD,sDAIC;AA9DD,uCAAyB;AACzB,mCAAsF;AACtF,uCAA0C;AAC1C,qDAAsD;AAEtD,+BAA6C;AAE7C;;;;;;;;GAQG;AAEH,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,qHAAqH;AACrH,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,qJAAqJ;AACrJ,SAAgB,eAAe,CAAC,UAAkB;IAChD,OAAO,UAAU,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC;AACrH,CAAC;AAYD,yFAAyF;AACzF,SAAgB,eAAe,CAAC,MAAoB,EAAE,KAAyB;IAC7E,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/G,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,eAAe,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,YAAY,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,0BAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC;QACzH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,IAAI,KAAK,EAAE,QAAQ,KAAK,IAAI;KAC5E,CAAC;AACJ,CAAC;AAED,sIAAsI;AACtI,SAAgB,uBAAuB,CAAC,OAAsB;IAC5D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;AAC1H,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,CAAC,OAAO,EAAE,EAAE,MAAyB,OAAO,CAAC,GAAG;IACxG,MAAM,OAAO,GAAG,IAAA,mCAAkB,EAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAA,0BAAoB,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,eAAe,CAAC,MAAM,EAAE,IAAA,uBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AACxI,CAAC"}

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":";;;AA+BA,wCAaC;AAGD,gDAOC;AA6CD,oDA2CC;AAGD,8CAgBC;AAjKD,2CAAkE;AAClE,mCAA4H;AAC5H,qDAAkD;AAIlD;;;;;;GAMG;AAEH,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,cAAc,GAAG,IAAI,CAAC;AAU5B;;;;GAIG;AACH,SAAgB,cAAc,CAAC,MAAqB,EAAE,OAAgC,EAAE,MAAiE;IACvJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAA0D,EAAE;QACnG,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC7G,OAAO,QAAQ,IAAI,CAAC,IAAA,2BAAmB,EAAC,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,YAAY,KAAK,IAAI,IAAI,IAAA,0BAAkB,EAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3I,CAAC,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO;QACL,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACpD,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAA,sBAAc,EAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACnK,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,IAAI,YAAY,GAAG,gBAAgB;QAAE,OAAO,GAAG,YAAY,IAAI,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,cAAc,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,cAAc,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,YAAY,GAAG,gBAAgB,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1J,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,iGAAiG;AACjG,SAAS,UAAU,CAAC,MAAc;IAChC,OAAO,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,yIAAyI;AAC5H,QAAA,gBAAgB,GAAG,IAAI,CAAC;AAyBrC;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,oBAAoB,CAAU,IAA6B;IAE/E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChE,mHAAmH;IACnH,IAAI,OAAO,GAA0C,IAAI,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,MAAM,WAAW,GAAuC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzE,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,EAAE;QACnD,WAAW,CAAC,MAAM,KAAK,MAAM,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IACH,MAAM,kBAAkB,GAAG,GAAS,EAAE;QACpC,IAAI,WAAW,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO;QACxC,MAAM,IAAI,+BAAc,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,wCAAwC,EAAE,IAAA,yBAAa,EAAC,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/K,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAE,OAAe,EAAS,EAAE;QAChE,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,WAAW,CAAC,CAAC,uBAAuB,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC3K,MAAM,IAAI,+BAAc,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5F,CAAC,CAAC;IACF,IAAI,CAAC;QACH,SAAS,CAAC;YACR,IAAI,OAAO,KAAK,IAAI,IAAI,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,wBAAgB;gBAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;YAC3H,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnG,kBAAkB,EAAE,CAAC;YACrB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;gBACf,IAAI,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU;oBAAE,OAAO,OAAO,CAAC,MAAM,CAAC;gBACxE,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,uFAAuF,CAAC,CAAC;YAC9H,CAAC;YACD,6IAA6I;YAC7I,oDAAoD;YACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,wBAAgB,CAAC,CAAC;YAClF,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC;gBAAE,OAAO,MAAM,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;YACtH,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,WAAW,2BAA2B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACpL,CAAC;YACD,OAAO,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,kBAAkB,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,gJAAgJ;AAChJ,SAAgB,iBAAiB,CAAC,EAAU,EAAE,IAAiB;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -3,8 +3,8 @@ 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 `runners.json` that answers and, with
- * `--needs`, has the capability.
+ * 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;
@@ -21,9 +21,9 @@ export declare function probeRunner(client: RunnerClient, nowMs?: number, signal
 /**
  * @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.
+ * 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): Promise<RunnerReport[]>;
+export declare function probeRunners(clients: readonly RunnerClient[], nowMs?: number, deadlineMs?: number, stop?: AbortSignal): Promise<RunnerReport[]>;
 export type RunnerPick = {
     ok: true;
     runnerName: string;
@@ -35,9 +35,9 @@ export type RunnerPick = {
 /** 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 and have Pueue); otherwise the first
- * runner in `config` order that answers, has Pueue and — with `wanted.needs` — the capability. None: the reason and the `runners`
- * view, exit 125.
+ * @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;

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

@@ -1 +1 @@
-{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runners.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,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,CAwBvK;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,GAAE,MAAmB,EAAE,UAAU,GAAE,MAA0B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAQhK;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;AAMD;;;;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,CAoBjK;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"}
+{"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"}