charness 3.7.0 → 3.8.0

package/dist/connectors/telegram/commands/runners.js

@@ -0,0 +1,486 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatRunnersTime = exports.runnersWatchIntervalMs = void 0;
+exports.createRunners = createRunners;
+/**
+ * `/runners` — the machines that run the agents' tests and builds, paired from Telegram. In General only (admins): one message that
+ * lists the machines (online or not, what they are, what they can do) with Pause / Resume / Remove per machine, and a button that pairs
+ * another one — a one-time line to paste on the new machine, valid 10 minutes, shown as a message that turns into «paired» or «expired».
+ * The hub itself is `src/runners/`; this file is only the screen, its buttons and the two background jobs (editing the pairing message,
+ * refreshing a list with live data). See `src/runners/README.md` for the safety line and `utils/runnersScreenPlan.ts` for the texts.
+ *
+ * Two rules keep the screen true under concurrency. (1) A render is claimed BEFORE its Telegram edit is awaited: every message has a
+ * generation, and a background job (the live probe) draws only if the message still carries the generation it started from — so a
+ * question that replaced the list while its edit was still queued is never drawn over. (2) The messages that offer a pairing code are
+ * this instance's own record (`runnerPairingMessages.ts`), kept until the edit that settles them was accepted.
+ */
+const telegraf_1 = require("telegraf");
+const configDirFile_1 = require("../../../configDirFile");
+const i18n_1 = require("../../../i18n");
+const renderAgentHtml_1 = require("../renderAgentHtml");
+const sessionKey_1 = require("../../../sessionKey");
+const bootstrapLine_1 = require("../../../runners/bootstrapLine");
+const hubAddress_1 = require("../../../runners/hubAddress");
+const hubAddressCandidates_1 = require("../../../runners/hubAddressCandidates");
+const hubPairing_1 = require("../../../runners/hubPairing");
+const hubRegistry_1 = require("../../../runners/hubRegistry");
+const pairingTiming_1 = require("../../../runners/pairingTiming");
+const runnerRemoval_1 = require("../../../runners/runnerRemoval");
+const runnersScreenPlan_1 = require("../../../utils/runnersScreenPlan");
+const runnerPairingMessages_1 = require("../runnerPairingMessages");
+const callbackToast_1 = require("./callbackToast");
+const callbackMessage_1 = require("./callbackMessage");
+/** The pairing messages and screens of this many messages are remembered; an older keyboard answers «out of date». */
+const messageSnapshotLimit = 50;
+/** How long the next General message is read as an address after «Enter another address». */
+const addressWaitMs = 10 * 60 * 1000;
+/** How often the pairing messages are checked for «used» or «expired» (the registry is two small files). */
+exports.runnersWatchIntervalMs = 5 * 1000;
+/** A pairing message whose edits have been failing for a day is given up on (the code lived 10 minutes; the message may be gone). */
+const pairingMessageGiveUpAfterFailingMs = 24 * 60 * 60 * 1000;
+/** After a failed edit of a pairing message the next try waits this long, doubling each time up to the cap. */
+const settleRetryFirstDelayMs = 5 * 1000;
+const settleRetryMaxDelayMs = 5 * 60 * 1000;
+const logTag = 'runners';
+/** @description What a caught failure says to the operator: a registry error names its file and field, anything else its kind and message. */
+function describeCaughtError(caught) {
+    if (caught instanceof hubRegistry_1.HubRegistryError)
+        return caught.message;
+    return caught instanceof Error ? `${caught.name}: ${caught.message}` : 'unknown error';
+}
+/** `1 Nov 14:02` in the bot's timezone (`process.env.TZ`) and the topic's language: the parts in one fixed order, so it reads the same in every locale. */
+const formatRunnersTime = (epochMs) => {
+    const parts = new Intl.DateTimeFormat((0, i18n_1.getActiveLang)(), { day: 'numeric', month: 'short', hour: '2-digit', minute: '2-digit', hourCycle: 'h23' }).formatToParts(epochMs);
+    const read = (type) => parts.find((part) => part.type === type)?.value ?? '';
+    return `${read('day')} ${read('month')} ${read('hour')}:${read('minute')}`;
+};
+exports.formatRunnersTime = formatRunnersTime;
+function buildKeyboard(screen) {
+    return telegraf_1.Markup.inlineKeyboard(screen.rows.map((row) => row.map((button) => telegraf_1.Markup.button.callback(button.text, button.data))));
+}
+/**
+ * @description Build the `/runners` screen over its ports. `registerRunnersCommands` / `registerRunnersCallbacks` register the command and
+ * the buttons; `handleRunnersAddressText` is called by the text handler for a General message (true = taken as the address) and
+ * `cancelRunnersAddressWait` for a slash command (it ends the wait);
+ * `startRunnersWatcher` starts the job that edits the pairing messages and returns the way to stop it (`watchPairingsOnce` is one
+ * look of that job, for a test to run on its own clock).
+ */
+function createRunners(ports) {
+    const { bot, command, replyToThread, editThreadMessage, editThreadKeyboard, authoriseContext, withThreadLocale, checkIsGeneral, hub, now } = ports;
+    const shownScreens = new Map();
+    const addressProposals = new Map();
+    /** General keys whose next message is an address → when the wait began. */
+    const addressWaits = new Map();
+    /** Pairing messages whose edit failed: when the next try may be, and the delay after it (in memory — a restart tries at once). */
+    const settleRetries = new Map();
+    let isWatchTickRunning = false;
+    let lastGeneration = 0;
+    let lastStoreProblem = null;
+    /** Claim `messageId` for a render: whatever started from an earlier claim no longer draws on it. Returns the claim. */
+    function claimMessage(key, messageId, kind, page) {
+        lastGeneration += 1;
+        const shown = { kind, generation: lastGeneration, page };
+        (0, callbackMessage_1.rememberBoundedSnapshot)(shownScreens, (0, callbackMessage_1.buildMessageSnapshotKey)(key, messageId), shown, messageSnapshotLimit);
+        return shown;
+    }
+    /** The claim `messageId` carries now; `undefined` for a message this module never drew (or forgot). */
+    function readClaim(key, messageId) {
+        return shownScreens.get((0, callbackMessage_1.buildMessageSnapshotKey)(key, messageId));
+    }
+    /** The page of the list `messageId` shows — or showed, when a question has replaced it (the question keeps the page it came from); 0 for a message never drawn. */
+    function readShownPage(key, messageId) {
+        return readClaim(key, messageId)?.page ?? 0;
+    }
+    async function reportRegistryError(key, caught) {
+        await replyToThread(key, (0, i18n_1.t)('runners.registryErrorText', { reason: describeCaughtError(caught) }));
+    }
+    /**
+     * Draw page `page` of `overview` — as a new message, or over `messageId` — and, when machines are online, ask them in the background and
+     * draw again. A message that is edited is claimed BEFORE the edit is awaited, so a probe that started from an earlier claim cannot draw
+     * over it; a new message is claimed once it exists (nothing can have started from it).
+     */
+    async function drawList(key, overview, page, target) {
+        const isChecking = overview.entries.some((entry) => entry.isOnline);
+        const screen = (0, runnersScreenPlan_1.buildRunnersScreen)({ ...overview, isChecking }, i18n_1.t, exports.formatRunnersTime, page);
+        let messageId;
+        let claim = null;
+        if (target.messageId === null) {
+            messageId = await replyToThread(key, screen.text, buildKeyboard(screen));
+            if (messageId !== null)
+                claim = claimMessage(key, messageId, 'list', screen.page);
+        }
+        else {
+            claim = claimMessage(key, target.messageId, 'list', screen.page);
+            messageId = (await editThreadMessage(key, target.messageId, screen.text, buildKeyboard(screen))) ? target.messageId : null;
+        }
+        if (messageId === null || claim === null || !isChecking)
+            return;
+        const startedFrom = claim;
+        void probeAndRedraw(key, messageId, overview, startedFrom).catch((error) => console.warn(`[${logTag}] live check failed: ${describeCaughtError(error)}`));
+    }
+    async function probeAndRedraw(key, messageId, overview, startedFrom) {
+        const probed = await ports.probeOverview(overview, now());
+        // No await between this check and the edit being queued: a claim made later queues its own edit behind this one.
+        if (readClaim(key, messageId)?.generation !== startedFrom.generation)
+            return;
+        await withThreadLocale(key, async () => {
+            const screen = (0, runnersScreenPlan_1.buildRunnersScreen)({ ...probed, isChecking: false }, i18n_1.t, exports.formatRunnersTime, startedFrom.page);
+            await editThreadMessage(key, messageId, screen.text, buildKeyboard(screen));
+        });
+    }
+    async function showScreen(key) {
+        await withThreadLocale(key, async () => {
+            let overview;
+            try {
+                overview = await ports.readOverview(now());
+            }
+            catch (error) {
+                await reportRegistryError(key, error);
+                return;
+            }
+            await drawList(key, overview, 0, { messageId: null });
+        });
+    }
+    /** Draw the list over the message a button sits on — page `page`, else the page it already shows. */
+    async function redrawList(key, messageId, page = readShownPage(key, messageId)) {
+        let overview;
+        try {
+            overview = await ports.readOverview(now());
+        }
+        catch (error) {
+            await reportRegistryError(key, error);
+            return;
+        }
+        await drawList(key, overview, page, { messageId });
+    }
+    async function showAddressStep(key) {
+        const proposed = await (0, hubAddressCandidates_1.findProposedHubAddress)(ports.listAddressCandidates(), ports.scanHostKey);
+        const step = (0, runnersScreenPlan_1.buildAddressStep)(proposed === null ? null : (0, hubAddressCandidates_1.formatHubAddress)(proposed.address), i18n_1.t);
+        const messageId = await replyToThread(key, step.text, buildKeyboard(step));
+        if (messageId === null)
+            return;
+        (0, callbackMessage_1.rememberBoundedSnapshot)(addressProposals, (0, callbackMessage_1.buildMessageSnapshotKey)(key, messageId), proposed === null ? null : proposed.address, messageSnapshotLimit);
+        if (proposed === null)
+            addressWaits.set((0, sessionKey_1.keyToString)(key), now());
+    }
+    /** The next General message is the address. */
+    function armAddressWait(key) {
+        addressWaits.set((0, sessionKey_1.keyToString)(key), now());
+    }
+    /** The address was refused: say why and keep listening for another. */
+    async function rejectAddress(key, reason) {
+        armAddressWait(key);
+        await replyToThread(key, (0, i18n_1.t)('runners.addressRejected', { reason }));
+    }
+    /** Make a code and post the line that carries it — a secret: the trace keeps only the message's length. */
+    async function offerPairing(key, address, knownCheck) {
+        const check = knownCheck ?? (await (0, hubAddress_1.checkHubAddress)(address, ports.scanHostKey));
+        if (!check.ok) {
+            await rejectAddress(key, check.error);
+            return;
+        }
+        try {
+            ports.ensureGateWrapper();
+            const pairing = await (0, hubPairing_1.createPairing)(hub, { host: address.host, port: address.port, hostKey: check.hostKey, label: ports.getBotLabel(), nowMs: now() });
+            const parts = (0, runnersScreenPlan_1.buildPairingMessageParts)(pairingTiming_1.pairingLifetimeMinutes, i18n_1.t);
+            const text = `${(0, renderAgentHtml_1.escapeHtmlText)(parts.intro)}\n\n<pre>${(0, renderAgentHtml_1.escapeHtmlText)((0, bootstrapLine_1.buildBootstrapLine)(pairing.payload))}</pre>\n\n${(0, renderAgentHtml_1.escapeHtmlText)(parts.outro)}`;
+            const messageId = await replyToThread(key, text, { parse_mode: 'HTML' }, { isSecret: true });
+            if (messageId === null) {
+                await replyToThread(key, (0, i18n_1.t)('runners.pairFailedText', { reason: 'the message could not be sent' }));
+                return;
+            }
+            try {
+                (0, runnerPairingMessages_1.addPairingMessage)(ports.pairingMessagesPath, { pairId: pairing.pairId, key: (0, sessionKey_1.keyToString)(key), messageId, offeredAtMs: now() });
+            }
+            catch (error) {
+                // The line is out and works; only its turning into «paired» / «expired» is lost.
+                console.warn(`[${logTag}] the pairing message could not be recorded (${(0, configDirFile_1.getCaughtErrnoCode)(error)}); it will not turn into «paired» or «expired»`);
+            }
+        }
+        catch (error) {
+            await replyToThread(key, (0, i18n_1.t)('runners.pairFailedText', { reason: describeCaughtError(error) }));
+        }
+    }
+    async function startPairing(key) {
+        const address = ports.readRunnerHost();
+        if (address === null)
+            await showAddressStep(key);
+        else
+            await offerPairing(key, address, null);
+    }
+    async function useAddress(key, messageId) {
+        const address = messageId === null ? undefined : addressProposals.get((0, callbackMessage_1.buildMessageSnapshotKey)(key, messageId));
+        if (address === undefined || address === null) {
+            await replyToThread(key, (0, i18n_1.t)('runners.addressExpired'));
+            return;
+        }
+        if (messageId !== null)
+            await editThreadKeyboard(key, messageId, null, logTag);
+        const saveError = ports.saveRunnerHost(address);
+        if (saveError !== null)
+            console.warn(`[${logTag}] the address could not be saved (${saveError}); it is used for this pairing only`);
+        await offerPairing(key, address, null);
+    }
+    /** A slash command ends the wait for the address (the command itself runs normally); the text handler calls it before a bot command returns. */
+    function cancelRunnersAddressWait(key) {
+        addressWaits.delete((0, sessionKey_1.keyToString)(key));
+    }
+    /**
+     * @description A General message while the address is awaited: parse it, check that it answers with this machine's own sshd, keep it
+     * and make the pairing line. A failed check keeps the wait (the reason is posted). A slash command ends the wait and runs normally.
+     * Resolves to whether the message was taken here.
+     */
+    async function handleRunnersAddressText(key, text) {
+        const keyText = (0, sessionKey_1.keyToString)(key);
+        const waitStartedAt = addressWaits.get(keyText);
+        if (waitStartedAt === undefined || !checkIsGeneral(key))
+            return false;
+        if (now() - waitStartedAt > addressWaitMs || text.startsWith('/')) {
+            cancelRunnersAddressWait(key);
+            return false;
+        }
+        await withThreadLocale(key, async () => {
+            const parsed = (0, hubAddress_1.parseHubAddress)(text);
+            if (!parsed.ok) {
+                await rejectAddress(key, parsed.error);
+                return;
+            }
+            const check = await (0, hubAddress_1.checkHubAddress)(parsed.address, ports.scanHostKey);
+            if (!check.ok) {
+                await rejectAddress(key, check.error);
+                return;
+            }
+            addressWaits.delete(keyText);
+            const saveError = ports.saveRunnerHost(parsed.address);
+            if (saveError !== null)
+                console.warn(`[${logTag}] the address could not be saved (${saveError}); it is used for this pairing only`);
+            if (check.note !== null)
+                await replyToThread(key, (0, i18n_1.t)('runners.addressNote', { note: check.note }));
+            await offerPairing(key, parsed.address, check);
+        });
+        return true;
+    }
+    async function handleRunnerAction(ctx, key, messageId, callback) {
+        let paired;
+        try {
+            paired = (0, hubRegistry_1.readPairedFile)(hub.dir);
+        }
+        catch (error) {
+            await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+            await reportRegistryError(key, error);
+            return;
+        }
+        const runner = paired.rev === callback.revision ? paired.runners[callback.index] : undefined;
+        if (runner === undefined) {
+            await (0, callbackToast_1.answerCallbackQuerySafely)(ctx, (0, i18n_1.t)('runners.staleToast'));
+            if (messageId !== null)
+                await redrawList(key, messageId);
+            return;
+        }
+        switch (callback.action) {
+            case 'remove': {
+                await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                if (messageId === null)
+                    return;
+                const question = (0, runnersScreenPlan_1.buildRemoveConfirmation)(runner.name, paired.rev, callback.index, i18n_1.t);
+                // Claimed first: a live check that finishes while this edit is still queued must not draw the list over the question.
+                const listClaim = readClaim(key, messageId);
+                claimMessage(key, messageId, 'question', listClaim?.page ?? 0);
+                await editThreadMessage(key, messageId, question.text, buildKeyboard(question));
+                return;
+            }
+            case 'removeNo':
+                await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                break;
+            case 'removeYes': {
+                // The tap is answered at once, without text: stopping the jobs on the machine can take 20 s and more, and a tap left unanswered for
+                // long is «too old». What happened — including whether the jobs were stopped — is told in a message of its own once it is known.
+                await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                try {
+                    const removal = await (0, runnerRemoval_1.removeRunnerAndEndItsWork)(hub, runner.id, now());
+                    if (removal !== null)
+                        await replyToThread(key, (0, runnersScreenPlan_1.buildRemovalOutcomeText)(removal.runner.name, removal.jobs, i18n_1.t));
+                }
+                catch (error) {
+                    await reportRegistryError(key, error);
+                    return;
+                }
+                break;
+            }
+            case 'pause':
+            case 'resume': {
+                await (0, hubPairing_1.setPairedRunnerPaused)(hub, runner.id, callback.action === 'pause');
+                await (0, callbackToast_1.answerCallbackQuerySafely)(ctx, (0, i18n_1.t)(callback.action === 'pause' ? 'runners.pausedToast' : 'runners.resumedToast', { name: runner.name }));
+                break;
+            }
+        }
+        if (messageId === null)
+            await showScreen(key);
+        else
+            await redrawList(key, messageId);
+    }
+    async function handleCallback(ctx, callback) {
+        const key = await authoriseContext(ctx);
+        if (!key) {
+            await ctx.answerCbQuery((0, i18n_1.t)('cb.access_denied'));
+            return;
+        }
+        const messageId = (0, callbackMessage_1.getCallbackMessageId)(ctx);
+        await withThreadLocale(key, async () => {
+            // The screen only ever stands in General, but a tap is checked where it lands.
+            if (!checkIsGeneral(key)) {
+                await (0, callbackToast_1.answerCallbackQuerySafely)(ctx, (0, i18n_1.t)('runners.generalOnlyText'));
+                return;
+            }
+            switch (callback.kind) {
+                case 'pair':
+                    await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                    await startPairing(key);
+                    return;
+                case 'refresh':
+                    await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                    if (messageId === null)
+                        await showScreen(key);
+                    else
+                        await redrawList(key, messageId);
+                    return;
+                case 'addressUse':
+                    await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                    await useAddress(key, messageId);
+                    return;
+                case 'addressOther':
+                    await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                    if (messageId !== null)
+                        await editThreadKeyboard(key, messageId, null, logTag);
+                    armAddressWait(key);
+                    await replyToThread(key, (0, i18n_1.t)('runners.addressAsk'));
+                    return;
+                case 'page':
+                    await (0, callbackToast_1.answerCallbackQuerySafely)(ctx);
+                    if (messageId === null)
+                        await showScreen(key);
+                    else
+                        await redrawList(key, messageId, callback.page);
+                    return;
+                case 'runner':
+                    await handleRunnerAction(ctx, key, messageId, callback);
+            }
+        });
+    }
+    /**
+     * @description One look at this instance's unsettled pairing messages (`runnerPairingMessages.ts`): a code that became a runner turns its
+     * message into «paired», one that is no longer open (expired, swept) into «expired». An entry is dropped only after Telegram accepted
+     * the edit — a failed one is tried again later (5 s, doubling to 5 min) and survives a restart; one whose edits have been failing for a
+     * day is given up on (counted from the first failed attempt: a message older than that is still tried once). Expired credentials are
+     * swept from the shared registry here too, but the messages never depend on what the sweep left (they are this instance's own record,
+     * and another instance may have swept or even spent the code while this one was down).
+     *
+     * ORDER matters: the record is read FIRST, the registry right after, with no await between. A message is recorded after its code was
+     * created, so a registry read after the record holds the code of every message in it — a message is never judged against a registry
+     * older than itself (reading them the other way round, an offer that finishes while the sweep waits for the hub lock would be taken for
+     * an expired code and its live line edited away).
+     */
+    async function watchPairingsOnce() {
+        const nowMs = now();
+        const { messages, problem } = (0, runnerPairingMessages_1.readPairingMessages)(ports.pairingMessagesPath);
+        const pending = (0, hubRegistry_1.readPendingFile)(hub.dir).pending;
+        const runners = (0, hubRegistry_1.readPairedFile)(hub.dir).runners;
+        // A broken record fails every look: say it once, not every five seconds.
+        if (problem !== null && problem !== lastStoreProblem)
+            console.warn(`[${logTag}] ${problem}; the pairing messages it held are not followed`);
+        lastStoreProblem = problem;
+        if (pending.some((pairing) => pairing.expiresAtMs <= nowMs))
+            await ports.sweepExpiredCodes(nowMs);
+        const settledPairIds = new Set();
+        for (const message of messages) {
+            if ((settleRetries.get(message.pairId)?.nextAttemptAtMs ?? 0) > nowMs)
+                continue;
+            const runner = runners.find((candidate) => candidate.pairId === message.pairId);
+            const isOpen = pending.some((pairing) => pairing.pairId === message.pairId && pairing.expiresAtMs > nowMs);
+            if (runner === undefined && isOpen)
+                continue;
+            const key = (0, sessionKey_1.keyFromString)(message.key);
+            const isEdited = await withThreadLocale(key, () => editThreadMessage(key, message.messageId, runner === undefined ? (0, runnersScreenPlan_1.buildExpiredText)(i18n_1.t) : (0, runnersScreenPlan_1.buildPairedText)(runner.name, runner.pairedAtMs, i18n_1.t, exports.formatRunnersTime)));
+            if (isEdited) {
+                settledPairIds.add(message.pairId);
+                settleRetries.delete(message.pairId);
+                continue;
+            }
+            if (nowMs - (message.firstFailedAtMs ?? nowMs) > pairingMessageGiveUpAfterFailingMs) {
+                console.warn(`[${logTag}] a pairing message could not be edited for a day; giving up on it`);
+                settledPairIds.add(message.pairId);
+                settleRetries.delete(message.pairId);
+                continue;
+            }
+            (0, runnerPairingMessages_1.markPairingMessageFailed)(ports.pairingMessagesPath, message.pairId, nowMs);
+            const delayMs = Math.min((settleRetries.get(message.pairId)?.delayMs ?? settleRetryFirstDelayMs / 2) * 2, settleRetryMaxDelayMs);
+            settleRetries.set(message.pairId, { nextAttemptAtMs: nowMs + delayMs, delayMs });
+        }
+        if (settledPairIds.size > 0)
+            (0, runnerPairingMessages_1.removePairingMessages)(ports.pairingMessagesPath, settledPairIds);
+    }
+    /**
+     * Keep the `gate` wrapper that the runners' `authorized_keys` lines run pointing at THIS install (a Node upgrade or a moved checkout would
+     * leave them pointing at nothing). Done only for an instance that has runners or open codes: another one touches nothing under `~/.config`.
+     */
+    function refreshGateWrapper() {
+        try {
+            if ((0, hubRegistry_1.readPairedFile)(hub.dir).runners.length > 0 || (0, hubRegistry_1.readPendingFile)(hub.dir).pending.length > 0)
+                ports.ensureGateWrapper();
+        }
+        catch (error) {
+            console.warn(`[${logTag}] the gate wrapper could not be refreshed: ${describeCaughtError(error)}`);
+        }
+    }
+    /** @description Start the watch (one look now, then every interval); returns the way to stop it. */
+    function startRunnersWatcher() {
+        refreshGateWrapper();
+        let lastFailure = '';
+        const look = () => {
+            if (isWatchTickRunning)
+                return;
+            isWatchTickRunning = true;
+            watchPairingsOnce()
+                .then(() => { lastFailure = ''; })
+                .catch((error) => {
+                // A broken registry file fails every look: say it once, not every five seconds.
+                const failure = describeCaughtError(error);
+                if (failure !== lastFailure)
+                    console.warn(`[${logTag}] pairing watch failed: ${failure}`);
+                lastFailure = failure;
+            })
+                .finally(() => { isWatchTickRunning = false; });
+        };
+        look();
+        const timer = setInterval(look, ports.watchIntervalMs ?? exports.runnersWatchIntervalMs);
+        timer.unref();
+        return () => clearInterval(timer);
+    }
+    function registerRunnersCommands() {
+        // `/runners` — in General the list with its buttons; anywhere else a pointer to General. Not gated on an adapter or a session:
+        // the machines belong to the whole bot.
+        command('runners', async (_ctx, key) => {
+            if (!checkIsGeneral(key)) {
+                await replyToThread(key, (0, i18n_1.t)('runners.generalOnlyText'));
+                return;
+            }
+            await showScreen(key);
+        });
+    }
+    function registerRunnersCallbacks() {
+        for (const data of [runnersScreenPlan_1.runnersPairCallback, runnersScreenPlan_1.runnersRefreshCallback, runnersScreenPlan_1.runnersAddressUseCallback, runnersScreenPlan_1.runnersAddressOtherCallback]) {
+            bot.action(data, (ctx) => {
+                const callback = (0, runnersScreenPlan_1.parseRunnersCallback)(data);
+                return callback === null ? Promise.resolve() : handleCallback(ctx, callback);
+            });
+        }
+        for (const pattern of [runnersScreenPlan_1.runnersPageCallbackRe, runnersScreenPlan_1.runnerActionCallbackRe]) {
+            bot.action(pattern, (ctx) => {
+                const callback = (0, runnersScreenPlan_1.parseRunnersCallback)(ctx.match[0]);
+                return callback === null ? Promise.resolve() : handleCallback(ctx, callback);
+            });
+        }
+    }
+    return { registerRunnersCommands, registerRunnersCallbacks, handleRunnersAddressText, cancelRunnersAddressWait, startRunnersWatcher, watchPairingsOnce };
+}
+//# sourceMappingURL=runners.js.map

package/dist/connectors/telegram/commands/runners.js.map

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

package/dist/connectors/telegram/runnerPairingMessages.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+declare const pairingMessageSchema: z.ZodObject<{
+    pairId: z.ZodString;
+    key: z.ZodString;
+    messageId: z.ZodNumber;
+    offeredAtMs: z.ZodNumber;
+    firstFailedAtMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** @name PairingMessage @description One message that offers a code. */
+export type PairingMessage = z.infer<typeof pairingMessageSchema>;
+export interface PairingMessagesRead {
+    messages: PairingMessage[];
+    /** Why the file could not be used (it reads as empty and the next write replaces it); `null` when it was fine or missing. */
+    problem: string | null;
+}
+/** @description The entries in `filePath`. A missing file is none; one that is not valid reads as none and says why (the next write replaces it). */
+export declare function readPairingMessages(filePath: string): PairingMessagesRead;
+/** @description Write the entries (the newest {@link maxEntries}), through a temp file and a rename. */
+export declare function writePairingMessages(filePath: string, messages: readonly PairingMessage[]): void;
+/** @description Add `message` (an older entry for the same code is replaced). */
+export declare function addPairingMessage(filePath: string, message: PairingMessage): void;
+/** @description Take the entries for `pairIds` out. */
+export declare function removePairingMessages(filePath: string, pairIds: ReadonlySet<string>): void;
+/** @description Note that an edit of the message for `pairId` failed at `nowMs`: the first failure is kept, later ones change nothing. */
+export declare function markPairingMessageFailed(filePath: string, pairId: string, nowMs: number): void;
+export {};
+//# sourceMappingURL=runnerPairingMessages.d.ts.map

package/dist/connectors/telegram/runnerPairingMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerPairingMessages.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/runnerPairingMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,oBAAoB;;;;;;kBAOxB,CAAC;AAIH,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,6HAA6H;IAC7H,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,qJAAqJ;AACrJ,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAazE;AAED,wGAAwG;AACxG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAEhG;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAGjF;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAG1F;AAED,0IAA0I;AAC1I,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI9F"}