charness 3.7.0 → 3.9.0

package/dist/runnerUtility/runnerCli.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * `charness-runner` — the program that attaches a machine to a charness hub as a runner (see `src/runners/README.md` for the hub side
+ * and `src/runnerUtility/README.md` for this one).
+ *
+ *   charness-runner                        what this account is attached to and what the link is doing (= `status`)
+ *   charness-runner pair <code>            attach this account with a pairing code (the line from /runners does it for you)
+ *   charness-runner run                    hold the link to the hub; Ctrl-C stops (a service does the same, see the pairing text)
+ *   charness-runner check                  look at this machine and install what a runner needs (Pueue, rsync)
+ *   charness-runner service install        keep it running without a terminal (see `serviceManager.ts`)
+ *   charness-runner pause | resume | unpair
+ *
+ * This file is the FIRST thing a pairing runs, from a package that has no `node_modules` yet (`pair --bootstrap <folder> <code>`,
+ * started by the pasted line): it imports Node built-ins only, installs the package's dependencies into a new app folder, and starts
+ * the installed copy to do the pairing. Everything else is loaded after that, on demand.
+ */
+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 });
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const appInstall_1 = require("./appInstall");
+const packageId_1 = require("./packageId");
+const pairArgs_1 = require("./pairArgs");
+const runnerHome_1 = require("./runnerHome");
+const usageExitCode = 2;
+const usage = `Usage:
+  charness-runner                    what this account is attached to and what the link is doing
+  charness-runner pair <code>        attach this account with a pairing code
+  charness-runner run                hold the link to the hub (Ctrl-C stops)
+  charness-runner check              look at this machine; install Pueue and rsync when they are missing
+  charness-runner service install    keep it running in the background (systemd user service on Linux, LaunchAgent on macOS)
+                                     (always on, also logged out: an admin pastes the admin line from /runners, see docs/remote-run.md)
+  charness-runner service uninstall  remove the services (an always-on one: prints the admin's commands)
+  charness-runner pause | resume     take this machine out of rotation, or back in
+  charness-runner unpair [--local]   tell the hub and forget the pairing (--local: forget it here only)
+`;
+/** The folder of the copy that is running: this file is `<app>/dist/runnerUtility/runnerCli.js`. */
+function getOwnAppDir() {
+    return path.resolve(__dirname, '..', '..');
+}
+/** `--bootstrap <folder> --archive <file> --package-id <id> [--service-follows] <code>` — what the pasted line passes. */
+function parseBootstrapArgs(args) {
+    const { rest: plainArgs, isServiceFollowing } = (0, pairArgs_1.splitServiceFollowsFlag)(args);
+    const [bootstrapFlag, bootstrapDir, archiveFlag, archivePath, idFlag, packageId, code, ...rest] = plainArgs;
+    if (bootstrapFlag !== '--bootstrap' || archiveFlag !== '--archive' || idFlag !== '--package-id' || rest.length > 0)
+        return null;
+    return bootstrapDir === undefined || archivePath === undefined || packageId === undefined || code === undefined ? null : { bootstrapDir, archivePath, packageId, code, isServiceFollowing };
+}
+/** `<code> [--package-id <id>] [--service-follows]` — `pair` from an installed copy. */
+function parsePairArgs(args) {
+    const { rest: plainArgs, isServiceFollowing } = (0, pairArgs_1.splitServiceFollowsFlag)(args);
+    const [code, flag, packageId, ...rest] = plainArgs;
+    if (code === undefined || rest.length > 0)
+        return null;
+    if (flag === undefined)
+        return { code, packageId: null, isServiceFollowing };
+    return flag === '--package-id' && packageId !== undefined && (0, packageId_1.checkIsPackageId)(packageId) ? { code, packageId, isServiceFollowing } : null;
+}
+function runBootstrap(args) {
+    const { bootstrapDir, archivePath, packageId, code, isServiceFollowing } = args;
+    // The archive is checked against the id the hub announced with it, and THAT id — not whatever the hub offers a moment later — is
+    // what the runner records as installed.
+    if (!(0, packageId_1.checkArchiveHasId)(archivePath, packageId)) {
+        process.stderr.write('charness-runner: the package that was downloaded is not the one the hub announced; run the line again\n');
+        return 1;
+    }
+    const paths = (0, runnerHome_1.getRunnerHomePaths)();
+    let appDir;
+    try {
+        appDir = (0, appInstall_1.installAppFromDirectory)(bootstrapDir, paths);
+    }
+    catch (error) {
+        process.stderr.write(`charness-runner: ${error instanceof Error ? error.message : 'could not install'}\n`);
+        return 1;
+    }
+    const installedCli = path.join(appDir, 'dist', 'runnerUtility', 'runnerCli.js');
+    const result = (0, child_process_1.spawnSync)(process.execPath, [installedCli, 'pair', code, '--package-id', packageId, ...(isServiceFollowing ? [pairArgs_1.serviceFollowsFlag] : [])], { stdio: 'inherit' });
+    const isCurrent = fs.existsSync(paths.currentApp) && fs.realpathSync(paths.currentApp) === fs.realpathSync(appDir);
+    if (!isCurrent)
+        fs.rmSync(appDir, { recursive: true, force: true });
+    return result.status ?? 1;
+}
+async function main() {
+    const [command = 'status', ...args] = process.argv.slice(2);
+    if (command === 'pair' && (0, pairArgs_1.splitServiceFollowsFlag)(args).rest[0] === '--bootstrap') {
+        const bootstrapArgs = parseBootstrapArgs(args);
+        if (bootstrapArgs === null) {
+            process.stderr.write(usage);
+            return usageExitCode;
+        }
+        return runBootstrap(bootstrapArgs);
+    }
+    const io = { stdout: (text) => { process.stdout.write(text); }, stderr: (text) => { process.stderr.write(text); } };
+    switch (command) {
+        case 'pair': {
+            const pairArgs = parsePairArgs(args);
+            if (pairArgs === null) {
+                process.stderr.write(usage);
+                return usageExitCode;
+            }
+            const { runPair } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runPair(pairArgs.code, getOwnAppDir(), pairArgs.packageId, io, os.homedir(), { isServiceFollowing: pairArgs.isServiceFollowing });
+        }
+        case 'run': {
+            const { runLink } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runLink(io, getOwnAppDir());
+        }
+        case 'status': {
+            const { runStatus } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runStatus(io);
+        }
+        case 'check': {
+            const { runCheck } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runCheck(io);
+        }
+        case 'service': {
+            const { runService } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runService(args, io);
+        }
+        case 'pause':
+        case 'resume': {
+            const { runPause } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runPause(command === 'pause', io);
+        }
+        case 'unpair': {
+            if (args.length > 1 || (args.length === 1 && args[0] !== '--local')) {
+                process.stderr.write(usage);
+                return usageExitCode;
+            }
+            const { runUnpair } = await Promise.resolve().then(() => __importStar(require('./runnerCommands')));
+            return runUnpair({ isLocalOnly: args[0] === '--local' }, io);
+        }
+        case 'help':
+        case '--help':
+        case '-h':
+            process.stdout.write(usage);
+            return 0;
+        default:
+            process.stderr.write(`charness-runner: unknown command: ${command}\n\n${usage}`);
+            return usageExitCode;
+    }
+}
+// Only when this file IS the program (`charness-runner`, `node …/runnerCli.js`): importing it, as the self-check does, runs no command.
+if (require.main === module) {
+    main().then((code) => {
+        process.exitCode = code;
+        // `run` holds sockets, a Pueue probe and timers: it leaves by itself — also with the restart code after an update; every other command ends when its output is flushed.
+        if (process.argv[2] === 'run' || code === appInstall_1.restartExitCode)
+            process.exit(code);
+    }, (error) => {
+        process.stderr.write(`charness-runner: ${error.message}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=runnerCli.js.map

package/dist/runnerUtility/runnerCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerCli.js","sourceRoot":"","sources":["../../src/runnerUtility/runnerCli.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAA0C;AAC1C,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,6CAAwE;AACxE,2CAAkE;AAClE,yCAAyE;AACzE,6CAAkD;AAElD,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,KAAK,GAAG;;;;;;;;;;CAUb,CAAC;AAEF,oGAAoG;AACpG,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAWD,0HAA0H;AAC1H,SAAS,kBAAkB,CAAC,IAAuB;IACjD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAA,kCAAuB,EAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5G,IAAI,aAAa,KAAK,aAAa,IAAI,WAAW,KAAK,WAAW,IAAI,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChI,OAAO,YAAY,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC9L,CAAC;AAED,wFAAwF;AACxF,SAAS,aAAa,CAAC,IAAuB;IAC5C,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAA,kCAAuB,EAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC7E,OAAO,IAAI,KAAK,cAAc,IAAI,SAAS,KAAK,SAAS,IAAI,IAAA,4BAAgB,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5I,CAAC;AAED,SAAS,YAAY,CAAC,IAAmB;IACvC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAChF,iIAAiI;IACjI,wCAAwC;IACxC,IAAI,CAAC,IAAA,6BAAiB,EAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yGAAyG,CAAC,CAAC;QAChI,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,+BAAkB,GAAE,CAAC;IACnC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,oCAAuB,EAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAC3G,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,6BAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/K,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnH,IAAI,CAAC,SAAS;QAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,MAAM,IAAI,IAAA,kCAAuB,EAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;QAClF,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,OAAO,YAAY,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,IAAY,EAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAY,EAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChJ,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5B,OAAO,aAAa,CAAC;YACvB,CAAC;YACD,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACrD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC3I,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACrD,OAAO,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,SAAS,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACvD,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACxD,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,OAAO,KAAK,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;gBACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5B,OAAO,aAAa,CAAC;YACvB,CAAC;YACD,MAAM,EAAE,SAAS,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;YACvD,OAAO,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;YACjF,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,wIAAwI;AACxI,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE;QACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,wKAAwK;QACxK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,4BAAe;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC,EACD,CAAC,KAAY,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/runnerUtility/runnerCommands.d.ts

@@ -0,0 +1,76 @@
+import { type RedeemReply } from '../runners/gateProtocol';
+import { type HubEndpoint } from './hubClient';
+import { type ProcessControl } from './localLinkStop';
+import { type CommandRunner } from '../selfUpdate/commandRunner';
+import { type ServiceDeps } from './serviceManager';
+import { type RunnerHomePaths } from './runnerHome';
+import { type RunnerKeys } from './runnerKeys';
+/**
+ * @description The commands of `charness-runner` that need the installed package (and so its dependencies): `pair`, `run`, `status`,
+ * `check`. `runnerCli.ts` starts them only after the app is installed.
+ */
+export interface CommandIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+}
+/** @description The «Keep it running» part of the pairing text: the terminal, a service without admin, and — on a Mac — the admin line that makes it always on. */
+export declare function formatKeepRunningHelp(paths: RunnerHomePaths, platform?: NodeJS.Platform): string;
+export declare function formatRemovedMessage(label: string): string;
+/** @description What the pairing says in place of {@link formatKeepRunningHelp} when an admin's line installs the service next. */
+export declare function formatServiceFollowsNote(): string;
+export interface PairingOptions {
+    /** An admin's line installs the service right after this pairing (`pairArgs.ts`): no help about keeping it running is printed. */
+    isServiceFollowing: boolean;
+}
+export interface PairingOutcomeInputs {
+    endpoint: HubEndpoint;
+    keys: RunnerKeys;
+    reply: Extract<RedeemReply, {
+        ok: true;
+    }>;
+    /** The id of the archive this copy was installed from — NOT the hub's current package, which is only what is available now. */
+    packageId: string | null;
+    appDir: string;
+}
+/**
+ * @description `charness-runner pair <code>` (run from the INSTALLED copy): redeem the code, record who the runner serves, install its
+ * tools. A pairing that an earlier run left half done is recovered FIRST (with the runner's own key), whatever the new code is. Returns the exit code.
+ */
+export declare function runPair(code: string, appDir: string, packageId: string | null, io: CommandIo, homeDir?: string, options?: PairingOptions): Promise<number>;
+/** @description `charness-runner run`: ensure the tools and Pueue, then hold the link until stopped. Returns the exit code (75 = restart onto an update). */
+export declare function runLink(io: CommandIo, appDir: string, homeDir?: string): Promise<number>;
+/** @description `charness-runner status`. */
+export declare function runStatus(io: CommandIo, homeDir?: string, processControl?: ProcessControl): number;
+/** @description `charness-runner check`: the machine report and the tools, installing what is missing. */
+export declare function runCheck(io: CommandIo, homeDir?: string): Promise<number>;
+/** @description `charness-runner pause` / `resume`: take this machine out of rotation, or back in. */
+export declare function runPause(isPaused: boolean, io: CommandIo, homeDir?: string): number;
+/**
+ * @description `charness-runner service install|uninstall`, and the internal `service system-step prepare|abandon` (the account's side of
+ * the admin line's always-on install: one JSON line on stdout, see `serviceManager.ts`).
+ */
+export declare function runService(args: readonly string[], io: CommandIo, deps?: ServiceDeps): Promise<number>;
+export interface UnpairOptions {
+    /** Do not tell the hub (it is gone, or this machine cannot reach it). */
+    isLocalOnly: boolean;
+}
+export interface UnpairDeps {
+    service: ServiceDeps;
+    process: ProcessControl;
+    queueRunner: CommandRunner;
+}
+export declare function createUnpairDeps(): UnpairDeps;
+/**
+ * @description `charness-runner unpair`: forget the pairing — and make that true. In this order:
+ *   1. a system service (installed by an admin) is NOT touched from the account: unpair stops there and prints the admin command, because a
+ *      pairing cannot be forgotten under a running daemon that holds it;
+ *   2. the hub is told (it removes the key line and cuts the link) unless `--local`;
+ *   3. the link on this machine is STOPPED and checked to be gone — the user service removed (verified), a foreground `run` ended — since a
+ *      running link keeps the keys in memory and goes on serving the hub's commands whatever the files say;
+ *   4. the queue's jobs are stopped (this machine no longer serves that hub's agents);
+ *   5. only then `config.json`, the keys, the status, the pause and the iOS result are deleted. The installed program, the tools, the work
+ *      folder and the queue (now empty) stay.
+ * A step that fails stops the command with exit 1 and says what is left.
+ */
+export declare function runUnpair(options: UnpairOptions, io: CommandIo, homeDir?: string, deps?: UnpairDeps): Promise<number>;
+//# sourceMappingURL=runnerCommands.d.ts.map

package/dist/runnerUtility/runnerCommands.d.ts.map

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