charness 3.7.0 → 3.8.0

package/dist/utils/runnersScreenPlan.js

@@ -0,0 +1,257 @@
+"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;
+const probe_1 = require("../remoteRun/probe");
+/** 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 heading = [status, ...(runner.isPaused ? [t('runners.pausedMark')] : []), describeSystem(entry), t(serviceKindKeys[runner.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 it finds out), 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 });
+}
+/** @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 message's text parts: what stands above the line and below it. The line itself sits between them. */
+function buildPairingMessageParts(pairingLifetimeMinutes, t) {
+    return { intro: t('runners.pairingIntro', { minutes: pairingLifetimeMinutes }), outro: t('runners.pairingOutro') };
+}
+/** @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');
+}
+//# sourceMappingURL=runnersScreenPlan.js.map

package/dist/utils/runnersScreenPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnersScreenPlan.js","sourceRoot":"","sources":["../../src/utils/runnersScreenPlan.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAwCH,4DAEC;AAED,8DAEC;AAGD,oDAWC;AAmDD,4CAEC;AA4DD,wCAeC;AAYD,gDAoCC;AAOD,0DAOC;AAGD,0DAQC;AAMD,4CAcC;AAGD,4DAEC;AAGD,0CAEC;AAGD,4CAEC;AArSD,8CAA2F;AAI3F,oDAAoD;AACvC,QAAA,oBAAoB,GAAG,EAAE,CAAC;AACvC,6IAA6I;AAChI,QAAA,kBAAkB,GAAG,IAAI,CAAC;AACvC,qHAAqH;AACxG,QAAA,oBAAoB,GAAG,EAAE,CAAC;AACvC,8FAA8F;AAC9F,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEnB,QAAA,qBAAqB,GAAG,MAAM,CAAC;AAC/B,QAAA,mBAAmB,GAAG,UAAU,CAAC;AACjC,QAAA,sBAAsB,GAAG,aAAa,CAAC;AACvC,QAAA,yBAAyB,GAAG,WAAW,CAAC;AACxC,QAAA,2BAA2B,GAAG,aAAa,CAAC;AACzD,wGAAwG;AAC3F,QAAA,qBAAqB,GAAG,gBAAgB,CAAC;AAKtD,MAAM,WAAW,GAAiC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5H,iDAAiD;AACpC,QAAA,sBAAsB,GAAG,iCAAiC,CAAC;AAUxE,SAAgB,wBAAwB,CAAC,IAAY;IACnD,OAAO,GAAG,6BAAqB,MAAM,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,SAAgB,yBAAyB,CAAC,QAAgB,EAAE,KAAa,EAAE,MAAoB;IAC7F,OAAO,GAAG,6BAAqB,GAAG,QAAQ,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,8FAA8F;AAC9F,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,IAAI,IAAI,KAAK,2BAAmB;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1D,IAAI,IAAI,KAAK,8BAAsB;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAChE,IAAI,IAAI,KAAK,iCAAyB;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACtE,IAAI,IAAI,KAAK,mCAA2B;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAG,6BAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,8BAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAoB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;AACvH,CAAC;AA2CD,MAAM,eAAe,GAAsC;IACzD,UAAU,EAAE,2BAA2B;IACvC,cAAc,EAAE,4BAA4B;IAC5C,gBAAgB,EAAE,8BAA8B;IAChD,OAAO,EAAE,wBAAwB;CAClC,CAAC;AAEF,6HAA6H;AAC7H,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,MAAM,IAAI,4BAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,4BAAoB,GAAG,CAAC,CAAC,GAAG,CAAC;AACpG,CAAC;AAED,SAAS,cAAc,CAAC,KAAwB;IAC9C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,gBAAgB,CAAC,GAAG,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrF,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,WAAW,CAAC,KAAkB,EAAE,CAAY,EAAE,MAAe;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/E,MAAM,KAAK,GACT,KAAK,CAAC,QAAQ,KAAK,IAAI;QACrB,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACzD,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI;YACzB,CAAC,CAAC,CAAC,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;YAC/D,CAAC,CAAC,KAAK,CAAC;IACd,OAAO,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3G,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAkB,EAAE,CAAY;IAC5D,8DAA8D;IAC9D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,0BAAkB,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,WAAW;YAAE,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,GAAG,CAAC,CAAC;;YAChF,WAAW,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9H,CAAC;IACD,OAAO,CAAC,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,eAAe,CAAC,KAAwB,EAAE,CAAY,EAAE,UAAsB;IACrF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ;QAC3B,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAC3B,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI;YACzB,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC;YAC9B,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3J,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,CAAC,sBAAsB,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAA,uBAAe,EAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAA,uBAAe,EAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAA,uBAAe,EAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,EACvM,KAAK,CAAC,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAC3L,KAAK,oBAAoB,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CACtC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAA,uBAAe,EAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAA,uBAAe,EAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/K,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,MAAyB,EAAE,MAAc;IACtE,MAAM,KAAK,GAA0C,EAAE,CAAC;IACxD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5E,IAAI,KAAK,GAAG,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAClC,KAAK,GAAG,KAAK,CAAC;YACd,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;QACD,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,QAA2B,EAAE,CAAY,EAAE,UAAsB;IACjG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5L,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,KAAyB,EAAE,CAAY,EAAE,UAAsB,EAAE,IAAI,GAAG,CAAC;IAC1G,MAAM,KAAK,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,wBAAwB,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,GAAG,YAAY,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,GAAG,oBAAoB,CAAC;IACzI,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE,0BAAkB,GAAG,WAAW,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAC7D,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAChE,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrF,GAAG,YAAY;QACf,GAAG,QAAQ;KACZ,CAAC;IACF,MAAM,IAAI,GAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,2BAAmB,EAAE,CAAC,CAAC,CAAC;IAChG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACxD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;QACxC,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC;YACR,QAAQ;gBACN,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE;gBACjH,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;YACjH,EAAE,IAAI,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE;SAChH,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC;YACR,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpH,GAAG,CAAC,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,wBAAwB,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7H,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC,EAAE,IAAI,EAAE,8BAAsB,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,UAAkB,EAAE,IAAoB,EAAE,CAAY;IAC5F,MAAM,YAAY,GAAkI;QAClJ,OAAO,EAAE,gCAAgC;QACzC,OAAO,EAAE,gCAAgC;QACzC,MAAM,EAAE,+BAA+B;KACxC,CAAC;IACF,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,SAAgB,uBAAuB,CAAC,UAAkB,EAAE,QAAgB,EAAE,KAAa,EAAE,CAAY;IACvG,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC1D,IAAI,EAAE,CAAC;gBACL,EAAE,IAAI,EAAE,CAAC,CAAC,6BAA6B,CAAC,EAAE,IAAI,EAAE,yBAAyB,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE;gBACzG,EAAE,IAAI,EAAE,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,yBAAyB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE;aACxG,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,eAA8B,EAAE,CAAY;IAC3E,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,yBAAyB,CAAC,EAAE;YACvE,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,mCAA2B,EAAE,CAAC,CAAC;SACvF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE;QAClG,IAAI,EAAE,CAAC;gBACL,EAAE,IAAI,EAAE,CAAC,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,iCAAyB,EAAE;gBACtG,EAAE,IAAI,EAAE,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,mCAA2B,EAAE;aAC7E,CAAC;KACH,CAAC;AACJ,CAAC;AAED,iIAAiI;AACjI,SAAgB,wBAAwB,CAAC,sBAA8B,EAAE,CAAY;IACnF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC;AACrH,CAAC;AAED,4EAA4E;AAC5E,SAAgB,eAAe,CAAC,UAAkB,EAAE,UAAkB,EAAE,CAAY,EAAE,UAAsB;IAC1G,OAAO,CAAC,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,kFAAkF;AAClF,SAAgB,gBAAgB,CAAC,CAAY;IAC3C,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "charness",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "license": "MIT",
   "author": "Sergei Solo",
   "description": "Harness for running Claude Code / OpenCode agents in the cloud or on your laptop, controlled from Telegram or Jira.",
@@ -54,6 +54,7 @@
   "main": "dist/cli.js",
   "bin": {
     "charness": "dist/cli.js",
+    "charness-runner": "dist/runnerUtility/runnerCli.js",
     "telegramCode": "dist/cli.js",
     "telegramcode": "dist/cli.js"
   },
@@ -61,7 +62,7 @@
     "node": ">=22.12"
   },
   "scripts": {
-    "build": "tsc && chmod +x dist/cli.js dist/index.js",
+    "build": "tsc && chmod +x dist/cli.js dist/index.js dist/runnerUtility/runnerCli.js",
     "build:watch": "tsc -w",
     "start": "node dist/cli.js",
     "dev": "tsx watch src/cli.ts",
@@ -84,11 +85,13 @@
     "form-data": "^4.0.5",
     "marklassian": "^1.2.1",
     "node-pty": "^1.0.0",
+    "ssh2": "^1.17.0",
     "telegraf": "^4.16.3",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "@types/ssh2": "^1",
     "nodemon": "^3.1.0",
     "playwright-core": "1.59.1",
     "tsx": "^4.21.0",

package/remoteRun/runner.sh

@@ -5,11 +5,18 @@
 # the runner's work dir first:   runner.sh <subcommand> <workDir> [arguments…]
 # Pueue is reached through PUEUE_BIN / PUEUE_CONFIG (both optional), set by the caller on every call.
 #
+# A PAIRED runner (`charness-runner`, src/runnerUtility) keeps its work dir as <state>/work in its own state folder; `probe` reads three
+# files there and reports them — nothing else in this script knows about pairing. A hand-made runner has none of them:
+#   <state>/paused          exists → paused=yes (written by `charness-runner pause`; the main box never sends a job to a paused runner)
+#   <state>/service         one word: user-service | system-service (no file = run by hand: service=foreground)
+#   <state>/ios-check.json  the runner's iOS Simulator boot check (one JSON line): "status": "pass"|"fail"|"skipped" and "reason": "…"|null
+# <state> counts only when it holds config.json and keys/ (a work dir that merely is called «work» is not one).
+#
 # bash 3.2-compatible on purpose (the stock bash of macOS): no associative arrays, no `wait -n`, no `mapfile`, no
 # `timeout(1)`, no `read -t` (its timeout status differs between 3.2 and 4+), no GNU-only flags. Time limits are done by background watchdogs.
 #
 # Subcommands (the contract is in src/remoteRun/README.md):
-#   probe        key=value lines: OS, CPU, RAM, disk, jobs, capabilities
+#   probe        key=value lines: OS, CPU, RAM, disk, jobs, capabilities (paused / service / iOS boot check of a paired runner)
 #   prepare      layout for a job, Pueue daemon + groups, prune
 #   lease        add the job to Pueue, stream its log, kill it when the caller's heartbeat stops (foreground run)
 #   submit       add the job to Pueue and return (--bg)
@@ -123,6 +130,14 @@ read_file() {
   cat "$1" 2>/dev/null
 }
 
+# A Mac that idle-sleeps in the middle of a job drops the link and stalls the build: while the process $1 runs, `caffeinate -i -w` holds
+# the idle-sleep assertion and ends by itself with it. A sibling, not a wrapper: the command keeps its own signals and exit status.
+# Nothing on other systems, or where caffeinate is missing.
+keep_awake_while() {
+  [ "$(uname -s)" = Darwin ] && command -v caffeinate > /dev/null 2>&1 || return 0
+  caffeinate -i -w "$1" > /dev/null 2>&1 < /dev/null &
+}
+
 # ─────────────────────────── probe ───────────────────────────
 
 kb_to_mb() {
@@ -305,12 +320,29 @@ probe_slow() {
   elif [ "$(probe_step_status xcode)" = 0 ]; then
     local xcode_version
     xcode_version=$(probe_step_output xcode | head -n 1 | sed 's/^Xcode //')
-    echo "cap_ios=yes"
-    if [ "$(probe_step_status simctl)" = 0 ]; then
-      echo "cap_ios_detail=Xcode $xcode_version, $(probe_step_output simctl | grep -c '(Shutdown)\|(Booted)') simulators"
+    if [ "${ios_boot_status:-}" = failed ]; then
+      # Xcode is there, but the runner's own check failed. The Simulator refusing to boot is Apple's rule (none is available outside a login
+      # session); any other reason (no runtime installed, the device could not be created) is shown as it is — the login session would be a
+      # wrong cure. «the Simulator did not» is `iosBootFailureReasonPrefix` in runnerUtility/iosCheck.ts.
+      echo "cap_ios=no"
+      case "$ios_boot_detail" in
+        "the Simulator did not"*) echo "cap_ios_detail=needs the runner user's login session" ;;
+        ?*) echo "cap_ios_detail=the iOS Simulator check failed: $ios_boot_detail" ;;
+        *) echo "cap_ios_detail=the iOS Simulator check failed" ;;
+      esac
+    elif [ -n "$runner_state" ] && [ -z "$ios_boot_status" ]; then
+      # A paired runner writes its record every time its link starts: none yet means the check of THIS start is still running, and an
+      # answer from an earlier start (another account, another kind of service) must not be offered meanwhile.
+      echo "cap_ios=no"
+      echo "cap_ios_detail=the iOS Simulator is being checked"
     else
-      # A slow simctl is no reason to say there is no Xcode, nor to invent a simulator count.
-      echo "cap_ios_detail=Xcode $xcode_version"
+      echo "cap_ios=yes"
+      if [ "$(probe_step_status simctl)" = 0 ]; then
+        echo "cap_ios_detail=Xcode $xcode_version, $(probe_step_output simctl | grep -c '(Shutdown)\|(Booted)') simulators"
+      else
+        # A slow simctl is no reason to say there is no Xcode, nor to invent a simulator count.
+        echo "cap_ios_detail=Xcode $xcode_version"
+      fi
     fi
   else
     echo "cap_ios=no"
@@ -333,9 +365,49 @@ probe_slow() {
   rm -rf "$probe_dir"
 }
 
+# The state folder of the charness-runner this work dir belongs to (sets runner_state; empty for a hand-made runner), and what it says
+# about the machine: sets ios_boot_status (ok | failed | unchecked, empty off a Mac or without a check) and ios_boot_detail.
+read_runner_state() {
+  runner_state=
+  ios_boot_status=
+  ios_boot_detail=
+  local candidate
+  candidate=$(dirname "$work")
+  [ "$(basename "$work")" = work ] && [ -f "$candidate/config.json" ] && [ -d "$candidate/keys" ] || return 0
+  runner_state=$candidate
+  local check="$runner_state/ios-check.json"
+  [ -f "$check" ] || return 0
+  if grep -q '"status"[[:space:]]*:[[:space:]]*"pass"' "$check"; then
+    ios_boot_status=ok
+  elif grep -q '"status"[[:space:]]*:[[:space:]]*"fail"' "$check"; then
+    ios_boot_status=failed
+  else
+    ios_boot_status=unchecked
+  fi
+  ios_boot_detail=$(sed -n 's/.*"reason"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$check" | head -n 1)
+}
+
+# paused= / service= / runner_version= / ios_boot= of a paired runner (nothing for a hand-made one).
+probe_runner_state() {
+  [ -n "$runner_state" ] || return 0
+  if [ -f "$runner_state/paused" ]; then echo "paused=yes"; else echo "paused=no"; fi
+  local service
+  service=$(head -n 1 "$runner_state/service" 2> /dev/null)
+  case $service in
+    user-service | system-service) echo "service=$service" ;;
+    '') echo "service=foreground" ;;
+    *) echo "service=unknown" ;;
+  esac
+  echo "runner_version=$(sed -n 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$runner_state/current/package.json" 2> /dev/null | head -n 1)"
+  [ -n "$ios_boot_status" ] && echo "ios_boot=$ios_boot_status"
+  [ -n "$ios_boot_detail" ] && echo "ios_boot_detail=$ios_boot_detail"
+  return 0
+}
+
 cmd_probe() {
   work=$1
   mkdir -p "$work" 2> /dev/null
+  read_runner_state
   echo "os=$(uname -s)"
   echo "arch=$(uname -m)"
   echo "kernel=$(uname -r)"
@@ -347,6 +419,7 @@ cmd_probe() {
   probe_jobs
   probe_android
   probe_playwright
+  probe_runner_state
 }
 
 # ─────────────────────────── pueue ───────────────────────────
@@ -962,6 +1035,7 @@ run_step() {
     exec bash -c "$command_text"
   ) < /dev/null &
   local step_pid=$!
+  keep_awake_while "$step_pid"
   # The notices bash prints when it reaps a signalled child ("Terminated") are not the job's output.
   { wait "$step_pid"; } 2> /dev/null
   step_code=$?
@@ -1155,6 +1229,7 @@ cmd_exec() {
   set -m
   ( cd "$tree/$subfolder" && exec bash -c "$*" ) < /dev/null &
   local exec_pid=$!
+  keep_awake_while "$exec_pid"
   set +m
   (
     if ! watch_lease "$lease_sec"; then