charness 3.7.0 → 3.9.0

package/dist/stt/sttInstallEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"sttInstallEntry.js","sourceRoot":"","sources":["../../src/stt/sttInstallEntry.ts"],"names":[],"mappings":";;AAAA,6CAA6C;AAE7C;;;;;;;;;GASG;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,EAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,aAAa,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9D,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EACpC,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5F,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC3B,CAAC,CACF,CAAC"}
+{"version":3,"file":"sttInstallEntry.js","sourceRoot":"","sources":["../../src/stt/sttInstallEntry.ts"],"names":[],"mappings":";;AAAA,6CAA6C;AAE7C;;;;;;;;;GASG;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,EAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,aAAa,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9D,CAAC;AAED,0IAA0I;AAC1I,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EACpC,CAAC,KAAK,EAAE,EAAE;QACR,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/testTimings.d.ts

@@ -4,7 +4,7 @@ import { z } from 'zod';
  * production windows the process-level flows would otherwise wait out in real time (the Telegram send pacer's 2 s, the
  * Jira poll's 10 s floor, the wake-up engine's 10 s turn poll and its sweep's minute, the first re-post retry's minute, the two-minute probe of an
  * unconfirmed usage limit, `state.json`'s save debounce, the OpenCode server's 60 s of retries, the 6 h pending-work hold, the
- * todo reminder's 10 s poll and its interval, the 45 s heartbeat lease of a foreground `charness remote-run`, and — a count, not a window —
+ * todo reminder's 10 s poll and its interval, the 45 s heartbeat lease of a foreground `charness remote-run` and its 10 s poll while it waits for a paired runner, and — a count, not a window —
  * the 200 `/bind` picker claims). It is NOT a setting: no
  * operator sets it and it is documented only for developers (DEVELOPMENT.md); settings live in `settings.json`.
  *
@@ -29,6 +29,9 @@ declare const testTimingsSchema: z.ZodObject<{
     todoReminderIntervalMs: z.ZodOptional<z.ZodNumber>;
     bindPickerClaimLimit: z.ZodOptional<z.ZodNumber>;
     remoteRunLeaseMs: z.ZodOptional<z.ZodNumber>;
+    runnerVersionPollMs: z.ZodOptional<z.ZodNumber>;
+    pairingLifetimeMs: z.ZodOptional<z.ZodNumber>;
+    remoteRunRunnerPollMs: z.ZodOptional<z.ZodNumber>;
     scheduleMinFireIntervalMs: z.ZodOptional<z.ZodNumber>;
     tscWatchCheckIntervalMs: z.ZodOptional<z.ZodNumber>;
     tscWatchStaleGraceMs: z.ZodOptional<z.ZodNumber>;
@@ -36,7 +39,7 @@ declare const testTimingsSchema: z.ZodObject<{
 /** @name TestTimings @description The overrides in force; an absent key keeps its production window. */
 export type TestTimings = z.infer<typeof testTimingsSchema>;
 /** Every key the seam accepts — each must reach its consumer (`bot.ts`, the composition root, reads it). */
-export declare const testTimingKeys: ("tscWatchCheckIntervalMs" | "tscWatchStaleGraceMs" | "telegramSendIntervalMs" | "jiraPollIntervalMs" | "requestTurnPollMs" | "requestSweepIntervalMs" | "requestFirstPostRetryDelayMs" | "limitProbeDelayMs" | "stateSaveDebounceMs" | "openCodeServerUpBudgetMs" | "backgroundHoldMaxMs" | "todoReminderPollMs" | "todoReminderIntervalMs" | "bindPickerClaimLimit" | "remoteRunLeaseMs" | "scheduleMinFireIntervalMs")[];
+export declare const testTimingKeys: ("tscWatchCheckIntervalMs" | "tscWatchStaleGraceMs" | "telegramSendIntervalMs" | "jiraPollIntervalMs" | "requestTurnPollMs" | "requestSweepIntervalMs" | "requestFirstPostRetryDelayMs" | "limitProbeDelayMs" | "stateSaveDebounceMs" | "openCodeServerUpBudgetMs" | "backgroundHoldMaxMs" | "todoReminderPollMs" | "todoReminderIntervalMs" | "bindPickerClaimLimit" | "remoteRunLeaseMs" | "runnerVersionPollMs" | "pairingLifetimeMs" | "remoteRunRunnerPollMs" | "scheduleMinFireIntervalMs")[];
 export type TestTimingsParse = {
     ok: true;
     timings: TestTimings;

package/dist/testTimings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testTimings.d.ts","sourceRoot":"","sources":["../src/testTimings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;;;;;;;;;;;GAaG;AAEH,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAW1D,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;kBAuCrB,CAAC;AAEH,wGAAwG;AACxG,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,4GAA4G;AAC5G,eAAO,MAAM,cAAc,6ZAAoC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAa/E;AAED,iGAAiG;AACjG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAI7E"}
+{"version":3,"file":"testTimings.d.ts","sourceRoot":"","sources":["../src/testTimings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB;;;;;;;;;;;;;GAaG;AAEH,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAW1D,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;kBA6CrB,CAAC;AAEH,wGAAwG;AACxG,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,4GAA4G;AAC5G,eAAO,MAAM,cAAc,qeAAoC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAa/E;AAED,iGAAiG;AACjG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAI7E"}

package/dist/testTimings.js

@@ -18,12 +18,15 @@ const nag_1 = require("./todos/nag");
 const reminderEngine_1 = require("./todos/reminderEngine");
 const recurrence_1 = require("./scheduler/recurrence");
 const leaseTiming_1 = require("./remoteRun/leaseTiming");
+const versionPollTiming_1 = require("./runnerUtility/versionPollTiming");
+const pairingTiming_1 = require("./runners/pairingTiming");
+const runnerWaitTiming_1 = require("./remoteRun/runnerWaitTiming");
 /**
  * @description The ONE test-only timing seam: `CHARNESS_TEST_TIMINGS`, a JSON object of named overrides for the
  * production windows the process-level flows would otherwise wait out in real time (the Telegram send pacer's 2 s, the
  * Jira poll's 10 s floor, the wake-up engine's 10 s turn poll and its sweep's minute, the first re-post retry's minute, the two-minute probe of an
  * unconfirmed usage limit, `state.json`'s save debounce, the OpenCode server's 60 s of retries, the 6 h pending-work hold, the
- * todo reminder's 10 s poll and its interval, the 45 s heartbeat lease of a foreground `charness remote-run`, and — a count, not a window —
+ * todo reminder's 10 s poll and its interval, the 45 s heartbeat lease of a foreground `charness remote-run` and its 10 s poll while it waits for a paired runner, and — a count, not a window —
  * the 200 `/bind` picker claims). It is NOT a setting: no
  * operator sets it and it is documented only for developers (DEVELOPMENT.md); settings live in `settings.json`.
  *
@@ -74,6 +77,12 @@ const testTimingsSchema = zod_1.z.strictObject({
     bindPickerClaimLimit: zod_1.z.number().int().positive().max(bindPickerClaims_1.bindPickerClaimLimit).optional(),
     /** How long a runner waits for the heartbeat of a foreground `charness remote-run` before it kills the job (production: `remoteRunLeaseMs`, 45 s; at least `remoteRunLeaseMinMs`). Read by the remote-run CLI, not by the bot. */
     remoteRunLeaseMs: createShorterWindowSchema(leaseTiming_1.remoteRunLeaseMs).min(leaseTiming_1.remoteRunLeaseMinMs).optional(),
+    /** How often a linked `charness-runner` asks the hub for its current package (production: `runnerVersionPollMs`, 5 min; at least `runnerVersionPollMinMs`). Read by the runner utility, not by the bot. */
+    runnerVersionPollMs: createShorterWindowSchema(versionPollTiming_1.runnerVersionPollMs).min(versionPollTiming_1.runnerVersionPollMinMs).optional(),
+    /** How long a runner pairing code works (production: `pairingLifetimeMs`, 10 min; at least `pairingLifetimeMinMs`). Read by `charness runners pair`, not by the bot's boot. */
+    pairingLifetimeMs: createShorterWindowSchema(pairingTiming_1.pairingLifetimeMs).min(pairingTiming_1.pairingLifetimeMinMs).optional(),
+    /** How often `charness remote-run --needs <capability>` looks again while it waits for an offline paired runner (production: `runnerWaitPollMs`, 10 s; at least `runnerWaitPollMinMs`). Read by the remote-run CLI, not by the bot. */
+    remoteRunRunnerPollMs: createShorterWindowSchema(runnerWaitTiming_1.runnerWaitPollMs).min(runnerWaitTiming_1.runnerWaitPollMinMs).optional(),
     /** The shortest gap between two fires of a cron schedule (production: `minFireIntervalMs`, 5 min). */
     scheduleMinFireIntervalMs: createShorterWindowSchema(recurrence_1.minFireIntervalMs).optional(),
     /** How often the hot supervisor compares its `tsc -w` with the sources (production: `tscWatchCheckIntervalMs`, 30 s). Read by `charness hot`, not by the bot. */

package/dist/testTimings.js.map

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

package/dist/utils/agentEnvironment.d.ts

@@ -20,8 +20,12 @@
  * `IS_SANDBOX` lets Claude Code run `--dangerously-skip-permissions` as root,
  * which the whole bot in a rootless Docker container is (the image sets it);
  * without it every agent there refuses to start. It holds no secret.
+ * `XDG_CACHE_HOME` is a path: with it the agent and the bot (and the other agents) use ONE local cache —
+ * `charness remote-run` keeps its ssh control sockets, the last probe of each runner and its record of
+ * which project a job came from there; without it a tracker agent's cache followed `HOME` while the bot's
+ * did not, and what one wrote the other could not read.
  */
-export declare const agentEnvironmentNames: readonly ["HOME", "PATH", "USER", "LOGNAME", "SHELL", "LANG", "LC_ALL", "LC_CTYPE", "TERM", "TMPDIR", "TZ", "IS_SANDBOX"];
+export declare const agentEnvironmentNames: readonly ["HOME", "PATH", "USER", "LOGNAME", "SHELL", "LANG", "LC_ALL", "LC_CTYPE", "TERM", "TMPDIR", "TZ", "IS_SANDBOX", "XDG_CACHE_HOME"];
 /** @description Remember which variables came from the instance's `ENV_FILE`: none of them reaches an agent. */
 export declare function addEnvFileVariableNames(names: Iterable<string>): void;
 /** @description Forget the recorded names — for tests only, so each case starts from a process that loaded no env file. */
@@ -29,7 +33,7 @@ export declare function resetEnvFileVariableNamesForTests(): void;
 /**
  * @description The allowlisted variables `env` holds, minus any the `ENV_FILE`
  * set — an instance file that sets `PATH` leaves the agent on the shell's default
- * search path rather than handing it a value from the file.
+ * search path rather than handing it a value from the file (`XDG_CACHE_HOME` excepted, see above).
  */
 export declare function getAgentEnvironment(env?: NodeJS.ProcessEnv): Record<string, string>;
 /** @description Set (or, with `null`, clear) the folder {@link addAgentBinDirToPath} puts first on the PATH. */

package/dist/utils/agentEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentEnvironment.d.ts","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,2HAaxB,CAAC;AAKX,gHAAgH;AAChH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAErE;AAED,2HAA2H;AAC3H,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhG;AAQD,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGhG"}
+{"version":3,"file":"agentEnvironment.d.ts","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,6IAcxB,CAAC;AAYX,gHAAgH;AAChH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAErE;AAED,2HAA2H;AAC3H,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhG;AAQD,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGhG"}

package/dist/utils/agentEnvironment.js

@@ -62,6 +62,10 @@ const path = __importStar(require("path"));
  * `IS_SANDBOX` lets Claude Code run `--dangerously-skip-permissions` as root,
  * which the whole bot in a rootless Docker container is (the image sets it);
  * without it every agent there refuses to start. It holds no secret.
+ * `XDG_CACHE_HOME` is a path: with it the agent and the bot (and the other agents) use ONE local cache —
+ * `charness remote-run` keeps its ssh control sockets, the last probe of each runner and its record of
+ * which project a job came from there; without it a tracker agent's cache followed `HOME` while the bot's
+ * did not, and what one wrote the other could not read.
  */
 exports.agentEnvironmentNames = [
     'HOME',
@@ -76,7 +80,14 @@ exports.agentEnvironmentNames = [
     'TMPDIR',
     'TZ',
     'IS_SANDBOX',
+    'XDG_CACHE_HOME',
 ];
+/**
+ * Allowlisted names that reach the agent even when the instance's `ENV_FILE` set them: a PATH or TZ from that file is the instance's own
+ * business, but `XDG_CACHE_HOME` is a path the BOT then follows too — and the agent must follow the bot, or the two keep separate
+ * `charness remote-run` caches (probes, ssh connections, job records) and cannot read each other's. It holds no secret.
+ */
+const namesPassedEvenFromEnvFile = new Set(['XDG_CACHE_HOME']);
 /** Names the instance's `ENV_FILE` set — recorded by the env loader on every load (the hot worker loads it again). */
 const envFileVariableNames = new Set();
 /** @description Remember which variables came from the instance's `ENV_FILE`: none of them reaches an agent. */
@@ -91,13 +102,13 @@ function resetEnvFileVariableNamesForTests() {
 /**
  * @description The allowlisted variables `env` holds, minus any the `ENV_FILE`
  * set — an instance file that sets `PATH` leaves the agent on the shell's default
- * search path rather than handing it a value from the file.
+ * search path rather than handing it a value from the file (`XDG_CACHE_HOME` excepted, see above).
  */
 function getAgentEnvironment(env = process.env) {
     const environment = {};
     for (const name of exports.agentEnvironmentNames) {
         const value = env[name];
-        if (value !== undefined && !envFileVariableNames.has(name))
+        if (value !== undefined && (!envFileVariableNames.has(name) || namesPassedEvenFromEnvFile.has(name)))
             environment[name] = value;
     }
     return environment;

package/dist/utils/agentEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentEnvironment.js","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,0DAEC;AAGD,8EAEC;AAOD,kDAOC;AASD,kDAEC;AAMD,oDAGC;AAtFD,2CAA6B;AAE7B;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACU,QAAA,qBAAqB,GAAG;IACnC,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,YAAY;CACJ,CAAC;AAEX,sHAAsH;AACtH,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C,gHAAgH;AAChH,SAAgB,uBAAuB,CAAC,KAAuB;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,2HAA2H;AAC3H,SAAgB,iCAAiC;IAC/C,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,6BAAqB,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACxF,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,yHAAyH;AACzH,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,gHAAgH;AAChH,SAAgB,mBAAmB,CAAC,GAAkB;IACpD,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,WAAmC;IACtE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,GAAG,WAAW,GAAG,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,CAAC;AAC5G,CAAC"}
+{"version":3,"file":"agentEnvironment.js","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,0DAEC;AAGD,8EAEC;AAOD,kDAOC;AASD,kDAEC;AAMD,oDAGC;AAlGD,2CAA6B;AAE7B;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;GAeG;AACU,QAAA,qBAAqB,GAAG;IACnC,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,gBAAgB;CACR,CAAC;AAEX;;;;GAIG;AACH,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEpF,sHAAsH;AACtH,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C,gHAAgH;AAChH,SAAgB,uBAAuB,CAAC,KAAuB;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,2HAA2H;AAC3H,SAAgB,iCAAiC;IAC/C,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,6BAAqB,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAClI,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,yHAAyH;AACzH,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,gHAAgH;AAChH,SAAgB,mBAAmB,CAAC,GAAkB;IACpD,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,WAAmC;IACtE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,GAAG,WAAW,GAAG,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,CAAC;AAC5G,CAAC"}

package/dist/utils/runnersScreenPlan.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @description Pure plan of the `/runners` screen (`connectors/telegram/commands/runners.ts`): the list of paired machines with
+ * what they said about themselves, the buttons, the confirmation of a removal, the address step of the first pairing, the pairing
+ * message and the texts that replace it once the code was used or expired. Everything here takes the facts in and gives text and
+ * button data out, so the first render and every re-render can never drift apart, and the callback data is checked for Telegram's
+ * 64-byte cap in one place.
+ *
+ * Buttons carry the registry revision AND the runner's position in the WHOLE list (`rnr_<rev>_<i>_<action>`): a keyboard left in the
+ * history acts on the list it was drawn from or is refused, never on a neighbour that moved up — whichever page it stands on.
+ *
+ * The text is BOUNDED: Telegram refuses a message over 4096 characters, and what a machine reports about itself (CPU model, capability
+ * details) has no length of its own, so every reported string is clipped and the machines are split over pages of at most
+ * {@link maxScreenTextChars}. A page holds at least one machine; a list that fits is one page with no navigation.
+ */
+import type { Translate } from '../i18n';
+import { type RunnerProbe } from '../remoteRun/probe';
+import type { PairedRunner } from '../runners/hubRegistry';
+import type { RunnerJobsStop } from '../runners/runnerRemoval';
+/** Telegram refuses callback data over 64 BYTES. */
+export declare const maxCallbackDataBytes = 64;
+/** The most characters a screen's text may have: Telegram's limit is 4096, the rest is the margin for the title, notes and the page line. */
+export declare const maxScreenTextChars = 3600;
+/** The longest a string a machine reported about itself (CPU model, a capability's detail, its OS name) is shown. */
+export declare const maxReportedTextChars = 80;
+export declare const runnersCallbackPrefix = "rnr_";
+export declare const runnersPairCallback = "rnr_pair";
+export declare const runnersRefreshCallback = "rnr_refresh";
+export declare const runnersAddressUseCallback = "rnr_aduse";
+export declare const runnersAddressOtherCallback = "rnr_adother";
+/** Matches `rnr_pg_<page>` (0-based): a view change that acts on nothing, so it carries no revision. */
+export declare const runnersPageCallbackRe: RegExp;
+/** What a button next to a runner does. `remove` asks; `removeYes` / `removeNo` answer the question. */
+export type RunnerAction = 'pause' | 'resume' | 'remove' | 'removeYes' | 'removeNo';
+/** Matches `rnr_<rev>_<index>_<action code>`. */
+export declare const runnerActionCallbackRe: RegExp;
+export type RunnersCallback = {
+    kind: 'pair';
+} | {
+    kind: 'refresh';
+} | {
+    kind: 'addressUse';
+} | {
+    kind: 'addressOther';
+} | {
+    kind: 'page';
+    page: number;
+} | {
+    kind: 'runner';
+    revision: number;
+    index: number;
+    action: RunnerAction;
+};
+export declare function buildRunnersPageCallback(page: number): string;
+export declare function buildRunnerActionCallback(revision: number, index: number, action: RunnerAction): string;
+/** @description Read a button's callback data; `null` when it is not one of this screen's. */
+export declare function parseRunnersCallback(data: string): RunnersCallback | null;
+export interface ScreenButton {
+    text: string;
+    data: string;
+}
+/** @name RunnersScreen @description Text and keyboard rows of one render. */
+export interface RunnersScreen {
+    text: string;
+    rows: ScreenButton[][];
+}
+/** @name RunnersListScreen @description The list as one page: which of how many it is. */
+export interface RunnersListScreen extends RunnersScreen {
+    /** 0-based, clamped into the list that exists. */
+    page: number;
+    pageCount: number;
+}
+/** @name RunnerScreenEntry @description One paired machine and everything known of it right now. */
+export interface RunnerScreenEntry {
+    runner: PairedRunner;
+    isOnline: boolean;
+    /** The last time the hub knew the link alive; `null` = never connected. */
+    lastSeenMs: number | null;
+    /** The live probe while online, else the last snapshot taken when the machine was seen; `null` = never probed. */
+    probe: RunnerProbe | null;
+}
+export interface RunnersScreenModel {
+    /** The registry revision the keyboard is built from. */
+    revision: number;
+    entries: readonly RunnerScreenEntry[];
+    /** When each pairing code that is still open expires. */
+    openPairingExpiries: readonly number[];
+    /** A probe is running: the screen says so, and is re-rendered when it ends. */
+    isChecking: boolean;
+}
+/** @description Formats an instant for the operator (`1 Nov 14:02`) in the bot's timezone and the topic's language. */
+export type FormatTime = (epochMs: number) => string;
+/** @description `text` as a string a machine reported: no longer than {@link maxReportedTextChars}, cut with an ellipsis. */
+export declare function clipReportedText(text: string): string;
+/**
+ * @description Split the entry blocks over pages: each page takes blocks while the text stays within `budget` characters (blocks joined by
+ * a blank line), and at least one block, so a block over the budget alone still has a page. Returns each page's first block and the
+ * block after its last.
+ */
+export declare function paginateBlocks(blocks: readonly string[], budget: number): Array<{
+    start: number;
+    end: number;
+}>;
+/**
+ * @description The list screen, page `page` (0-based; a page past the end is the last): the machines on it, a button to pair another, a
+ * Pause/Resume and a Remove per machine on the page, the page buttons when there is more than one page, Refresh.
+ */
+export declare function buildRunnersScreen(model: RunnersScreenModel, t: Translate, formatTime: FormatTime, page?: number): RunnersListScreen;
+/**
+ * @description The message that says what a removal came to: the key is deleted in every case, and the jobs were stopped from the hub, or the
+ * machine was offline (it stops them itself once its key has been refused for `unconfirmedRemovalStopAfterHours`), or they could not be stopped
+ * from here (it does the same). Three outcomes, three texts — «offline» is not what «failed» means.
+ */
+export declare function buildRemovalOutcomeText(runnerName: string, jobs: RunnerJobsStop, t: Translate): string;
+/** @description The question a Remove button turns the screen into. */
+export declare function buildRemoveConfirmation(runnerName: string, revision: number, index: number, t: Translate): RunnersScreen;
+/**
+ * @description The address step of the first pairing. With a proposal (an address of this machine that answered with its own
+ * sshd) it offers «Use …» and «Enter another address»; without one only the second, and says no address was found.
+ */
+export declare function buildAddressStep(proposedAddress: string | null, t: Translate): RunnersScreen;
+/** @name PairingMessageParts @description The text around the two lines of a pairing: each line sits between its intro and (for the second) the outro. */
+export interface PairingMessageParts {
+    /** Above the admin line: the lifetime, and which word of the line is the account. */
+    adminIntro: string;
+    /** Above the plain line (no admin rights). */
+    alternativeIntro: string;
+    /** Below the plain line: what the account must be, and who can use a line. */
+    alternativeOutro: string;
+}
+/**
+ * @description The pairing's text parts. A pairing is offered in TWO messages — the admin line first, the plain line second — because the
+ * two lines together are longer than a Telegram message; `account` is the one the admin line pairs unless its last word is changed.
+ */
+export declare function buildPairingMessageParts(pairingLifetimeMinutes: number, account: string, t: Translate): PairingMessageParts;
+/** @description What the pairing message becomes once the code was used. */
+export declare function buildPairedText(runnerName: string, pairedAtMs: number, t: Translate, formatTime: FormatTime): string;
+/** @description What the pairing message becomes once the code expired unused. */
+export declare function buildExpiredText(t: Translate): string;
+/** @description What the pairing message becomes once its code was CLOSED unused: the line was pasted for a machine that was already paired, so it only installed the service. */
+export declare function buildClosedText(t: Translate): string;
+//# sourceMappingURL=runnersScreenPlan.d.ts.map

package/dist/utils/runnersScreenPlan.d.ts.map

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

package/dist/utils/runnersScreenPlan.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * @description Pure plan of the `/runners` screen (`connectors/telegram/commands/runners.ts`): the list of paired machines with
+ * what they said about themselves, the buttons, the confirmation of a removal, the address step of the first pairing, the pairing
+ * message and the texts that replace it once the code was used or expired. Everything here takes the facts in and gives text and
+ * button data out, so the first render and every re-render can never drift apart, and the callback data is checked for Telegram's
+ * 64-byte cap in one place.
+ *
+ * Buttons carry the registry revision AND the runner's position in the WHOLE list (`rnr_<rev>_<i>_<action>`): a keyboard left in the
+ * history acts on the list it was drawn from or is refused, never on a neighbour that moved up — whichever page it stands on.
+ *
+ * The text is BOUNDED: Telegram refuses a message over 4096 characters, and what a machine reports about itself (CPU model, capability
+ * details) has no length of its own, so every reported string is clipped and the machines are split over pages of at most
+ * {@link maxScreenTextChars}. A page holds at least one machine; a list that fits is one page with no navigation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runnerActionCallbackRe = exports.runnersPageCallbackRe = exports.runnersAddressOtherCallback = exports.runnersAddressUseCallback = exports.runnersRefreshCallback = exports.runnersPairCallback = exports.runnersCallbackPrefix = exports.maxReportedTextChars = exports.maxScreenTextChars = exports.maxCallbackDataBytes = void 0;
+exports.buildRunnersPageCallback = buildRunnersPageCallback;
+exports.buildRunnerActionCallback = buildRunnerActionCallback;
+exports.parseRunnersCallback = parseRunnersCallback;
+exports.clipReportedText = clipReportedText;
+exports.paginateBlocks = paginateBlocks;
+exports.buildRunnersScreen = buildRunnersScreen;
+exports.buildRemovalOutcomeText = buildRemovalOutcomeText;
+exports.buildRemoveConfirmation = buildRemoveConfirmation;
+exports.buildAddressStep = buildAddressStep;
+exports.buildPairingMessageParts = buildPairingMessageParts;
+exports.buildPairedText = buildPairedText;
+exports.buildExpiredText = buildExpiredText;
+exports.buildClosedText = buildClosedText;
+const probe_1 = require("../remoteRun/probe");
+const removalTiming_1 = require("../runners/removalTiming");
+const runnerServiceKind_1 = require("../runners/runnerServiceKind");
+/** Telegram refuses callback data over 64 BYTES. */
+exports.maxCallbackDataBytes = 64;
+/** The most characters a screen's text may have: Telegram's limit is 4096, the rest is the margin for the title, notes and the page line. */
+exports.maxScreenTextChars = 3600;
+/** The longest a string a machine reported about itself (CPU model, a capability's detail, its OS name) is shown. */
+exports.maxReportedTextChars = 80;
+/** What the page line («Page 2 of 3») and the separators around it may take of the budget. */
+const pageLineReserveChars = 60;
+const sectionSeparator = '\n\n';
+exports.runnersCallbackPrefix = 'rnr_';
+exports.runnersPairCallback = 'rnr_pair';
+exports.runnersRefreshCallback = 'rnr_refresh';
+exports.runnersAddressUseCallback = 'rnr_aduse';
+exports.runnersAddressOtherCallback = 'rnr_adother';
+/** Matches `rnr_pg_<page>` (0-based): a view change that acts on nothing, so it carries no revision. */
+exports.runnersPageCallbackRe = /^rnr_pg_(\d+)$/;
+const actionCodes = { pause: 'p', resume: 'r', remove: 'x', removeYes: 'xy', removeNo: 'xn' };
+/** Matches `rnr_<rev>_<index>_<action code>`. */
+exports.runnerActionCallbackRe = /^rnr_(\d+)_(\d+)_(p|r|x|xy|xn)$/;
+function buildRunnersPageCallback(page) {
+    return `${exports.runnersCallbackPrefix}pg_${page}`;
+}
+function buildRunnerActionCallback(revision, index, action) {
+    return `${exports.runnersCallbackPrefix}${revision}_${index}_${actionCodes[action]}`;
+}
+/** @description Read a button's callback data; `null` when it is not one of this screen's. */
+function parseRunnersCallback(data) {
+    if (data === exports.runnersPairCallback)
+        return { kind: 'pair' };
+    if (data === exports.runnersRefreshCallback)
+        return { kind: 'refresh' };
+    if (data === exports.runnersAddressUseCallback)
+        return { kind: 'addressUse' };
+    if (data === exports.runnersAddressOtherCallback)
+        return { kind: 'addressOther' };
+    const pageMatch = exports.runnersPageCallbackRe.exec(data);
+    if (pageMatch !== null)
+        return { kind: 'page', page: Number(pageMatch[1]) };
+    const match = exports.runnerActionCallbackRe.exec(data);
+    if (match === null)
+        return null;
+    const action = Object.keys(actionCodes).find((candidate) => actionCodes[candidate] === match[3]);
+    return action === undefined ? null : { kind: 'runner', revision: Number(match[1]), index: Number(match[2]), action };
+}
+const serviceKindKeys = {
+    foreground: 'runners.serviceForeground',
+    'user-service': 'runners.serviceUserService',
+    'system-service': 'runners.serviceSystemService',
+    unknown: 'runners.serviceUnknown',
+};
+/** @description `text` as a string a machine reported: no longer than {@link maxReportedTextChars}, cut with an ellipsis. */
+function clipReportedText(text) {
+    return text.length <= exports.maxReportedTextChars ? text : `${text.slice(0, exports.maxReportedTextChars - 1)}…`;
+}
+function describeSystem(entry) {
+    const { probe, runner } = entry;
+    if (probe === null || probe.osName === '')
+        return clipReportedText(`${runner.os} (${runner.arch})`);
+    const name = [probe.osName, probe.osVersion].filter((part) => part !== '').join(' ');
+    return clipReportedText(probe.arch === '' ? name : `${name} (${probe.arch})`);
+}
+function describeCpu(probe, t, isLive) {
+    const model = probe.cpuModel === '' ? 'CPU' : clipReportedText(probe.cpuModel);
+    const shape = probe.cpuCores !== null
+        ? t('runners.cpuCores', { model, cores: probe.cpuCores })
+        : probe.cpuThreads !== null
+            ? t('runners.cpuThreads', { model, threads: probe.cpuThreads })
+            : model;
+    return isLive && probe.load !== null ? `${shape}, ${t('runners.cpuLoad', { load: probe.load })}` : shape;
+}
+function describeCapabilities(probe, t) {
+    // What the machine can do first, then what it cannot and why.
+    const available = [];
+    const unavailable = [];
+    for (const name of probe_1.runnerCapabilities) {
+        const report = probe.capabilities[name];
+        const detail = clipReportedText(report.detail);
+        if (report.isAvailable)
+            available.push(detail === '' ? name : `${name} (${detail})`);
+        else
+            unavailable.push(detail === '' ? t('runners.capabilityNo', { name }) : t('runners.capabilityNoWhy', { name, detail }));
+    }
+    return t('runners.capabilitiesLine', { list: [...available, ...unavailable].join(' · ') });
+}
+function buildEntryBlock(entry, t, formatTime) {
+    const { runner, probe } = entry;
+    const status = entry.isOnline
+        ? t('runners.statusOnline')
+        : entry.lastSeenMs === null
+            ? t('runners.statusNeverSeen')
+            : t('runners.statusOffline', { time: formatTime(entry.lastSeenMs) });
+    const serviceKind = (0, runnerServiceKind_1.getCurrentServiceKind)(runner, probe);
+    const heading = [status, ...(runner.isPaused ? [t('runners.pausedMark')] : []), describeSystem(entry), t(serviceKindKeys[serviceKind])].join(' · ');
+    const lines = [`${runner.name} — ${heading}`];
+    if (probe === null)
+        return lines.join('\n');
+    if (entry.isOnline) {
+        lines.push(`  ${t('runners.hardwareLine', { cpu: describeCpu(probe, t, true), ramTotal: (0, probe_1.formatGigabytes)(probe.ramTotalMb), ramFree: (0, probe_1.formatGigabytes)(probe.ramFreeMb), disk: (0, probe_1.formatGigabytes)(probe.diskFreeMb) })}`, `  ${t('runners.jobsLine', { running: probe.jobsRunning, queued: probe.jobsQueued, projects: probe.jobsProjects })}${probe.pueueVersion === null ? ` · ${t('runners.pueueMissing')}` : ''}`, `  ${describeCapabilities(probe, t)}`);
+    }
+    else {
+        lines.push(`  ${t('runners.hardwareOldLine', { cpu: describeCpu(probe, t, false), ramTotal: (0, probe_1.formatGigabytes)(probe.ramTotalMb), disk: (0, probe_1.formatGigabytes)(probe.diskFreeMb) })}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * @description Split the entry blocks over pages: each page takes blocks while the text stays within `budget` characters (blocks joined by
+ * a blank line), and at least one block, so a block over the budget alone still has a page. Returns each page's first block and the
+ * block after its last.
+ */
+function paginateBlocks(blocks, budget) {
+    const pages = [];
+    let start = 0;
+    let used = 0;
+    blocks.forEach((block, index) => {
+        const cost = block.length + (index === start ? 0 : sectionSeparator.length);
+        if (index > start && used + cost > budget) {
+            pages.push({ start, end: index });
+            start = index;
+            used = 0;
+        }
+        used += index === start ? block.length : cost;
+    });
+    if (blocks.length > 0)
+        pages.push({ start, end: blocks.length });
+    return pages;
+}
+function buildOpenPairingsSection(expiries, t, formatTime) {
+    if (expiries.length === 0)
+        return [];
+    const lastExpiry = Math.max(...expiries);
+    return [expiries.length === 1 ? t('runners.pendingCodeLine', { time: formatTime(lastExpiry) }) : t('runners.pendingCodesLine', { count: expiries.length, time: formatTime(lastExpiry) })];
+}
+/**
+ * @description The list screen, page `page` (0-based; a page past the end is the last): the machines on it, a button to pair another, a
+ * Pause/Resume and a Remove per machine on the page, the page buttons when there is more than one page, Refresh.
+ */
+function buildRunnersScreen(model, t, formatTime, page = 0) {
+    const title = t('runners.title');
+    const openPairings = buildOpenPairingsSection(model.openPairingExpiries, t, formatTime);
+    const checking = model.isChecking ? [t('runners.checkingNote')] : [];
+    const blocks = model.entries.map((entry) => buildEntryBlock(entry, t, formatTime));
+    const chromeChars = [title, ...openPairings, ...checking].join(sectionSeparator).length + sectionSeparator.length + pageLineReserveChars;
+    const pages = paginateBlocks(blocks, exports.maxScreenTextChars - chromeChars);
+    const pageCount = Math.max(pages.length, 1);
+    const shownPage = Math.min(Math.max(page, 0), pageCount - 1);
+    const { start, end } = pages[shownPage] ?? { start: 0, end: 0 };
+    const sections = [
+        title,
+        ...(pageCount > 1 ? [t('runners.pageLine', { page: shownPage + 1, pages: pageCount })] : []),
+        ...(model.entries.length === 0 ? [t('runners.emptyText')] : blocks.slice(start, end)),
+        ...openPairings,
+        ...checking,
+    ];
+    const rows = [[{ text: t('runners.pairButton'), data: exports.runnersPairCallback }]];
+    model.entries.slice(start, end).forEach((entry, offset) => {
+        const { name, isPaused } = entry.runner;
+        const index = start + offset;
+        rows.push([
+            isPaused
+                ? { text: t('runners.resumeButton', { name }), data: buildRunnerActionCallback(model.revision, index, 'resume') }
+                : { text: t('runners.pauseButton', { name }), data: buildRunnerActionCallback(model.revision, index, 'pause') },
+            { text: t('runners.removeButton', { name }), data: buildRunnerActionCallback(model.revision, index, 'remove') },
+        ]);
+    });
+    if (pageCount > 1) {
+        rows.push([
+            ...(shownPage > 0 ? [{ text: t('runners.pagePreviousButton'), data: buildRunnersPageCallback(shownPage - 1) }] : []),
+            ...(shownPage < pageCount - 1 ? [{ text: t('runners.pageNextButton'), data: buildRunnersPageCallback(shownPage + 1) }] : []),
+        ]);
+    }
+    rows.push([{ text: t('runners.refreshButton'), data: exports.runnersRefreshCallback }]);
+    return { text: sections.join(sectionSeparator), rows, page: shownPage, pageCount };
+}
+/**
+ * @description The message that says what a removal came to: the key is deleted in every case, and the jobs were stopped from the hub, or the
+ * machine was offline (it stops them itself once its key has been refused for `unconfirmedRemovalStopAfterHours`), or they could not be stopped
+ * from here (it does the same). Three outcomes, three texts — «offline» is not what «failed» means.
+ */
+function buildRemovalOutcomeText(runnerName, jobs, t) {
+    const keyByOutcome = {
+        stopped: 'runners.removedJobsStoppedText',
+        offline: 'runners.removedJobsOfflineText',
+        failed: 'runners.removedJobsFailedText',
+    };
+    return t(keyByOutcome[jobs], { name: runnerName, hours: removalTiming_1.unconfirmedRemovalStopAfterHours });
+}
+/** @description The question a Remove button turns the screen into. */
+function buildRemoveConfirmation(runnerName, revision, index, t) {
+    return {
+        text: t('runners.removeConfirmText', { name: runnerName }),
+        rows: [[
+                { text: t('runners.removeConfirmButton'), data: buildRunnerActionCallback(revision, index, 'removeYes') },
+                { text: t('runners.removeCancelButton'), data: buildRunnerActionCallback(revision, index, 'removeNo') },
+            ]],
+    };
+}
+/**
+ * @description The address step of the first pairing. With a proposal (an address of this machine that answered with its own
+ * sshd) it offers «Use …» and «Enter another address»; without one only the second, and says no address was found.
+ */
+function buildAddressStep(proposedAddress, t) {
+    if (proposedAddress === null) {
+        return {
+            text: `${t('runners.addressIntro')}\n\n${t('runners.addressNotFound')}`,
+            rows: [[{ text: t('runners.addressOtherButton'), data: exports.runnersAddressOtherCallback }]],
+        };
+    }
+    return {
+        text: `${t('runners.addressIntro')}\n\n${t('runners.addressFound', { address: proposedAddress })}`,
+        rows: [[
+                { text: t('runners.addressUseButton', { address: proposedAddress }), data: exports.runnersAddressUseCallback },
+                { text: t('runners.addressOtherButton'), data: exports.runnersAddressOtherCallback },
+            ]],
+    };
+}
+/**
+ * @description The pairing's text parts. A pairing is offered in TWO messages — the admin line first, the plain line second — because the
+ * two lines together are longer than a Telegram message; `account` is the one the admin line pairs unless its last word is changed.
+ */
+function buildPairingMessageParts(pairingLifetimeMinutes, account, t) {
+    return {
+        adminIntro: t('runners.pairingAdminIntro', { minutes: pairingLifetimeMinutes, account }),
+        alternativeIntro: t('runners.pairingAlternativeIntro'),
+        alternativeOutro: t('runners.pairingAlternativeOutro'),
+    };
+}
+/** @description What the pairing message becomes once the code was used. */
+function buildPairedText(runnerName, pairedAtMs, t, formatTime) {
+    return t('runners.pairedText', { name: runnerName, time: formatTime(pairedAtMs) });
+}
+/** @description What the pairing message becomes once the code expired unused. */
+function buildExpiredText(t) {
+    return t('runners.expiredText');
+}
+/** @description What the pairing message becomes once its code was CLOSED unused: the line was pasted for a machine that was already paired, so it only installed the service. */
+function buildClosedText(t) {
+    return t('runners.closedText');
+}
+//# sourceMappingURL=runnersScreenPlan.js.map