charness 3.6.1 → 3.8.0

package/dist/remoteRun/leaseTiming.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @description The heartbeat lease of a foreground run, in a module of its own so the CLI reads it without loading the bot: a
+ * runner kills a job whose caller stopped writing its heartbeat byte for this long — a stock sshd never notices a half-open
+ * connection, so this is the only thing that ends an orphaned job.
+ *
+ * The test seam `CHARNESS_TEST_TIMINGS` (`testTimings.ts`) may only SHORTEN it (key `remoteRunLeaseMs`). The CLI cannot import
+ * `testTimings.ts` (its graph reaches the bot), so it reads this one key tolerantly, as the hot supervisor reads its own two; the
+ * boot of an instance that carries a bad value is what refuses it by name.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remoteRunLeaseMinMs = exports.remoteRunLeaseMs = void 0;
+exports.readRemoteRunLeaseMs = readRemoteRunLeaseMs;
+exports.getHeartbeatIntervalMs = getHeartbeatIntervalMs;
+/** Production lease: no heartbeat for this long → the job is killed. */
+exports.remoteRunLeaseMs = 45 * 1000;
+/** The caller beats nine times per lease, so a few lost beats never kill a healthy job (production: every 5 s). */
+const beatsPerLease = 9;
+/** A shorter lease than this would kill a healthy job on one slow second of the runner's. */
+exports.remoteRunLeaseMinMs = 3000;
+const testTimingsVariableName = 'CHARNESS_TEST_TIMINGS';
+/** @description The lease in force: the production one, or the test seam's shorter `remoteRunLeaseMs` when it is a whole number of ms within [min, production]. */
+function readRemoteRunLeaseMs(env) {
+    const rawTestTimings = env[testTimingsVariableName];
+    if (rawTestTimings === undefined || rawTestTimings.trim() === '')
+        return exports.remoteRunLeaseMs;
+    let overrides;
+    try {
+        overrides = JSON.parse(rawTestTimings);
+    }
+    catch {
+        return exports.remoteRunLeaseMs;
+    }
+    const overrideMs = overrides?.remoteRunLeaseMs;
+    if (overrideMs === undefined || !Number.isInteger(overrideMs))
+        return exports.remoteRunLeaseMs;
+    return overrideMs >= exports.remoteRunLeaseMinMs && overrideMs <= exports.remoteRunLeaseMs ? overrideMs : exports.remoteRunLeaseMs;
+}
+/** @description How often the caller writes its heartbeat byte for a lease of `leaseMs`. */
+function getHeartbeatIntervalMs(leaseMs) {
+    return Math.floor(leaseMs / beatsPerLease);
+}
+//# sourceMappingURL=leaseTiming.js.map

package/dist/remoteRun/leaseTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaseTiming.js","sourceRoot":"","sources":["../../src/remoteRun/leaseTiming.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAYH,oDAYC;AAGD,wDAEC;AA3BD,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC1C,mHAAmH;AACnH,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,6FAA6F;AAChF,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAExD,mKAAmK;AACnK,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,SAA+C,CAAC;IACpD,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,gBAAgB,CAAC;IAC/C,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;AAED,4FAA4F;AAC5F,SAAgB,sBAAsB,CAAC,OAAe;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;AAC7C,CAAC"}

package/dist/remoteRun/output.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @description What the commands write and where: the job's output to stdout, remote-run's own lines to stderr prefixed `remote-run: `.
+ * The job script writes ITS progress lines (waiting for another job of the project, installing dependencies, a timeout) into the job's
+ * log with the same prefix, so the router sends every log line that starts with it to stderr — a command that prints such a line itself
+ * only moves it to the other stream.
+ */
+export declare const ownLinePrefix = "remote-run: ";
+export interface CliIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    homeDir: string;
+}
+/** @description The io of the real process. */
+export declare function createProcessIo(): CliIo;
+/** @description One of remote-run's own lines, to stderr. */
+export declare function sayOwn(io: Pick<CliIo, 'stderr'>, line: string): void;
+export interface JobOutputRouter {
+    write: (chunk: string) => void;
+    /** The last, unfinished line, if any (a stream that ended without a newline). */
+    flush: () => void;
+}
+export declare function createJobOutputRouter(io: Pick<CliIo, 'stdout' | 'stderr'>): JobOutputRouter;
+export interface ExitMarkerFilter {
+    write: (chunk: string) => void;
+    /** Hand on what is still held back (a stream that ended). */
+    flush: () => void;
+    /** The code of the last marker seen, or `null` when none arrived. */
+    getExitCode: () => number | null;
+}
+/**
+ * @description Takes the exit marker `runner.sh exec` prints out of a stderr stream, however the stream is cut into chunks, and hands on
+ * everything else at once — a partial marker is held back only until the rest arrives or the stream ends.
+ */
+export declare function createExitMarkerFilter(forward: (text: string) => void): ExitMarkerFilter;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/remoteRun/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,IAAI,KAAK,CAQvC;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iFAAiF;IACjF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,eAAe,CAqB3F;AAOD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,gBAAgB,CA2BxF"}

package/dist/remoteRun/output.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * @description What the commands write and where: the job's output to stdout, remote-run's own lines to stderr prefixed `remote-run: `.
+ * The job script writes ITS progress lines (waiting for another job of the project, installing dependencies, a timeout) into the job's
+ * log with the same prefix, so the router sends every log line that starts with it to stderr — a command that prints such a line itself
+ * only moves it to the other stream.
+ */
+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.ownLinePrefix = void 0;
+exports.createProcessIo = createProcessIo;
+exports.sayOwn = sayOwn;
+exports.createJobOutputRouter = createJobOutputRouter;
+exports.createExitMarkerFilter = createExitMarkerFilter;
+const os = __importStar(require("os"));
+exports.ownLinePrefix = 'remote-run: ';
+/** @description The io of the real process. */
+function createProcessIo() {
+    return {
+        stdout: (text) => { process.stdout.write(text); },
+        stderr: (text) => { process.stderr.write(text); },
+        cwd: process.cwd(),
+        env: process.env,
+        homeDir: os.homedir(),
+    };
+}
+/** @description One of remote-run's own lines, to stderr. */
+function sayOwn(io, line) {
+    io.stderr(`${exports.ownLinePrefix}${line}\n`);
+}
+function createJobOutputRouter(io) {
+    let pending = '';
+    const emit = (line) => {
+        if (line.startsWith(exports.ownLinePrefix))
+            io.stderr(line);
+        else
+            io.stdout(line);
+    };
+    return {
+        write(chunk) {
+            pending += chunk;
+            let newline = pending.indexOf('\n');
+            while (newline >= 0) {
+                emit(pending.slice(0, newline + 1));
+                pending = pending.slice(newline + 1);
+                newline = pending.indexOf('\n');
+            }
+        },
+        flush() {
+            if (pending !== '')
+                emit(pending);
+            pending = '';
+        },
+    };
+}
+/** The line `runner.sh exec` ends its stderr with: RS (U+001E), the name, the command's exit code, a newline. */
+const exitMarkerPattern = /\u001eremote-run-exit:(\d+)\n/g;
+/** A marker that has begun but not arrived whole is held back at most this long (the marker is shorter than this). */
+const exitMarkerHoldBackLength = 40;
+/**
+ * @description Takes the exit marker `runner.sh exec` prints out of a stderr stream, however the stream is cut into chunks, and hands on
+ * everything else at once — a partial marker is held back only until the rest arrives or the stream ends.
+ */
+function createExitMarkerFilter(forward) {
+    let pending = '';
+    let exitCode = null;
+    return {
+        write(chunk) {
+            let text = pending + chunk;
+            pending = '';
+            let handedOn = 0;
+            for (const match of text.matchAll(exitMarkerPattern)) {
+                if (match.index > handedOn)
+                    forward(text.slice(handedOn, match.index));
+                exitCode = Number(match[1]);
+                handedOn = match.index + match[0].length;
+            }
+            text = text.slice(handedOn);
+            const markerStart = text.lastIndexOf('\u001e');
+            if (markerStart >= 0 && text.length - markerStart < exitMarkerHoldBackLength && !text.slice(markerStart).includes('\n')) {
+                pending = text.slice(markerStart);
+                text = text.slice(0, markerStart);
+            }
+            if (text !== '')
+                forward(text);
+        },
+        flush() {
+            if (pending !== '')
+                forward(pending);
+            pending = '';
+        },
+        getExitCode: () => exitCode,
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/remoteRun/output.js.map

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

package/dist/remoteRun/pairedRunners.d.ts

@@ -0,0 +1,51 @@
+import { type ConfigFileLoad } from '../configDirFile';
+import { type PairedRunner } from '../runners/hubRegistry';
+import type { RunnerConfig } from './runnersConfig';
+/**
+ * @description Paired runners as `remote-run` sees them: the same `RunnerConfig` an entry of `runners.json` gives, built from the hub's
+ * registry (`paired.json`, `src/runners/`), so everything above the ssh layer — the script upload, rsync, Pueue, the lease — is phase 1
+ * unchanged. Only the way ssh reaches the machine differs: no host and port, but a `ProxyCommand` that joins ssh to the unix socket of
+ * the runner's link (`charness runner-proxy`), the runner's host key pinned under an alias from the hub's own `known_hosts`, and the
+ * hub's key. Nothing here talks to the network or to the runner; whether the link is up is `linkControl.ts`'s question.
+ */
+/** @description A path this machine's registry or program lives in cannot be put on an ssh command line; the runner stays out of the catalog, with the reason. */
+export declare class PairedRunnerSetupError extends Error {
+    constructor(message: string);
+}
+export interface PairedSshOptionsInput {
+    runnerId: string;
+    nodePath: string;
+    cliPath: string;
+    hubDir: string;
+}
+/**
+ * @description The ssh options of every call to a paired runner (the operator's `-F /dev/null` stands in for a config file: the machine's
+ * own ssh config must not change how the link is reached). The host key is checked strictly against the one the runner gave at pairing.
+ */
+export declare function buildPairedSshOptions(input: PairedSshOptionsInput): string[];
+/**
+ * @description Where the runner's Pueue lives, from the work dir it reported: the runner utility keeps `work/`, `bin/` and `pueue/` side by
+ * side in `~/.charness-runner/` (`runnerHome.ts` is the one place that layout is written down). A work dir that does not follow it gives
+ * `undefined` — the runner script then finds Pueue on the `PATH` as for any hand-made runner.
+ */
+export declare function getPairedRunnerPueue(workDir: string): RunnerConfig['pueue'];
+export interface PairedHubEnvironment {
+    hubDir: string;
+    nodePath: string;
+    cliPath: string;
+}
+/** @description The `RunnerConfig` of one registry entry. Throws a {@link PairedRunnerSetupError} when the paths of this machine cannot be put on an ssh command line. */
+export declare function buildPairedRunnerConfig(runner: PairedRunner, hub: PairedHubEnvironment): RunnerConfig;
+export interface PairedRunnersLoad {
+    runners: RunnerConfig[];
+    /** One line per problem; the runners that could not be built are not in `runners`. */
+    errors: string[];
+}
+/**
+ * @description The paired runners of the user whose home is `homeDir`, from `paired.json` (stamp-cached like `runners.json`: the bot MCP
+ * asks on every connect). Missing = none paired; invalid = its errors and the last good list of this process, if any.
+ */
+export declare function loadPairedRunners(homeDir: string): ConfigFileLoad<PairedRunnersLoad>;
+/** @description Forget the cached loads (tests that swap files under one path). */
+export declare function resetPairedRunnersCache(): void;
+//# sourceMappingURL=pairedRunners.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pairedRunners.d.ts","sourceRoot":"","sources":["../../src/remoteRun/pairedRunners.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGtE;;;;;;GAMG;AAEH,kKAAkK;AAClK,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAiBD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAgB5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAM3E;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0KAA0K;AAC1K,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,oBAAoB,GAAG,YAAY,CAUrG;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,sFAAsF;IACtF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA0BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAOpF;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/remoteRun/pairedRunners.js

@@ -0,0 +1,165 @@
+"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.PairedRunnerSetupError = void 0;
+exports.buildPairedSshOptions = buildPairedSshOptions;
+exports.getPairedRunnerPueue = getPairedRunnerPueue;
+exports.buildPairedRunnerConfig = buildPairedRunnerConfig;
+exports.loadPairedRunners = loadPairedRunners;
+exports.resetPairedRunnersCache = resetPairedRunnersCache;
+const path = __importStar(require("path"));
+const configDirFile_1 = require("../configDirFile");
+const runnerHome_1 = require("../runnerUtility/runnerHome");
+const hubPaths_1 = require("../runners/hubPaths");
+const hubRegistry_1 = require("../runners/hubRegistry");
+const ssh_1 = require("./ssh");
+/**
+ * @description Paired runners as `remote-run` sees them: the same `RunnerConfig` an entry of `runners.json` gives, built from the hub's
+ * registry (`paired.json`, `src/runners/`), so everything above the ssh layer — the script upload, rsync, Pueue, the lease — is phase 1
+ * unchanged. Only the way ssh reaches the machine differs: no host and port, but a `ProxyCommand` that joins ssh to the unix socket of
+ * the runner's link (`charness runner-proxy`), the runner's host key pinned under an alias from the hub's own `known_hosts`, and the
+ * hub's key. Nothing here talks to the network or to the runner; whether the link is up is `linkControl.ts`'s question.
+ */
+/** @description A path this machine's registry or program lives in cannot be put on an ssh command line; the runner stays out of the catalog, with the reason. */
+class PairedRunnerSetupError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PairedRunnerSetupError';
+    }
+}
+exports.PairedRunnerSetupError = PairedRunnerSetupError;
+/** @description `value` as an ssh path, or a {@link PairedRunnerSetupError} naming what it is the path of. */
+function getUsableSshPath(value, what) {
+    if (!(0, ssh_1.checkIsSshPathQuotable)(value))
+        throw new PairedRunnerSetupError(`the path of ${what} holds a quote, a backslash, a $ or a line break, which ssh cannot be given safely`);
+    return value;
+}
+/**
+ * One word of the `ProxyCommand` (run by the user's shell): plain words stay as they are, anything else is double-quoted. No single quote
+ * ever appears in the result — `buildRsyncSshCommand` wraps the whole option in single quotes for rsync's `-e`, whose parser has no way to
+ * nest them.
+ */
+function quoteProxyWord(word, what) {
+    return (0, ssh_1.checkIsPlainShellWord)(getUsableSshPath(word, what)) ? word : `"${word}"`;
+}
+/**
+ * @description The ssh options of every call to a paired runner (the operator's `-F /dev/null` stands in for a config file: the machine's
+ * own ssh config must not change how the link is reached). The host key is checked strictly against the one the runner gave at pairing.
+ */
+function buildPairedSshOptions(input) {
+    const files = (0, hubPaths_1.getHubFilePaths)(input.hubDir);
+    const socketPath = (0, hubPaths_1.getRunnerLinkPaths)(input.hubDir, input.runnerId).socket;
+    const proxyCommand = [quoteProxyWord(input.nodePath, 'node'), quoteProxyWord(input.cliPath, 'the charness cli'), 'runner-proxy', quoteProxyWord(socketPath, 'the runner link')].join(' ');
+    return [
+        '-F', '/dev/null',
+        '-o', `ProxyCommand=${(0, ssh_1.escapeSshTokens)(proxyCommand)}`,
+        '-o', `HostKeyAlias=${(0, hubPaths_1.getRunnerHostAlias)(input.runnerId)}`,
+        '-o', `UserKnownHostsFile=${(0, ssh_1.quoteSshOptionPath)((0, ssh_1.escapeSshTokens)(getUsableSshPath(files.knownHosts, 'the hub known_hosts')))}`,
+        '-o', 'GlobalKnownHostsFile=/dev/null',
+        '-o', 'StrictHostKeyChecking=yes',
+        '-i', (0, ssh_1.escapeSshTokens)(getUsableSshPath(files.hubKey, 'the hub key')),
+        '-o', 'IdentitiesOnly=yes',
+        '-o', 'IdentityAgent=none',
+        '-o', 'LogLevel=ERROR',
+    ];
+}
+/**
+ * @description Where the runner's Pueue lives, from the work dir it reported: the runner utility keeps `work/`, `bin/` and `pueue/` side by
+ * side in `~/.charness-runner/` (`runnerHome.ts` is the one place that layout is written down). A work dir that does not follow it gives
+ * `undefined` — the runner script then finds Pueue on the `PATH` as for any hand-made runner.
+ */
+function getPairedRunnerPueue(workDir) {
+    const stateRoot = path.posix.dirname(workDir);
+    const homeDir = path.posix.dirname(stateRoot);
+    const paths = (0, runnerHome_1.getRunnerHomePaths)(homeDir);
+    if (paths.workDir !== workDir)
+        return undefined;
+    return { bin: path.posix.join(paths.binDir, 'pueue'), config: paths.pueueConfig };
+}
+/** @description The `RunnerConfig` of one registry entry. Throws a {@link PairedRunnerSetupError} when the paths of this machine cannot be put on an ssh command line. */
+function buildPairedRunnerConfig(runner, hub) {
+    const link = { runnerId: runner.id, hubDir: hub.hubDir, isPausedByHub: runner.isPaused, os: runner.os };
+    return {
+        name: runner.name,
+        ssh: (0, hubPaths_1.getRunnerHostAlias)(runner.id),
+        sshOptions: buildPairedSshOptions({ runnerId: runner.id, nodePath: hub.nodePath, cliPath: hub.cliPath, hubDir: hub.hubDir }),
+        workDir: runner.workDir,
+        pueue: getPairedRunnerPueue(runner.workDir),
+        paired: link,
+    };
+}
+const pairedFileLoader = (0, configDirFile_1.createConfigFileLoader)({
+    fileName: 'paired.json',
+    createEmpty: () => ({ rev: 0, runners: [] }),
+    validate: (parsedJson) => {
+        const parsed = hubRegistry_1.pairedFileSchema.safeParse(parsedJson);
+        if (parsed.success)
+            return { ok: true, config: parsed.data };
+        return { ok: false, errors: parsed.error.issues.map((issue) => `paired.json ${issue.path.join('.') || '(root)'}: ${issue.message}`) };
+    },
+});
+function buildRunners(file, hub) {
+    const runners = [];
+    const errors = [];
+    for (const entry of file.runners) {
+        try {
+            runners.push(buildPairedRunnerConfig(entry, hub));
+        }
+        catch (error) {
+            if (!(error instanceof PairedRunnerSetupError))
+                throw error;
+            errors.push(`paired runner "${entry.name}": ${error.message}`);
+        }
+    }
+    return { runners, errors };
+}
+/**
+ * @description The paired runners of the user whose home is `homeDir`, from `paired.json` (stamp-cached like `runners.json`: the bot MCP
+ * asks on every connect). Missing = none paired; invalid = its errors and the last good list of this process, if any.
+ */
+function loadPairedRunners(homeDir) {
+    const context = (0, hubPaths_1.createHubContext)({ homeDir });
+    const hub = { hubDir: context.dir, nodePath: context.nodePath, cliPath: context.cliPath };
+    const load = pairedFileLoader.load((0, hubPaths_1.getHubFilePaths)(context.dir).paired);
+    if (load.status === 'invalid')
+        return { status: 'invalid', config: load.config === null ? null : buildRunners(load.config, hub), errors: load.errors };
+    const built = buildRunners(load.config, hub);
+    return built.errors.length === 0 ? { status: load.status, config: built } : { status: 'invalid', config: built, errors: built.errors };
+}
+/** @description Forget the cached loads (tests that swap files under one path). */
+function resetPairedRunnersCache() {
+    pairedFileLoader.resetCache();
+}
+//# sourceMappingURL=pairedRunners.js.map

package/dist/remoteRun/pairedRunners.js.map

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

package/dist/remoteRun/pathPatterns.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @description The ONE definition of what a path pattern of `.remote-run` (`pull:`, `exclude:`, `send:`, `install-key:`) means, as
+ * extended regular expressions: the main box applies them with `RegExp` and the runner script with bash's `=~` over the very same
+ * strings, so the two can never disagree about which files a pattern names.
+ *
+ * A pattern is relative to the project root. `*` is any run of characters inside one path segment, `?` one character, `**` a whole
+ * segment of any depth (`**` + `/` before a name, `/` + `**` at the end). A pattern names a file OR a directory: a directory brings
+ * everything below it (`test-results` is `test-results/a/b.png` too). Nothing floats: `snapshots` is the folder at the root only,
+ * `**` + `/snapshots` any `snapshots` folder.
+ */
+/** @description Why `pattern` cannot be used, or `null` when it can: not empty, relative, inside the project, no control characters. */
+export declare function getPathPatternProblem(pattern: string): string | null;
+/** @description The extended regular expression (anchored) a project-relative path must match to be named by `pattern`. */
+export declare function compilePathPattern(pattern: string): string;
+/** @description The compiled expressions of `patterns`, in order (the form the runner script receives, one per line). */
+export declare function compilePathPatterns(patterns: readonly string[]): string[];
+/** The root every path of the project lies under. */
+export declare const projectSearchRoot = ".";
+/**
+ * @description The folder a walk must start from to find every path `pattern` names: its leading segments that hold no `*`, `?` or `**`
+ * (`e2e/artifacts` → itself, `test-results/**` + `/*.xml` → `test-results`, `**` + `/*.png` → `.`). A fully literal pattern is its own root: a file or
+ * a folder, either is found from there.
+ */
+export declare function getPathPatternSearchRoot(pattern: string): string;
+/**
+ * @description The folders to walk to find what any of `patterns` names, without the ones another root already covers; just `.` as soon
+ * as one pattern starts with a wildcard (that one needs the whole tree). The runner walks these instead of the whole copy, which holds
+ * `node_modules` and every build folder.
+ */
+export declare function getPathPatternSearchRoots(patterns: readonly string[]): string[];
+/** @description A predicate over project-relative paths: does any of `patterns` name it? No pattern names nothing. */
+export declare function createPathMatcher(patterns: readonly string[]): (relativePath: string) => boolean;
+//# sourceMappingURL=pathPatterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathPatterns.d.ts","sourceRoot":"","sources":["../../src/remoteRun/pathPatterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,wIAAwI;AACxI,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpE;AAED,2HAA2H;AAC3H,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED,yHAAyH;AACzH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAEzE;AAED,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAI/E;AAED,sHAAsH;AACtH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAGhG"}

package/dist/remoteRun/pathPatterns.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * @description The ONE definition of what a path pattern of `.remote-run` (`pull:`, `exclude:`, `send:`, `install-key:`) means, as
+ * extended regular expressions: the main box applies them with `RegExp` and the runner script with bash's `=~` over the very same
+ * strings, so the two can never disagree about which files a pattern names.
+ *
+ * A pattern is relative to the project root. `*` is any run of characters inside one path segment, `?` one character, `**` a whole
+ * segment of any depth (`**` + `/` before a name, `/` + `**` at the end). A pattern names a file OR a directory: a directory brings
+ * everything below it (`test-results` is `test-results/a/b.png` too). Nothing floats: `snapshots` is the folder at the root only,
+ * `**` + `/snapshots` any `snapshots` folder.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectSearchRoot = void 0;
+exports.getPathPatternProblem = getPathPatternProblem;
+exports.compilePathPattern = compilePathPattern;
+exports.compilePathPatterns = compilePathPatterns;
+exports.getPathPatternSearchRoot = getPathPatternSearchRoot;
+exports.getPathPatternSearchRoots = getPathPatternSearchRoots;
+exports.createPathMatcher = createPathMatcher;
+const regexSpecialCharacters = /[.[\]{}()*+?|^$\\]/g;
+const anyDepthPrefix = '(.*/)?';
+const anyDepthSuffix = '.*';
+const singleSegmentRun = '[^/]*';
+const singleCharacter = '[^/]';
+/** Control characters (a newline would split the pattern file the runner reads one pattern per line). */
+const controlCharacters = /[\x00-\x1f\x7f]/;
+function escapeLiteral(text) {
+    return text.replace(regexSpecialCharacters, '\\$&');
+}
+/** The parts of a pattern between slashes, without `./` prefixes, trailing slashes or empty parts; consecutive `**` parts are one (they mean the same, and nested any-depth groups backtrack badly). */
+function splitPatternSegments(pattern) {
+    const segments = pattern.replace(/^(\.\/)+/, '').replace(/\/+$/, '').split('/').filter((segment) => segment !== '' && segment !== '.');
+    return segments.filter((segment, index) => !(segment === '**' && segments[index - 1] === '**'));
+}
+/** @description Why `pattern` cannot be used, or `null` when it can: not empty, relative, inside the project, no control characters. */
+function getPathPatternProblem(pattern) {
+    if (pattern.trim() === '')
+        return 'is empty';
+    if (controlCharacters.test(pattern))
+        return 'holds a control character';
+    if (pattern.startsWith('/'))
+        return 'must be relative to the project root, not absolute';
+    if (pattern.startsWith('~'))
+        return 'must be relative to the project root, not start with ~';
+    if (pattern.split('/').includes('..'))
+        return 'must stay inside the project (no ".." part)';
+    if (splitPatternSegments(pattern).length === 0)
+        return 'names no path (name a file or a folder of the project)';
+    return null;
+}
+/** @description The extended regular expression (anchored) a project-relative path must match to be named by `pattern`. */
+function compilePathPattern(pattern) {
+    const problem = getPathPatternProblem(pattern);
+    if (problem !== null)
+        throw new Error(`a path pattern ${problem}`);
+    const segments = splitPatternSegments(pattern);
+    let source = '';
+    segments.forEach((segment, index) => {
+        const isLast = index === segments.length - 1;
+        if (segment === '**') {
+            source += isLast ? anyDepthSuffix : anyDepthPrefix;
+            return;
+        }
+        let escaped = '';
+        for (const character of segment) {
+            if (character === '*')
+                escaped += singleSegmentRun;
+            else if (character === '?')
+                escaped += singleCharacter;
+            else
+                escaped += escapeLiteral(character);
+        }
+        source += isLast ? escaped : `${escaped}/`;
+    });
+    // A trailing `**` already ends in `.*` after a slash; a trailing name may be a directory with files below it.
+    const needsDirectoryTail = segments[segments.length - 1] !== '**';
+    return `^${source}${needsDirectoryTail ? '(/.*)?' : ''}$`;
+}
+/** @description The compiled expressions of `patterns`, in order (the form the runner script receives, one per line). */
+function compilePathPatterns(patterns) {
+    return patterns.map(compilePathPattern);
+}
+/** The root every path of the project lies under. */
+exports.projectSearchRoot = '.';
+/**
+ * @description The folder a walk must start from to find every path `pattern` names: its leading segments that hold no `*`, `?` or `**`
+ * (`e2e/artifacts` → itself, `test-results/**` + `/*.xml` → `test-results`, `**` + `/*.png` → `.`). A fully literal pattern is its own root: a file or
+ * a folder, either is found from there.
+ */
+function getPathPatternSearchRoot(pattern) {
+    const fixedSegments = [];
+    for (const segment of splitPatternSegments(pattern)) {
+        if (segment.includes('*') || segment.includes('?'))
+            break;
+        fixedSegments.push(segment);
+    }
+    return fixedSegments.length === 0 ? exports.projectSearchRoot : fixedSegments.join('/');
+}
+/**
+ * @description The folders to walk to find what any of `patterns` names, without the ones another root already covers; just `.` as soon
+ * as one pattern starts with a wildcard (that one needs the whole tree). The runner walks these instead of the whole copy, which holds
+ * `node_modules` and every build folder.
+ */
+function getPathPatternSearchRoots(patterns) {
+    const roots = [...new Set(patterns.map(getPathPatternSearchRoot))];
+    if (roots.includes(exports.projectSearchRoot))
+        return [exports.projectSearchRoot];
+    return roots.filter((root) => !roots.some((other) => other !== root && root.startsWith(`${other}/`)));
+}
+/** @description A predicate over project-relative paths: does any of `patterns` name it? No pattern names nothing. */
+function createPathMatcher(patterns) {
+    const expressions = compilePathPatterns(patterns).map((source) => new RegExp(source));
+    return (relativePath) => expressions.some((expression) => expression.test(relativePath));
+}
+//# sourceMappingURL=pathPatterns.js.map

package/dist/remoteRun/pathPatterns.js.map

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