charness 3.7.0 → 3.8.0

package/dist/runners/runnersList.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceKindLabels = void 0;
+exports.formatListTimestamp = formatListTimestamp;
+exports.formatRunnerListLine = formatRunnerListLine;
+exports.formatRunnerList = formatRunnerList;
+/**
+ * @description The text of `charness runners ls`: one line per paired runner (name, online or offline since when, paused, OS, how it
+ * is kept running, version) and a line for each pairing code still open. Pure: the status is read by the caller.
+ */
+exports.serviceKindLabels = {
+    foreground: 'run by hand',
+    'user-service': 'user service',
+    'system-service': 'system service',
+    unknown: 'service unknown',
+};
+/** @description `2026-11-01 14:05` in the zone of this process. */
+function formatListTimestamp(epochMs) {
+    const date = new Date(epochMs);
+    const pad = (value) => value.toString().padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+function describeConnection(status) {
+    if (status.isOnline)
+        return 'online';
+    return status.lastSeenMs === null ? 'offline, never connected' : `offline since ${formatListTimestamp(status.lastSeenMs)}`;
+}
+function formatRunnerListLine(entry) {
+    const { runner, status } = entry;
+    const parts = [
+        describeConnection(status),
+        ...(runner.isPaused ? ['paused'] : []),
+        `${runner.os} (${runner.arch})`,
+        exports.serviceKindLabels[runner.serviceKind],
+        `charness ${runner.version}`,
+        `paired ${formatListTimestamp(runner.pairedAtMs)}`,
+    ];
+    return `${runner.name} — ${parts.join(' · ')}`;
+}
+/** @description The whole `ls` output. */
+function formatRunnerList(entries, pending, nowMs) {
+    const lines = entries.length === 0 ? ['No runners paired yet. `charness runners pair --host <address>` makes a pairing line.'] : entries.map(formatRunnerListLine);
+    const open = pending.filter((pairing) => pairing.expiresAtMs > nowMs);
+    if (open.length > 0) {
+        lines.push('', ...open.map((pairing) => `Pairing code open until ${formatListTimestamp(pairing.expiresAtMs)} (${pairing.host}:${pairing.port})`));
+    }
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=runnersList.js.map

package/dist/runners/runnersList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnersList.js","sourceRoot":"","sources":["../../src/runners/runnersList.ts"],"names":[],"mappings":";;;AAqBA,kDAIC;AAOD,oDAWC;AAGD,4CAOC;AAlDD;;;GAGG;AAEU,QAAA,iBAAiB,GAAsC;IAClE,UAAU,EAAE,aAAa;IACzB,cAAc,EAAE,cAAc;IAC9B,gBAAgB,EAAE,gBAAgB;IAClC,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AAOF,mEAAmE;AACnE,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzE,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACtI,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAwB;IAClD,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,iBAAiB,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;AAC7H,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAsB;IACzD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACjC,MAAM,KAAK,GAAG;QACZ,kBAAkB,CAAC,MAAM,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,GAAG;QAC/B,yBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC;QACrC,YAAY,MAAM,CAAC,OAAO,EAAE;QAC5B,UAAU,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;KACnD,CAAC;IACF,OAAO,GAAG,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,0CAA0C;AAC1C,SAAgB,gBAAgB,CAAC,OAAmC,EAAE,OAAkC,EAAE,KAAa;IACrH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,uFAAuF,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACnK,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,2BAA2B,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACpJ,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/runners/runnersOverview.d.ts

@@ -0,0 +1,20 @@
+import type { RunnerScreenEntry } from '../utils/runnersScreenPlan';
+import type { HubContext } from './hubPaths';
+/**
+ * @description What the `/runners` screen shows, read in two steps so it can open at once: {@link readRunnersOverview} is the registry,
+ * the links (does the socket accept?) and the last snapshot each machine left — no ssh, milliseconds — and
+ * {@link probeRunnersOverview} asks the machines that are online what they are like right now (one shared 20 s deadline, the phase-1
+ * probe), keeping the snapshot of a machine that does not answer.
+ */
+export interface RunnersOverview {
+    /** The registry revision (`paired.json` `rev`): what a keyboard built from this overview is valid for. */
+    revision: number;
+    entries: RunnerScreenEntry[];
+    /** Expiry of every pairing code that is still open. */
+    openPairingExpiries: number[];
+}
+/** @description The overview without any ssh call: the registry, which links are up, the last snapshots. */
+export declare function readRunnersOverview(ctx: HubContext, cacheDir: string, nowMs: number): Promise<RunnersOverview>;
+/** @description `overview` with the machines that are online asked for their live state. Offline ones are not called. */
+export declare function probeRunnersOverview(ctx: HubContext, overview: RunnersOverview, cacheDir: string, nowMs: number): Promise<RunnersOverview>;
+//# sourceMappingURL=runnersOverview.d.ts.map

package/dist/runners/runnersOverview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnersOverview.d.ts","sourceRoot":"","sources":["../../src/runners/runnersOverview.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,0GAA0G;IAC1G,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAQD,4GAA4G;AAC5G,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAOpH;AASD,yHAAyH;AACzH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBhJ"}

package/dist/runners/runnersOverview.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRunnersOverview = readRunnersOverview;
+exports.probeRunnersOverview = probeRunnersOverview;
+const pairedRunners_1 = require("../remoteRun/pairedRunners");
+const runners_1 = require("../remoteRun/runners");
+const runnerClient_1 = require("../remoteRun/runnerClient");
+const ssh_1 = require("../remoteRun/ssh");
+const hubRegistry_1 = require("./hubRegistry");
+const linkControl_1 = require("./linkControl");
+async function readEntry(ctx, runner, cacheDir) {
+    const status = await (0, linkControl_1.getRunnerLinkStatus)(ctx.dir, runner.id);
+    const snapshot = (0, runners_1.readLastProbe)(cacheDir, runner.name);
+    return { runner, isOnline: status.isOnline, lastSeenMs: status.lastSeenMs ?? snapshot?.seenAtMs ?? null, probe: snapshot?.probe ?? null };
+}
+/** @description The overview without any ssh call: the registry, which links are up, the last snapshots. */
+async function readRunnersOverview(ctx, cacheDir, nowMs) {
+    const paired = (0, hubRegistry_1.readPairedFile)(ctx.dir);
+    return {
+        revision: paired.rev,
+        entries: await Promise.all(paired.runners.map((runner) => readEntry(ctx, runner, cacheDir))),
+        openPairingExpiries: (0, hubRegistry_1.readPendingFile)(ctx.dir).pending.filter((pairing) => pairing.expiresAtMs > nowMs).map((pairing) => pairing.expiresAtMs),
+    };
+}
+function applyReport(entry, report) {
+    if (report === undefined)
+        return entry;
+    if (report.status === 'online')
+        return { ...entry, probe: report.probe };
+    // It answered the socket probe but not the ssh one: it is shown as it was, offline.
+    return { ...entry, isOnline: false, lastSeenMs: report.lastSeenAtMs ?? entry.lastSeenMs, probe: report.lastProbe ?? entry.probe };
+}
+/** @description `overview` with the machines that are online asked for their live state. Offline ones are not called. */
+async function probeRunnersOverview(ctx, overview, cacheDir, nowMs) {
+    const hub = { hubDir: ctx.dir, nodePath: ctx.nodePath, cliPath: ctx.cliPath };
+    const clients = overview.entries
+        .filter((entry) => entry.isOnline)
+        .flatMap((entry) => {
+        try {
+            return [(0, runnerClient_1.createRunnerClient)((0, pairedRunners_1.buildPairedRunnerConfig)(entry.runner, hub), cacheDir)];
+        }
+        catch (error) {
+            // A path of this machine that ssh cannot be given safely: that machine is shown as its last snapshot says, not probed.
+            if (error instanceof pairedRunners_1.PairedRunnerSetupError)
+                return [];
+            throw error;
+        }
+    });
+    if (clients.length === 0)
+        return overview;
+    (0, ssh_1.ensureRemoteRunCacheDir)(cacheDir);
+    const reports = await (0, runners_1.probeRunners)(clients, nowMs);
+    return { ...overview, entries: overview.entries.map((entry) => applyReport(entry, reports.find((report) => report.name === entry.runner.name))) };
+}
+//# sourceMappingURL=runnersOverview.js.map

package/dist/runners/runnersOverview.js.map

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

package/dist/runners/sshKeys.d.ts

@@ -0,0 +1,26 @@
+export interface SshKeyPair {
+    /** OpenSSH private key text (what `ssh -i` reads). */
+    privateKey: string;
+    /** `ssh-ed25519 <base64>`. */
+    publicKey: string;
+}
+export interface ParsedPublicKey {
+    type: string;
+    /** The key as the ssh wire protocol carries it (what a host key verifier is handed). */
+    blob: Buffer;
+}
+/**
+ * @description A new ed25519 pair; `comment` is kept in the private key only. `ssh2`'s generator drops a leading zero byte of the key
+ * now and then (about 1 key in 300 comes out with a 31-byte public key, which neither `ssh2` nor OpenSSH can read), so every pair is
+ * read back before it is returned and a bad one is made again.
+ */
+export declare function generateEd25519KeyPair(comment: string): SshKeyPair;
+/** @description `value` as a public key, or `null` when it is not exactly `<type> <base64>`. */
+export declare function parsePublicKey(value: string): ParsedPublicKey | null;
+/** @description Is `value` a public key of the type charness issues to runners and the hub — ed25519 — in the strict form? */
+export declare function checkIsEd25519PublicKey(value: string): boolean;
+/** @description `SHA256:…`, the fingerprint `ssh-keygen -l` prints. */
+export declare function getPublicKeyFingerprint(publicKey: string): string;
+/** @description A random identifier (12 lowercase hex digits) safe in a file name, a shell word, an `authorized_keys` option and as the first word of an argument list. */
+export declare function createRandomId(): string;
+//# sourceMappingURL=sshKeys.d.ts.map

package/dist/runners/sshKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sshKeys.d.ts","sourceRoot":"","sources":["../../src/runners/sshKeys.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CASlE;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAKpE;AAED,8HAA8H;AAC9H,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,2KAA2K;AAC3K,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/runners/sshKeys.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEd25519KeyPair = generateEd25519KeyPair;
+exports.parsePublicKey = parsePublicKey;
+exports.checkIsEd25519PublicKey = checkIsEd25519PublicKey;
+exports.getPublicKeyFingerprint = getPublicKeyFingerprint;
+exports.createRandomId = createRandomId;
+const crypto_1 = require("crypto");
+const ssh2_1 = require("ssh2");
+/**
+ * @description The few things charness does with ssh keys: make an ed25519 pair (the runner's own, the hub's, a pairing's temporary
+ * one), write a public key the way `authorized_keys` and `known_hosts` read it, and its fingerprint. Public keys are kept as the
+ * two-field `<type> <base64>` text — no comment — and checked against a strict pattern before they are ever written into a file
+ * sshd reads: a key that carried a newline or an option would be a line of its own.
+ */
+const base64Alphabet = 'A-Za-z0-9+/';
+const publicKeyPattern = new RegExp(`^(ssh-ed25519|ecdsa-sha2-nistp(?:256|384|521)|ssh-rsa) ([${base64Alphabet}]+={0,2})$`);
+const ed25519Type = 'ssh-ed25519';
+const idByteLength = 6;
+/** The odds of a bad key are about 1 in 300: ten tries in a row failing is not luck. */
+const maxKeyGenerationAttempts = 10;
+/**
+ * @description A new ed25519 pair; `comment` is kept in the private key only. `ssh2`'s generator drops a leading zero byte of the key
+ * now and then (about 1 key in 300 comes out with a 31-byte public key, which neither `ssh2` nor OpenSSH can read), so every pair is
+ * read back before it is returned and a bad one is made again.
+ */
+function generateEd25519KeyPair(comment) {
+    for (let attempt = 0; attempt < maxKeyGenerationAttempts; attempt += 1) {
+        const generated = ssh2_1.utils.generateKeyPairSync('ed25519', { comment });
+        const publicKey = generated.public.split(' ').slice(0, 2).join(' ');
+        if (!(ssh2_1.utils.parseKey(publicKey) instanceof Error) && !(ssh2_1.utils.parseKey(generated.private) instanceof Error)) {
+            return { privateKey: generated.private, publicKey };
+        }
+    }
+    throw new Error('could not generate a readable ed25519 key');
+}
+/** @description `value` as a public key, or `null` when it is not exactly `<type> <base64>`. */
+function parsePublicKey(value) {
+    const match = publicKeyPattern.exec(value);
+    if (match === null)
+        return null;
+    const blob = Buffer.from(match[2], 'base64');
+    return blob.length === 0 ? null : { type: match[1], blob };
+}
+/** @description Is `value` a public key of the type charness issues to runners and the hub — ed25519 — in the strict form? */
+function checkIsEd25519PublicKey(value) {
+    return parsePublicKey(value)?.type === ed25519Type;
+}
+/** @description `SHA256:…`, the fingerprint `ssh-keygen -l` prints. */
+function getPublicKeyFingerprint(publicKey) {
+    const parsed = parsePublicKey(publicKey);
+    if (parsed === null)
+        throw new Error('not a public key');
+    return `SHA256:${(0, crypto_1.createHash)('sha256').update(parsed.blob).digest('base64').replace(/=+$/, '')}`;
+}
+/** @description A random identifier (12 lowercase hex digits) safe in a file name, a shell word, an `authorized_keys` option and as the first word of an argument list. */
+function createRandomId() {
+    return (0, crypto_1.randomBytes)(idByteLength).toString('hex');
+}
+//# sourceMappingURL=sshKeys.js.map

package/dist/runners/sshKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sshKeys.js","sourceRoot":"","sources":["../../src/runners/sshKeys.ts"],"names":[],"mappings":";;AAmCA,wDASC;AAGD,wCAKC;AAGD,0DAEC;AAGD,0DAIC;AAGD,wCAEC;AArED,mCAAiD;AACjD,+BAA6B;AAE7B;;;;;GAKG;AAEH,MAAM,cAAc,GAAG,aAAa,CAAC;AACrC,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,4DAA4D,cAAc,YAAY,CAAC,CAAC;AAC5H,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,wFAAwF;AACxF,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAepC;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,OAAe;IACpD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,wBAAwB,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,SAAS,GAAG,YAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,CAAC,YAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,YAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC3G,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AAC/D,CAAC;AAED,gGAAgG;AAChG,SAAgB,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,8HAA8H;AAC9H,SAAgB,uBAAuB,CAAC,KAAa;IACnD,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,WAAW,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,SAAgB,uBAAuB,CAAC,SAAiB;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACzD,OAAO,UAAU,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,2KAA2K;AAC3K,SAAgB,cAAc;IAC5B,OAAO,IAAA,oBAAW,EAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC"}

package/dist/runners/tarArchive.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @description A minimal, DETERMINISTIC tar writer (ustar): the same entries always give the same bytes, so the hash of the archive is
+ * a stable id of the package it carries (a system `tar` writes its own timestamps and ordering). Regular files only — a runner
+ * extracts the archive with the `tar` of its machine, which creates the folders on the way.
+ */
+export interface TarEntry {
+    /** A relative path with `/` separators. */
+    path: string;
+    content: Buffer;
+    /** `0o755` for something that runs, else `0o644`. */
+    mode: number;
+}
+/** @description The ustar `name` and `prefix` fields for `entryPath`, or `null` when no `/` splits it into pieces that fit. */
+export declare function splitTarPath(entryPath: string): {
+    name: string;
+    prefix: string;
+} | null;
+/** @description The archive of `entries`, in the order given, ended by the two empty blocks tar expects. */
+export declare function createTarArchive(entries: readonly TarEntry[]): Buffer;
+//# sourceMappingURL=tarArchive.d.ts.map

package/dist/runners/tarArchive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarArchive.d.ts","sourceRoot":"","sources":["../../src/runners/tarArchive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,+HAA+H;AAC/H,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQvF;AAwBD,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CASrE"}

package/dist/runners/tarArchive.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * @description A minimal, DETERMINISTIC tar writer (ustar): the same entries always give the same bytes, so the hash of the archive is
+ * a stable id of the package it carries (a system `tar` writes its own timestamps and ordering). Regular files only — a runner
+ * extracts the archive with the `tar` of its machine, which creates the folders on the way.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitTarPath = splitTarPath;
+exports.createTarArchive = createTarArchive;
+const blockSize = 512;
+/** 2000-01-01: a fixed, plausible timestamp (GNU tar warns about a 1970 one). */
+const fixedModifiedTimeSeconds = 946684800;
+const maxNameLength = 100;
+const maxPrefixLength = 155;
+const checksumFieldOffset = 148;
+const checksumFieldLength = 8;
+function writeText(header, offset, length, text) {
+    header.write(text, offset, length, 'utf8');
+}
+/** An octal number, zero-padded to `length - 1` digits and ended by a NUL. */
+function writeOctal(header, offset, length, value) {
+    header.write(value.toString(8).padStart(length - 1, '0'), offset, length - 1, 'ascii');
+}
+/** @description The ustar `name` and `prefix` fields for `entryPath`, or `null` when no `/` splits it into pieces that fit. */
+function splitTarPath(entryPath) {
+    if (Buffer.byteLength(entryPath) <= maxNameLength)
+        return { name: entryPath, prefix: '' };
+    for (let slash = entryPath.indexOf('/'); slash !== -1; slash = entryPath.indexOf('/', slash + 1)) {
+        const prefix = entryPath.slice(0, slash);
+        const name = entryPath.slice(slash + 1);
+        if (Buffer.byteLength(prefix) <= maxPrefixLength && Buffer.byteLength(name) <= maxNameLength)
+            return { name, prefix };
+    }
+    return null;
+}
+function buildHeader(entry) {
+    const split = splitTarPath(entry.path);
+    if (split === null)
+        throw new Error(`the path is too long for a tar header: ${entry.path}`);
+    const header = Buffer.alloc(blockSize);
+    writeText(header, 0, maxNameLength, split.name);
+    writeOctal(header, 100, 8, entry.mode);
+    writeOctal(header, 108, 8, 0);
+    writeOctal(header, 116, 8, 0);
+    writeOctal(header, 124, 12, entry.content.length);
+    writeOctal(header, 136, 12, fixedModifiedTimeSeconds);
+    header.fill(0x20, checksumFieldOffset, checksumFieldOffset + checksumFieldLength);
+    header.write('0', 156, 1, 'ascii');
+    header.write('ustar\0', 257, 6, 'ascii');
+    header.write('00', 263, 2, 'ascii');
+    writeText(header, 345, maxPrefixLength, split.prefix);
+    const checksum = header.reduce((sum, byte) => sum + byte, 0);
+    header.write(checksum.toString(8).padStart(6, '0'), checksumFieldOffset, 6, 'ascii');
+    header[checksumFieldOffset + 6] = 0;
+    header[checksumFieldOffset + 7] = 0x20;
+    return header;
+}
+/** @description The archive of `entries`, in the order given, ended by the two empty blocks tar expects. */
+function createTarArchive(entries) {
+    const parts = [];
+    for (const entry of entries) {
+        parts.push(buildHeader(entry), entry.content);
+        const remainder = entry.content.length % blockSize;
+        if (remainder !== 0)
+            parts.push(Buffer.alloc(blockSize - remainder));
+    }
+    parts.push(Buffer.alloc(blockSize * 2));
+    return Buffer.concat(parts);
+}
+//# sourceMappingURL=tarArchive.js.map

package/dist/runners/tarArchive.js.map

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

package/dist/scheduler/mcpSurface.d.ts

@@ -75,6 +75,11 @@ export declare const schedulerMcpBindRetryDelayMs = 500;
 export declare const schedulerMcpPendingCancellationTtlMs = 30000;
 /** Global memory bound shared by pending-cancellation and recent-completion tombstones. */
 export declare const schedulerMcpPendingCancellationMax = 1000;
+/**
+ * Claude Code cuts a server's connect-time `instructions` that are longer than this: whatever comes last is lost, silently. The Telegram
+ * text is within a few hundred characters of it before the remote-run bullet, so the runner lines are fitted to the room that is left.
+ */
+export declare const claudeCodeInstructionsMaxLength = 4096;
 /** What the `claude_profiles` tool asks the bot: the model, and for a resumed session the account it last ran on. */
 export interface ClaudeProfilesQuery {
     model: string | null;
@@ -91,8 +96,8 @@ export interface ClaudeProfilesQuery {
 export interface OptionalBotTools {
     isJiraAttachmentToolOffered: boolean;
     isTodoToolOffered: boolean;
-    /** At least one runner is listed in `runners.json`: the instructions name `charness remote-run`. */
-    isRemoteRunOffered: boolean;
+    /** One line per runner that is paired or listed in `runners.json` (`remoteRun/runnerSummary.ts`); none = the instructions do not mention `charness remote-run`. */
+    remoteRunRunnerLines: readonly string[];
 }
 /**
  * Connect-time `instructions` returned in the MCP `initialize` handshake — a
@@ -228,10 +233,11 @@ export interface SchedulerMcpDeps {
      */
     listClaudeProfiles?: (query: ClaudeProfilesQuery) => Promise<ClaudeProfilesReport>;
     /**
-     * Is any runner for `charness remote-run` configured (`runners.json`, `remoteRun/runnersConfig.ts`)? Asked at every connect, so
-     * adding the first runner shows in the next session's instructions; absent or false = the instructions do not mention it.
+     * One line per runner `charness remote-run` can use — paired or in `runners.json` (`remoteRun/runnerSummary.ts`): name, OS, what it could do
+     * when last probed. Asked at every connect, so a runner added, removed or paused shows in the next session's instructions; absent or empty =
+     * the instructions do not mention remote-run.
      */
-    isRemoteRunOffered?: () => boolean;
+    getRemoteRunRunnerLines?: () => readonly string[];
     /**
      * Where the surface leaves one diagnostic line when it REFUSES a tool call for an unknown input key. The SDK checks
      * the input before any of the bot's code runs, so without this a client that adds a key of its own to every call

package/dist/scheduler/mcpSurface.d.ts.map

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

package/dist/scheduler/mcpSurface.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.answerReplyToCommentIdsMaxCount = exports.schedulerMcpPendingCancellationMax = exports.schedulerMcpPendingCancellationTtlMs = exports.schedulerMcpBindRetryDelayMs = exports.schedulerMcpBindRetryCount = exports.legacySchedulerMcpClientIdHeader = exports.schedulerMcpClientIdHeader = exports.schedulerMcpPath = exports.defaultSchedulerMcpPort = void 0;
+exports.answerReplyToCommentIdsMaxCount = exports.claudeCodeInstructionsMaxLength = exports.schedulerMcpPendingCancellationMax = exports.schedulerMcpPendingCancellationTtlMs = exports.schedulerMcpBindRetryDelayMs = exports.schedulerMcpBindRetryCount = exports.legacySchedulerMcpClientIdHeader = exports.schedulerMcpClientIdHeader = exports.schedulerMcpPath = exports.defaultSchedulerMcpPort = void 0;
 exports.buildMcpServerInstructions = buildMcpServerInstructions;
 exports.getSchedulerMcpPort = getSchedulerMcpPort;
 exports.resolveSchedulerMcpPort = resolveSchedulerMcpPort;
@@ -118,13 +118,34 @@ const mcpServerVersion = '1.0.0';
 /** The skill an orchestrating agent loads in a bot session, as each CLI names it. */
 const managerSkillInstruction = 'load the `charness-manager` skill (Claude Code lists it as `charness:charness-manager`) and follow it instead of any other manager skill';
 /** The instruction bullets that hold on every platform (the two platform-neutral tools). */
-const compactConversationInstruction = '• The user EXPLICITLY asks to compact/shrink/summarize this conversation\'s context → compact_conversation. Only on an explicit request, never on your own judgement.';
-const answerRequestInstruction = '• A message carries a "[Request <id> · from: …]" header → answer it through answer_request with that id: kind "final" with the full result at the end of your turn, "question" when you need the requester before you can go on (their reply arrives as a new request), "progress" for an interim note. You may call it several times; only question/final close the request. ' +
+const compactConversationInstruction = '• The user EXPLICITLY asks to compact/shrink/summarize this conversation\'s context → compact_conversation. Never on your own judgement.';
+const answerRequestInstruction = '• A message carries a "[Request <id> · from: …]" header → answer it through answer_request with that id: kind "final" with the full result at the end of your turn, "question" when you need the requester before you can go on (their reply arrives as a new request), "progress" for an interim note. Only question/final close the request. ' +
     answerStyle_1.answerStyleInstruction;
 /** The shared todo registry's bullet (D7) — Telegram topics and Jira issues publish alike. */
-const todoInstruction = '• BEFORE you start any task (fixes you found yourself included: a failing test, a leak) → todo_update adds it as inWork, naming the area concretely (files, tests). Check the returned board for overlap with other agents. Take the queue top-down; mark items done / dropped at once. A ticket you create in a tracker gets an item with its key in `ref`.';
-/** The `charness remote-run` bullet — present only while `runners.json` lists a runner, for Telegram topics and tracker issues alike. */
-const remoteRunInstruction = '• Heavy work (a test suite, a build, an e2e run) can run on a runner machine instead of this one → `charness remote-run runners` shows which runners are online with their CPU, RAM, disk, load and what each can do (android, ios, docker, playwright); then `charness remote-run [--needs <capability>] <command>` runs the command in a copy of this git project there and gives you its output, exit code and declared result files as if it ran here (edit files only here; an interrupt or tool timeout kills the remote job). Longer than your tool timeout: `charness remote-run --bg <command>` prints a job id, then run `charness remote-run wait <id>` in the background (it blocks until the job ends and exits with its code); `ls`, `status <id>`, `logs <id> -f`, `kill <id>` manage jobs.';
+const todoInstruction = '• BEFORE you start any task (fixes you found yourself included: a failing test, a leak) → todo_update adds it as inWork, naming the area (files, tests). Check the returned board for overlap with other agents. Take the queue top-down; mark items done / dropped at once. A ticket you create in a tracker gets an item with its key in `ref`.';
+/** The `charness remote-run` bullet — present only while a runner is paired or listed in `runners.json`, for Telegram topics and tracker issues alike. The CLI's own `--help` has the job commands. */
+const remoteRunInstruction = '• Heavy work (test suite, build, e2e run) → send it to a runner, not this machine: `charness remote-run runners` lists them and what each can do; `charness remote-run [--needs android|ios|docker|playwright] <command>` runs it in a copy of this project and returns its output and exit code (edit files only here). Longer than your tool timeout: `charness remote-run --bg <command>`, then `charness remote-run wait <id>` in the background; `charness remote-run --help` lists the rest.';
+/**
+ * Claude Code cuts a server's connect-time `instructions` that are longer than this: whatever comes last is lost, silently. The Telegram
+ * text is within a few hundred characters of it before the remote-run bullet, so the runner lines are fitted to the room that is left.
+ */
+exports.claudeCodeInstructionsMaxLength = 4096;
+/**
+ * The remote-run bullet with one line per runner under it (`mac — macOS 15.1, android, playwright`: the name, the OS, what it could do when
+ * last probed): the first `shownCount` runners, and «… and N more» for the rest. The lines are a snapshot taken at connect; `charness
+ * remote-run runners` has the live state. `shownCount` 0 gives the bullet alone.
+ */
+function buildRemoteRunInstruction(runnerLines, shownCount) {
+    if (shownCount === 0)
+        return remoteRunInstruction;
+    const hiddenCount = runnerLines.length - shownCount;
+    return [
+        remoteRunInstruction,
+        '  Runners, as last seen:',
+        ...runnerLines.slice(0, shownCount).map((line) => `  – ${line}`),
+        ...(hiddenCount > 0 ? [`  – … and ${hiddenCount} more`] : []),
+    ].join('\n');
+}
 const orchestrationInstructionHead = '• You orchestrate detached workers (a `claude -p` / `opencode run` builder, reviewer, researcher) →';
 /** What the worker-watch recipe says once a tool is named: shared by both wordings of the Telegram bullet. */
 const workerWatchRecipeText = `its description has the recipe (checkCommand, cron, \`${workerWatch_1.workerWatchPinArgument}\`); never \`kill -0\` alone: it never fires on a hung worker.`;
@@ -141,30 +162,30 @@ function buildTelegramOrchestrationInstruction(isBotSkillsEnabled) {
         ? `${orchestrationInstructionHead} ${managerSkillInstruction}. Watch EACH worker with schedule_create — ${workerWatchRecipeText}`
         : `${orchestrationInstructionHead} schedule_create to watch EACH worker — ${workerWatchRecipeText}`;
 }
-const claudeProfilesInstruction = '• Before you start or resume a child `claude` process (a detached worker, reviewer, planner) → claude_profiles with the model you will launch: it lists the signed-in Claude accounts with their usage windows and names the one to run on (`recommended`: the account whose weekly limit resets soonest is spent first). A new child: no `currentProfile`; a resumed one: the profile it last ran on, plus `isStoppedByLimit: true` when it broke off on a usage limit. Launch the child with `CLAUDE_CONFIG_DIR=<its configDir>` in its environment (nothing when configDir is null); without it the child inherits YOUR account and drains the same limits. `recommended: null` → nothing is usable now: schedule one resume at `nextAvailable.at` (null too: tell the user, retry once in about 30 minutes).';
+const claudeProfilesInstruction = '• Before you start or resume a child `claude` process (worker, reviewer, planner) → claude_profiles with the model you will launch, and start the child under the account it names (`CLAUDE_CONFIG_DIR=<configDir>`): without it the child inherits YOUR account and drains the same limits. The tool description has the rest (resuming, `recommended: null`).';
 /** @description Which optional tools `deps` offers. */
 function getOptionalBotTools(deps) {
     return {
         isJiraAttachmentToolOffered: deps.fetchJiraAttachment !== undefined,
         isTodoToolOffered: deps.todos !== undefined,
-        isRemoteRunOffered: deps.isRemoteRunOffered?.() ?? false,
+        remoteRunRunnerLines: deps.getRemoteRunRunnerLines?.() ?? [],
     };
 }
-function buildTelegramInstructions(isTodoToolOffered, isRemoteRunOffered, isBotSkillsEnabled) {
+function buildTelegramInstructions(isTodoToolOffered, remoteRunInstructionText, isBotSkillsEnabled) {
     return `This MCP lets the agent act on its own Telegram topic.
 
 When to use it:
-• The user asks to run/finish a plan or task LATER ("in 2h", "tomorrow 9am", "every weekday") → schedule_create. Put the work in \`prompt\`; the future run is a fresh session with no memory of this chat. Not CronCreate / ScheduleWakeup for anything that must happen: they live only in your process, which the bot stops after a long idle stretch, and die with it.
-• You produced a file/chart/screenshot/video to deliver → send_file_to_user. Videos MUST be H.264 .mp4 sent as video (never as_file/document, never .webm/.mov — those render as GIFs or don't play); transcode first if needed (the tool description has the ffmpeg recipe).
-• You want to deliver SEVERAL discrete messages (each as its own Telegram message, e.g. a per-item news digest) → send_messages_to_user. Each item can optionally attach ONE file/photo/video (text becomes its caption).
+• The user asks to run/finish a plan or task LATER ("in 2h", "tomorrow 9am", "every weekday") → schedule_create. Put the work in \`prompt\`; the future run is a fresh session with no memory of this chat. Not CronCreate / ScheduleWakeup for anything that must happen: they die with your process, which the bot stops after a long idle stretch.
+• You produced a file/chart/screenshot/video to deliver → send_file_to_user. Videos MUST be H.264 .mp4 sent as video (never as_file/document or .webm/.mov — those render as GIFs or don't play); transcode first if needed (recipe in the tool description).
+• You want to deliver SEVERAL discrete messages (each its own message, e.g. a per-item news digest) → send_messages_to_user; an item may attach ONE file (the text becomes its caption).
 ${compactConversationInstruction}
 ${isTodoToolOffered ? `${todoInstruction}\n` : ''}• You need to review or remove scheduled jobs → schedule_list / schedule_cancel.
-• You need a watchdog — keep an eye on a service, process, build, deploy, disk, URL… → schedule_create with \`checkCommand\` (cron). The bot runs the command in this folder on schedule, stays silent while it exits 0, and on the first failure pins an alert and wakes you with \`prompt\` + the exit code and output tail. Checks survive bot restarts and crashes. NEVER build your own watcher (a background loop, nohup, a sleep loop, a tmux pane, a shell crontab): it dies with your session or a restart and then fails silently.
+• You need a watchdog — keep an eye on a service, build, deploy, disk, URL… → schedule_create with \`checkCommand\` (cron): the bot runs it in this folder, stays silent while it exits 0, and on the first failure pins an alert and wakes you with \`prompt\` + the exit code and output tail. Checks survive restarts and crashes. NEVER build your own watcher (background loop, nohup, sleep loop, tmux pane, shell crontab): it dies with your session or a restart, silently.
 ${buildTelegramOrchestrationInstruction(isBotSkillsEnabled)}
-${answerRequestInstruction} The requester may not see your plain text, so anything they must read goes through answer_request. Your plain text is relayed into the topic too, so after answer_request end the turn WITHOUT a plain-text recap of what you answered — it would show up twice.
-${claudeProfilesInstruction}${isRemoteRunOffered ? `\n${remoteRunInstruction}` : ''}
+${answerRequestInstruction} The requester may not see your plain text: anything they must read goes through answer_request — yet your plain text is relayed into the topic too, so end the turn WITHOUT a recap of what you answered (it would show twice).
+${claudeProfilesInstruction}${remoteRunInstructionText === null ? '' : `\n${remoteRunInstructionText}`}
 
-Each tool's own description has the exact argument recipe (one-shot vs cron vs N-times, checks).`;
+Tool descriptions hold the argument recipes.`;
 }
 /** What a Jira session's instructions add: the tool that reaches the issue's original files (C10). */
 const jiraAttachmentInstruction = '• The issue lists a file (an attachment id in the attachments list, or in a placeholder such as "[image: shot.png — attachment 10234]") you need to look at → jira_get_attachment with that id; it saves the original file and returns its path.';
@@ -197,16 +218,28 @@ Each tool's own description has the exact argument recipe.`;
  * (`isBotSkillsEnabled`, `/bot_skills`) the orchestration bullet no longer tells it to load `charness-manager`.
  */
 function buildMcpServerInstructions(platform, offered, isBotSkillsEnabled) {
-    if (platform === 'telegram')
-        return buildTelegramInstructions(offered.isTodoToolOffered, offered.isRemoteRunOffered, isBotSkillsEnabled);
-    const remoteRunInstructions = offered.isRemoteRunOffered ? [remoteRunInstruction] : [];
-    if (platform !== 'jira')
-        return buildTrackerInstructions(remoteRunInstructions, isBotSkillsEnabled);
-    return buildTrackerInstructions([
-        ...(offered.isJiraAttachmentToolOffered ? [jiraAttachmentInstruction] : []),
-        ...(offered.isTodoToolOffered ? [todoInstruction] : []),
-        ...remoteRunInstructions,
-    ], isBotSkillsEnabled);
+    const render = (remoteRunInstructionText) => {
+        if (platform === 'telegram')
+            return buildTelegramInstructions(offered.isTodoToolOffered, remoteRunInstructionText, isBotSkillsEnabled);
+        const remoteRunInstructions = remoteRunInstructionText === null ? [] : [remoteRunInstructionText];
+        if (platform !== 'jira')
+            return buildTrackerInstructions(remoteRunInstructions, isBotSkillsEnabled);
+        return buildTrackerInstructions([
+            ...(offered.isJiraAttachmentToolOffered ? [jiraAttachmentInstruction] : []),
+            ...(offered.isTodoToolOffered ? [todoInstruction] : []),
+            ...remoteRunInstructions,
+        ], isBotSkillsEnabled);
+    };
+    const runnerCount = offered.remoteRunRunnerLines.length;
+    if (runnerCount === 0)
+        return render(null);
+    // As many runners as the room under Claude Code's cap leaves; the bullet itself always stays (its `runners` command is the full list).
+    for (let shownCount = runnerCount; shownCount > 0; shownCount -= 1) {
+        const text = render(buildRemoteRunInstruction(offered.remoteRunRunnerLines, shownCount));
+        if (text.length <= exports.claudeCodeInstructionsMaxLength)
+            return text;
+    }
+    return render(buildRemoteRunInstruction(offered.remoteRunRunnerLines, 0));
 }
 /** Max characters of a free-text job name / prompt accepted by a tool (defensive bound). */
 const maxNameLength = 200;