charness 3.6.0 → 3.7.0

package/dist/remoteRun/project.js.map

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

package/dist/remoteRun/projectConfig.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @description `.remote-run` in the project root: what a project tells remote-run about itself. Optional; `key: value` lines, `#`
+ * starts a comment at the start of a line or after whitespace, blank lines are ignored. An unknown key or a bad value is an error
+ * that names the line.
+ *
+ *   pull: e2e/artifacts test-results                    files that come back (only what the job created or changed)
+ *   install: yarn install --immutable                   replaces the detected dependencies command; `install: none` turns the step off
+ *   install-key: yarn.lock package.json patches         what the dependencies step is keyed on (replaces the default)
+ *   exclude: fixtures/huge                              more paths that are never sent
+ *   send: .env.test                                     secret-looking files that ARE sent (also when git ignores them)
+ *
+ * The list keys (`pull`, `exclude`, `send`, `install-key`) take whitespace-separated patterns (`pathPatterns.ts`) and may repeat;
+ * `install` and `install-key` may each appear once.
+ */
+/** The value of `install:` that turns the dependencies step off. */
+export declare const installNone = "none";
+export interface ProjectConfig {
+    pull: string[];
+    /** The command, `none` for no step, `null` when the file says nothing (the lockfile's default applies). */
+    install: string | null;
+    /** The patterns the dependencies step is keyed on; `null` = the default key set. */
+    installKey: string[] | null;
+    exclude: string[];
+    send: string[];
+}
+export type ProjectConfigParse = {
+    ok: true;
+    config: ProjectConfig;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function createEmptyProjectConfig(): ProjectConfig;
+/** @description The file name, for messages. */
+export declare const projectConfigName = ".remote-run";
+/** @description Parse the text of a `.remote-run`; every problem is reported (not just the first), each naming its line. */
+export declare function parseProjectConfig(text: string): ProjectConfigParse;
+//# sourceMappingURL=projectConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectConfig.d.ts","sourceRoot":"","sources":["../../src/remoteRun/projectConfig.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,oEAAoE;AACpE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2GAA2G;IAC3G,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMvG,wBAAgB,wBAAwB,IAAI,aAAa,CAExD;AAED,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,gBAAwB,CAAC;AAEvD,4HAA4H;AAC5H,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAiDnE"}

package/dist/remoteRun/projectConfig.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectConfigName = exports.installNone = void 0;
+exports.createEmptyProjectConfig = createEmptyProjectConfig;
+exports.parseProjectConfig = parseProjectConfig;
+const pathPatterns_1 = require("./pathPatterns");
+/**
+ * @description `.remote-run` in the project root: what a project tells remote-run about itself. Optional; `key: value` lines, `#`
+ * starts a comment at the start of a line or after whitespace, blank lines are ignored. An unknown key or a bad value is an error
+ * that names the line.
+ *
+ *   pull: e2e/artifacts test-results                    files that come back (only what the job created or changed)
+ *   install: yarn install --immutable                   replaces the detected dependencies command; `install: none` turns the step off
+ *   install-key: yarn.lock package.json patches         what the dependencies step is keyed on (replaces the default)
+ *   exclude: fixtures/huge                              more paths that are never sent
+ *   send: .env.test                                     secret-looking files that ARE sent (also when git ignores them)
+ *
+ * The list keys (`pull`, `exclude`, `send`, `install-key`) take whitespace-separated patterns (`pathPatterns.ts`) and may repeat;
+ * `install` and `install-key` may each appear once.
+ */
+/** The value of `install:` that turns the dependencies step off. */
+exports.installNone = 'none';
+const projectConfigFileName = '.remote-run';
+const listKeys = ['pull', 'exclude', 'send', 'install-key'];
+const commentPattern = /(^|\s)#.*$/;
+function createEmptyProjectConfig() {
+    return { pull: [], install: null, installKey: null, exclude: [], send: [] };
+}
+/** @description The file name, for messages. */
+exports.projectConfigName = projectConfigFileName;
+/** @description Parse the text of a `.remote-run`; every problem is reported (not just the first), each naming its line. */
+function parseProjectConfig(text) {
+    const config = createEmptyProjectConfig();
+    const errors = [];
+    const seenKeys = new Set();
+    text.split(/\r?\n/).forEach((rawLine, index) => {
+        const lineNumber = index + 1;
+        const line = rawLine.replace(commentPattern, '$1').trim();
+        if (line === '')
+            return;
+        const separator = line.indexOf(':');
+        if (separator <= 0) {
+            errors.push(`${projectConfigFileName} line ${lineNumber}: expected "key: value"`);
+            return;
+        }
+        const key = line.slice(0, separator).trim();
+        const value = line.slice(separator + 1).trim();
+        const fail = (message) => {
+            errors.push(`${projectConfigFileName} line ${lineNumber}: ${message}`);
+        };
+        if (key !== 'install' && !listKeys.some((listKey) => listKey === key)) {
+            fail(`unknown key "${key}" (known: pull, install, install-key, exclude, send)`);
+            return;
+        }
+        if ((key === 'install' || key === 'install-key') && seenKeys.has(key)) {
+            fail(`"${key}" is given twice`);
+            return;
+        }
+        seenKeys.add(key);
+        if (value === '') {
+            fail(`"${key}" has no value`);
+            return;
+        }
+        if (key === 'install') {
+            config.install = value;
+            return;
+        }
+        const patterns = value.split(/\s+/);
+        for (const pattern of patterns) {
+            const problem = (0, pathPatterns_1.getPathPatternProblem)(pattern);
+            if (problem !== null) {
+                fail(`"${key}" pattern ${problem}`);
+                return;
+            }
+        }
+        if (key === 'install-key')
+            config.installKey = patterns;
+        else if (key === 'pull')
+            config.pull.push(...patterns);
+        else if (key === 'exclude')
+            config.exclude.push(...patterns);
+        else
+            config.send.push(...patterns);
+    });
+    return errors.length === 0 ? { ok: true, config } : { ok: false, errors };
+}
+//# sourceMappingURL=projectConfig.js.map

package/dist/remoteRun/projectConfig.js.map

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

package/dist/remoteRun/remoteRunCli.d.ts

@@ -0,0 +1,15 @@
+import type { CliIo } from './output';
+/**
+ * @description `charness remote-run …` — send a command to a runner (a machine reached by ordinary ssh, listed in
+ * `~/.config/charness/runners.json`) and get its output, exit code and declared result files back as if it had run here. The
+ * contracts are in `src/remoteRun/README.md`; the user-facing description is `docs/remote-run.md`.
+ *
+ * The CLI loads NO env file (it would read the PROJECT's `.env`: agents run it from project folders) and never touches `DATA_DIR` or
+ * the state store: it needs nothing from an instance.
+ */
+export declare const remoteRunUsage = "Usage:\n  charness remote-run [--runner <name>] [--needs android|ios|docker|playwright] [--group <g>] [--timeout <dur>]\n                      [--with-git] [-e NAME=VALUE]\u2026 [--bg] <command\u2026>\n                              run <command> on a runner, in the same folder of a copy of this git project;\n                              output and exit code come back, interrupt or timeout kills the remote job.\n                              --bg prints a job id and returns (long runs).\n                              Options go BEFORE the command; a command that starts with a subcommand name goes after --\n  charness remote-run runners                 the runners: online, hardware, load, what each can do\n  charness remote-run ls [--all]              jobs of this project (all projects with --all)\n  charness remote-run status <id>             one job\n  charness remote-run logs <id> [-f] [--tail N]\n  charness remote-run wait <id>               block until the job ends, fetch its files, exit with its code\n  charness remote-run kill <id>\n  charness remote-run fetch <id>              bring a finished job's result files back (again)\n  charness remote-run exec [--runner <name>] <command\u2026>\n                              one-off command in the runner's copy as the last job left it (no sync)\nExit codes: the command's own; 125 remote-run failed, 124 timeout, 130/143/129 interrupted (SIGINT/SIGTERM/SIGHUP), 137 job killed, 2 bad usage.\nSetup: docs/remote-run.md\n";
+/** @description The io of the real process. */
+export declare function createProcessIo(): CliIo;
+/** @description Run the command line (the words after `remote-run`); resolves with the exit code. */
+export declare function runRemoteRunCli(argv: readonly string[], io?: CliIo): Promise<number>;
+//# sourceMappingURL=remoteRunCli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remoteRunCli.d.ts","sourceRoot":"","sources":["../../src/remoteRun/remoteRunCli.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAMtC;;;;;;;GAOG;AAEH,eAAO,MAAM,cAAc,q9CAkB1B,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,eAAe,IAAI,KAAK,CAQvC;AAqBD,qGAAqG;AACrG,wBAAsB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,KAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC7G"}

package/dist/remoteRun/remoteRunCli.js

@@ -0,0 +1,144 @@
+"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.remoteRunUsage = void 0;
+exports.createProcessIo = createProcessIo;
+exports.runRemoteRunCli = runRemoteRunCli;
+const os = __importStar(require("os"));
+const commands_1 = require("./commands");
+const cliArgs_1 = require("./cliArgs");
+const exitCodes_1 = require("./exitCodes");
+const leaseTiming_1 = require("./leaseTiming");
+const remoteRunError_1 = require("./remoteRunError");
+const runnerClient_1 = require("./runnerClient");
+const runnersConfig_1 = require("./runnersConfig");
+const ssh_1 = require("./ssh");
+/**
+ * @description `charness remote-run …` — send a command to a runner (a machine reached by ordinary ssh, listed in
+ * `~/.config/charness/runners.json`) and get its output, exit code and declared result files back as if it had run here. The
+ * contracts are in `src/remoteRun/README.md`; the user-facing description is `docs/remote-run.md`.
+ *
+ * The CLI loads NO env file (it would read the PROJECT's `.env`: agents run it from project folders) and never touches `DATA_DIR` or
+ * the state store: it needs nothing from an instance.
+ */
+exports.remoteRunUsage = `Usage:
+  charness remote-run [--runner <name>] [--needs android|ios|docker|playwright] [--group <g>] [--timeout <dur>]
+                      [--with-git] [-e NAME=VALUE]… [--bg] <command…>
+                              run <command> on a runner, in the same folder of a copy of this git project;
+                              output and exit code come back, interrupt or timeout kills the remote job.
+                              --bg prints a job id and returns (long runs).
+                              Options go BEFORE the command; a command that starts with a subcommand name goes after --
+  charness remote-run runners                 the runners: online, hardware, load, what each can do
+  charness remote-run ls [--all]              jobs of this project (all projects with --all)
+  charness remote-run status <id>             one job
+  charness remote-run logs <id> [-f] [--tail N]
+  charness remote-run wait <id>               block until the job ends, fetch its files, exit with its code
+  charness remote-run kill <id>
+  charness remote-run fetch <id>              bring a finished job's result files back (again)
+  charness remote-run exec [--runner <name>] <command…>
+                              one-off command in the runner's copy as the last job left it (no sync)
+Exit codes: the command's own; 125 remote-run failed, 124 timeout, 130/143/129 interrupted (SIGINT/SIGTERM/SIGHUP), 137 job killed, 2 bad usage.
+Setup: docs/remote-run.md
+`;
+/** @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(),
+    };
+}
+function createContext(io) {
+    const load = (0, runnersConfig_1.loadRunnersConfig)(io.homeDir);
+    if (load.status === 'missing') {
+        throw new remoteRunError_1.RemoteRunError(`no runners are set up: ${(0, runnersConfig_1.getRunnersConfigPath)(io.homeDir)} does not exist (docs/remote-run.md explains how to add one)`);
+    }
+    if (load.status === 'invalid')
+        throw new remoteRunError_1.RemoteRunError(load.errors.join('\n'));
+    if (load.config.runners.length === 0)
+        throw new remoteRunError_1.RemoteRunError(`${(0, runnersConfig_1.getRunnersConfigPath)(io.homeDir)} lists no runners`);
+    const cacheDir = (0, ssh_1.getRemoteRunCacheDir)(io.env, io.homeDir);
+    (0, ssh_1.ensureRemoteRunCacheDir)(cacheDir);
+    return {
+        io,
+        config: load.config,
+        cacheDir,
+        script: (0, runnerClient_1.readRunnerScript)(),
+        leaseMs: (0, leaseTiming_1.readRemoteRunLeaseMs)(io.env),
+        now: Date.now,
+    };
+}
+/** @description Run the command line (the words after `remote-run`); resolves with the exit code. */
+async function runRemoteRunCli(argv, io = createProcessIo()) {
+    const parsed = (0, cliArgs_1.parseRemoteRunArgs)(argv);
+    if (!parsed.ok) {
+        io.stderr(`remote-run: ${parsed.error}\n\n${exports.remoteRunUsage}`);
+        return exitCodes_1.remoteRunExitCodes.usage;
+    }
+    const { command } = parsed;
+    if (command.kind === 'help') {
+        if (argv.length === 0) {
+            io.stderr(exports.remoteRunUsage);
+            return exitCodes_1.remoteRunExitCodes.usage;
+        }
+        io.stdout(exports.remoteRunUsage);
+        return 0;
+    }
+    try {
+        const context = createContext(io);
+        switch (command.kind) {
+            case 'run': return await (0, commands_1.runRunCommand)(command, context);
+            case 'runners': return await (0, commands_1.runRunnersCommand)(context);
+            case 'ls': return await (0, commands_1.runLsCommand)(command, context);
+            case 'status': return await (0, commands_1.runStatusCommand)(command, context);
+            case 'logs': return await (0, commands_1.runLogsCommand)(command, context);
+            case 'wait': return await (0, commands_1.runWaitCommand)(command, context);
+            case 'fetch': return await (0, commands_1.runFetchCommand)(command, context);
+            case 'kill': return await (0, commands_1.runKillCommand)(command, context);
+            case 'exec': return await (0, commands_1.runExecCommand)(command, context);
+        }
+    }
+    catch (error) {
+        if (error instanceof remoteRunError_1.RemoteRunError) {
+            io.stderr(`remote-run: ${error.message}\n`);
+            return error.exitCode;
+        }
+        io.stderr(`remote-run: unexpected error: ${error instanceof Error ? error.message : 'unknown'}\n`);
+        return exitCodes_1.remoteRunExitCodes.failed;
+    }
+}
+//# sourceMappingURL=remoteRunCli.js.map

package/dist/remoteRun/remoteRunCli.js.map

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

package/dist/remoteRun/remoteRunError.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @description A failure remote-run reports as its own (never the command's): the message goes to stderr, the exit code is the
+ * given one (125 unless the cause is a usage mistake or a timeout).
+ */
+export declare class RemoteRunError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+/** @description The runner could not be reached (ssh failed before the script ran): `reason` is the short ssh-side cause the `runners` view shows. */
+export declare class RunnerUnreachableError extends RemoteRunError {
+    readonly reason: string;
+    constructor(runnerName: string, reason: string);
+}
+//# sourceMappingURL=remoteRunError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remoteRunError.d.ts","sourceRoot":"","sources":["../../src/remoteRun/remoteRunError.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkC;CAK1E;AAED,sJAAsJ;AACtJ,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK/C"}

package/dist/remoteRun/remoteRunError.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunnerUnreachableError = exports.RemoteRunError = void 0;
+const exitCodes_1 = require("./exitCodes");
+/**
+ * @description A failure remote-run reports as its own (never the command's): the message goes to stderr, the exit code is the
+ * given one (125 unless the cause is a usage mistake or a timeout).
+ */
+class RemoteRunError extends Error {
+    exitCode;
+    constructor(message, exitCode = exitCodes_1.remoteRunExitCodes.failed) {
+        super(message);
+        this.name = 'RemoteRunError';
+        this.exitCode = exitCode;
+    }
+}
+exports.RemoteRunError = RemoteRunError;
+/** @description The runner could not be reached (ssh failed before the script ran): `reason` is the short ssh-side cause the `runners` view shows. */
+class RunnerUnreachableError extends RemoteRunError {
+    reason;
+    constructor(runnerName, reason) {
+        super(`runner "${runnerName}" is unreachable — ${reason}`);
+        this.name = 'RunnerUnreachableError';
+        this.reason = reason;
+    }
+}
+exports.RunnerUnreachableError = RunnerUnreachableError;
+//# sourceMappingURL=remoteRunError.js.map

package/dist/remoteRun/remoteRunError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteRunError.js","sourceRoot":"","sources":["../../src/remoteRun/remoteRunError.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AAEjD;;;GAGG;AACH,MAAa,cAAe,SAAQ,KAAK;IAC9B,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,WAAmB,8BAAkB,CAAC,MAAM;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AARD,wCAQC;AAED,sJAAsJ;AACtJ,MAAa,sBAAuB,SAAQ,cAAc;IAC/C,MAAM,CAAS;IAExB,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CAAC,WAAW,UAAU,sBAAsB,MAAM,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AARD,wDAQC"}

package/dist/remoteRun/rsync.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @description `rsync` as a spawned process with a deadline. Exit 24 ("some source files vanished", a file edited while it was being
+ * sent) is not a failure: the next submit sends the new state. The ssh half is the `-e` command the caller built.
+ */
+/** A first send of a large project is the slowest thing remote-run does. */
+export declare const syncTimeoutMs: number;
+export interface RsyncResult {
+    isOk: boolean;
+    /** The last of rsync's stderr, for a message. */
+    errorTail: string;
+}
+/** @description Run rsync with `args`, `input` on its stdin (the NUL-separated file list). */
+export declare function runRsync(args: readonly string[], options?: {
+    input?: string;
+    timeoutMs?: number;
+}): Promise<RsyncResult>;
+//# sourceMappingURL=rsync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rsync.d.ts","sourceRoot":"","sources":["../../src/remoteRun/rsync.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,aAAa,QAAiB,CAAC;AAI5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAuB5H"}

package/dist/remoteRun/rsync.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncTimeoutMs = void 0;
+exports.runRsync = runRsync;
+const child_process_1 = require("child_process");
+/**
+ * @description `rsync` as a spawned process with a deadline. Exit 24 ("some source files vanished", a file edited while it was being
+ * sent) is not a failure: the next submit sends the new state. The ssh half is the `-e` command the caller built.
+ */
+/** A first send of a large project is the slowest thing remote-run does. */
+exports.syncTimeoutMs = 30 * 60 * 1000;
+const rsyncVanishedFilesExitCode = 24;
+const stderrTailLength = 600;
+/** @description Run rsync with `args`, `input` on its stdin (the NUL-separated file list). */
+function runRsync(args, options = {}) {
+    return new Promise((resolve) => {
+        const child = (0, child_process_1.spawn)('rsync', [...args], { stdio: ['pipe', 'ignore', 'pipe'] });
+        let stderr = '';
+        let isTimedOut = false;
+        const timer = setTimeout(() => {
+            isTimedOut = true;
+            child.kill('SIGKILL');
+        }, options.timeoutMs ?? exports.syncTimeoutMs);
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => { stderr += chunk; });
+        child.stdin.on('error', () => { });
+        child.on('error', (error) => {
+            clearTimeout(timer);
+            resolve({ isOk: false, errorTail: `could not start rsync: ${error.message}` });
+        });
+        child.on('close', (exitCode) => {
+            clearTimeout(timer);
+            const isOk = exitCode === 0 || exitCode === rsyncVanishedFilesExitCode;
+            resolve({ isOk, errorTail: isTimedOut ? 'rsync ran past its deadline' : stderr.trim().slice(-stderrTailLength) });
+        });
+        child.stdin.end(options.input ?? '');
+    });
+}
+//# sourceMappingURL=rsync.js.map

package/dist/remoteRun/rsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsync.js","sourceRoot":"","sources":["../../src/remoteRun/rsync.ts"],"names":[],"mappings":";;;AAmBA,4BAuBC;AA1CD,iDAAsC;AAEtC;;;GAGG;AAEH,4EAA4E;AAC/D,QAAA,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC5C,MAAM,0BAA0B,GAAG,EAAE,CAAC;AACtC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAQ7B,8FAA8F;AAC9F,SAAgB,QAAQ,CAAC,IAAuB,EAAE,UAAkD,EAAE;IACpG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/E,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,UAAU,GAAG,IAAI,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,qBAAa,CAAC,CAAC;QACvC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAmD,CAAC,CAAC,CAAC;QACnF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,0BAA0B,CAAC;YACvE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACpH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/remoteRun/runnerClient.d.ts

@@ -0,0 +1,50 @@
+import type { RunnerConfig } from './runnersConfig';
+import { spawnSshStream, type SshRunResult } from './ssh';
+/** An ordinary call: a prepare may start the Pueue daemon, a result or a kill is quicker. */
+export declare const shortCallTimeoutMs: number;
+export interface RunnerScript {
+    /** `runner-<sha8>.sh` */
+    name: string;
+    text: string;
+}
+/** @description `remoteRun/runner.sh` at the package root, resolved from both `src/remoteRun` (tsx) and `dist/remoteRun` (built): two levels up. */
+export declare function getRunnerScriptPath(): string;
+export declare function readRunnerScript(scriptPath?: string): RunnerScript;
+export interface RunnerClient {
+    readonly runner: RunnerConfig;
+    readonly cacheDir: string;
+    /** The `-e` command of rsync for this runner. */
+    readonly rsyncSshCommand: string;
+    /**
+     * Upload the script when the runner does not have this version; throws a {@link RunnerUnreachableError} when the runner cannot be
+     * reached. `signal` ends the ssh calls it makes from outside (a shared deadline).
+     */
+    ensureScript: (signal?: AbortSignal) => Promise<void>;
+    /** The runner's work dir as an absolute path (a configured `~/…` is resolved on the runner once). */
+    getAbsoluteWorkDir: () => Promise<string>;
+    /** One subcommand of the script; never throws for a non-zero exit (the caller reads it). */
+    call: (subcommand: string, args: readonly string[], options?: {
+        input?: string;
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }) => Promise<SshRunResult>;
+    /** The same, but a non-zero exit or a timeout is a {@link RemoteRunError} carrying the runner's own message. */
+    callOrThrow: (subcommand: string, args: readonly string[], options?: {
+        input?: string;
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }) => Promise<string>;
+    /** The long-lived form: a spawned ssh whose streams the caller handles. */
+    stream: (subcommand: string, args: readonly string[]) => ReturnType<typeof spawnSshStream>;
+}
+/**
+ * @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
+ * that has none) says what that means and the way out: a key that is only held by an agent works for a Telegram agent and not for that one.
+ */
+export declare function describeSshFailure(result: SshRunResult, env?: NodeJS.ProcessEnv): string;
+/** @description The runner script's own refusal in a stderr text («remote-run-runner: no such job: x» → «no such job: x»): the last line, without the script's prefix. */
+export declare function describeRunnerRefusal(stderr: string, fallback: string): string;
+/** @description Create the client of `runner`. `script` and the spawn functions are injectable for the tests. */
+export declare function createRunnerClient(runner: RunnerConfig, cacheDir: string, script?: RunnerScript): RunnerClient;
+//# sourceMappingURL=runnerClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runnerClient.d.ts","sourceRoot":"","sources":["../../src/remoteRun/runnerClient.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAOL,cAAc,EACd,KAAK,YAAY,EAClB,MAAM,OAAO,CAAC;AAUf,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAG5C,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oJAAoJ;AACpJ,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,MAA8B,GAAG,YAAY,CAGzF;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,qGAAqG;IACrG,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACrJ,gHAAgH;IAChH,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtJ,2EAA2E;IAC3E,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;CAC5F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAYrG;AAED,0KAA0K;AAC1K,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED,iHAAiH;AACjH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiC,GAAG,YAAY,CA8ClI"}