charness 3.6.0 → 3.7.0

package/dist/remoteRun/jobId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobId.js","sourceRoot":"","sources":["../../src/remoteRun/jobId.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,kCASC;AAGD,gCAGC;AAGD,kCAEC;AAGD,wCAIC;AAnDD,mCAAiD;AACjD,2CAA6B;AAE7B;;;;;;GAMG;AAEH,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,OAAO,GAAG,OAAO,CAAC;AACxB,MAAM,cAAc,GAAG,CAAC,CAAC;AAEZ,QAAA,gBAAgB,GAAG,KAAK,CAAC;AAEtC,MAAM,YAAY,GAAG,4CAA4C,CAAC;AAElE,yGAAyG;AACzG,SAAgB,WAAW,CAAC,UAAkB,EAAE,SAAmC,oBAAW;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACrC,IAAI,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,eAAe,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,cAAc,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;QAC1C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,2FAA2F;AAC3F,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,sEAAsE;AACtE,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,GAAG,wBAAgB,GAAG,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,uGAAuG;AACvG,SAAgB,cAAc,CAAC,WAAmB,EAAE,KAAwC;IAC1F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,IAAI,SAAS,CAAC;IAC/I,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,GAAG,IAAI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACjI,OAAO,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/remoteRun/jobMeta.d.ts

@@ -0,0 +1,18 @@
+export interface JobMeta {
+    id: string;
+    runner: string;
+    slug: string;
+    /** The project's root on the main box. */
+    projectRoot: string;
+    subfolder: string;
+    command: string;
+    submittedAtMs: number;
+    timeoutSeconds: number;
+    /** `<hostname>:<uid>` of the user who submitted: `ls --all` lists the jobs of THIS user only. */
+    owner: string;
+    group: string;
+    isBackground: boolean;
+}
+/** @description Parse a job's `meta.json`; `null` when it is not one. */
+export declare function parseJobMeta(text: string): JobMeta | null;
+//# sourceMappingURL=jobMeta.d.ts.map

package/dist/remoteRun/jobMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobMeta.d.ts","sourceRoot":"","sources":["../../src/remoteRun/jobMeta.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAOzD"}

package/dist/remoteRun/jobMeta.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJobMeta = parseJobMeta;
+const zod_1 = require("zod");
+/**
+ * @description What `meta.json` of a job holds: written by the main box at submit, kept on the runner next to the job, read back by `ls`
+ * and `status` — for DISPLAY only. The runner holds the file, so it can say anything in it: where a job's result files go is never read
+ * from here but from the main box's own record (`jobRecords.ts`).
+ */
+const jobMetaSchema = zod_1.z.looseObject({
+    id: zod_1.z.string(),
+    runner: zod_1.z.string(),
+    slug: zod_1.z.string(),
+    projectRoot: zod_1.z.string(),
+    subfolder: zod_1.z.string(),
+    command: zod_1.z.string(),
+    submittedAtMs: zod_1.z.number(),
+    timeoutSeconds: zod_1.z.number(),
+    owner: zod_1.z.string(),
+    group: zod_1.z.string(),
+    isBackground: zod_1.z.boolean(),
+});
+/** @description Parse a job's `meta.json`; `null` when it is not one. */
+function parseJobMeta(text) {
+    try {
+        const parsed = jobMetaSchema.safeParse(JSON.parse(text));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=jobMeta.js.map

package/dist/remoteRun/jobMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobMeta.js","sourceRoot":"","sources":["../../src/remoteRun/jobMeta.ts"],"names":[],"mappings":";;AAuCA,oCAOC;AA9CD,6BAAwB;AAExB;;;;GAIG;AAEH,MAAM,aAAa,GAAG,OAAC,CAAC,WAAW,CAAC;IAClC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE;CAC1B,CAAC,CAAC;AAkBH,yEAAyE;AACzE,SAAgB,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/remoteRun/jobQuery.d.ts

@@ -0,0 +1,12 @@
+import { type JobFacts, type JobOutcome } from './jobState';
+import type { RunnerClient } from './runnerClient';
+/**
+ * @description Ask a runner how a job is doing: its own files (`result`) first, Pueue's task list only when the job left no exit file
+ * (a hard kill) or has not started.
+ */
+/** The job's facts and what they mean. `slug` may be `-` for "the project this job id belongs to"; the answer names it. */
+export declare function readJobOutcome(client: RunnerClient, slug: string, jobId: string): Promise<{
+    facts: JobFacts;
+    outcome: JobOutcome;
+}>;
+//# sourceMappingURL=jobQuery.d.ts.map

package/dist/remoteRun/jobQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobQuery.d.ts","sourceRoot":"","sources":["../../src/remoteRun/jobQuery.ts"],"names":[],"mappings":"AACA,OAAO,EAAuD,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AAEH,2HAA2H;AAC3H,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC,CAOzI"}

package/dist/remoteRun/jobQuery.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readJobOutcome = readJobOutcome;
+const jobId_1 = require("./jobId");
+const jobState_1 = require("./jobState");
+const remoteRunError_1 = require("./remoteRunError");
+/**
+ * @description Ask a runner how a job is doing: its own files (`result`) first, Pueue's task list only when the job left no exit file
+ * (a hard kill) or has not started.
+ */
+/** The job's facts and what they mean. `slug` may be `-` for "the project this job id belongs to"; the answer names it. */
+async function readJobOutcome(client, slug, jobId) {
+    const facts = (0, jobState_1.parseJobFacts)(await client.callOrThrow('result', [slug, jobId]));
+    if (facts.exit !== null)
+        return { facts, outcome: (0, jobState_1.describeJobOutcome)(facts, null) };
+    const pueue = await client.call('pueue', ['status', '--json']);
+    if (pueue.exitCode !== 0)
+        throw new remoteRunError_1.RemoteRunError(`runner "${client.runner.name}": Pueue did not answer — ${pueue.stderr.trim().split('\n')[0] || 'no output'}`);
+    const task = (0, jobState_1.parsePueueStatus)(pueue.stdout).find((candidate) => candidate.label === (0, jobId_1.getJobLabel)(jobId)) ?? null;
+    return { facts, outcome: (0, jobState_1.describeJobOutcome)(facts, task) };
+}
+//# sourceMappingURL=jobQuery.js.map

package/dist/remoteRun/jobQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobQuery.js","sourceRoot":"","sources":["../../src/remoteRun/jobQuery.ts"],"names":[],"mappings":";;AAWA,wCAOC;AAlBD,mCAAsC;AACtC,yCAAiH;AACjH,qDAAkD;AAGlD;;;GAGG;AAEH,2HAA2H;AACpH,KAAK,UAAU,cAAc,CAAC,MAAoB,EAAE,IAAY,EAAE,KAAa;IACpF,MAAM,KAAK,GAAG,IAAA,wBAAa,EAAC,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/E,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAA,6BAAkB,EAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IACpF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,+BAAc,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,IAAI,6BAA6B,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IAClK,MAAM,IAAI,GAAG,IAAA,2BAAgB,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,IAAA,mBAAW,EAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC;IAChH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAA,6BAAkB,EAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/remoteRun/jobRecords.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/** `timeoutSeconds` is absent in a record an earlier build wrote: the longest `--timeout` allowed stands in for it. */
+declare const recordSchema: z.ZodObject<{
+    projectRoot: z.ZodString;
+    slug: z.ZodString;
+    submittedAtMs: z.ZodNumber;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type LocalJobRecord = z.infer<typeof recordSchema>;
+/** @description Remember where `jobId` came from; also drops the records the runner has surely pruned. */
+export declare function writeLocalJobRecord(cacheDir: string, jobId: string, record: LocalJobRecord, nowMs?: number): void;
+/** @description The record of `jobId`, or `null` when this machine and user did not submit it (or it was pruned). */
+export declare function readLocalJobRecord(cacheDir: string, jobId: string): LocalJobRecord | null;
+/**
+ * @description The runner that holds the most recent job of the project at `projectRoot` — the one whose copy of it is the latest — from
+ * the newest local job record; `null` when this machine has submitted nothing from that project. The runner is the one the job id names.
+ */
+export declare function readLastRunnerNameOfProject(cacheDir: string, projectRoot: string): string | null;
+/** @description When a record has no use any more: the job's deadline, then the days the runner keeps a job that ended. */
+export declare function getRecordExpiryMs(record: LocalJobRecord): number;
+export {};
+//# sourceMappingURL=jobRecords.d.ts.map

package/dist/remoteRun/jobRecords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobRecords.d.ts","sourceRoot":"","sources":["../../src/remoteRun/jobRecords.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,uHAAuH;AACvH,QAAA,MAAM,YAAY;;;;;iBAA0J,CAAC;AAE7K,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAO1D,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,GAAE,MAAmB,GAAG,IAAI,CAK7H;AAED,qHAAqH;AACrH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAOzF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBhG;AAED,2HAA2H;AAC3H,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEhE"}

package/dist/remoteRun/jobRecords.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeLocalJobRecord = writeLocalJobRecord;
+exports.readLocalJobRecord = readLocalJobRecord;
+exports.readLastRunnerNameOfProject = readLastRunnerNameOfProject;
+exports.getRecordExpiryMs = getRecordExpiryMs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const cliArgs_1 = require("./cliArgs");
+const jobId_1 = require("./jobId");
+/**
+ * @description The main box's own record of a job: which local project it was submitted from. `wait` and `fetch` bring result files back
+ * into THAT project — the runner is not trusted to say where its files go (its `meta.json` is only shown by `ls` and `status`; a
+ * hostile runner could name any folder of this user, and the slug of a root is a hash of public inputs it can compute). A job submitted
+ * from another user or machine has no record here, and its files are not fetched.
+ *
+ * Kept in the local cache (`<cache>/jobs/<id>.json`, mode 0600) for as long as the runner can still have the job: until its own deadline
+ * (`submittedAtMs` + its `--timeout`, up to 7 days) and then the days the runner keeps a finished one. Not by the age of the file: a job
+ * that runs or queues for days, or one fetched on the last day of the runner's retention, would find its record gone and its files
+ * silently left on the runner.
+ */
+/** The runner removes a job this long after it ended (`runner.sh`: `job_keep_days`); the record has no use past it. */
+const recordKeepDays = 3;
+const millisecondsPerDay = 24 * 60 * 60 * 1000;
+const recordsDirectoryName = 'jobs';
+const recordFileMode = 0o600;
+const recordsDirectoryMode = 0o700;
+const recordSuffix = '.json';
+/** `timeoutSeconds` is absent in a record an earlier build wrote: the longest `--timeout` allowed stands in for it. */
+const recordSchema = zod_1.z.looseObject({ projectRoot: zod_1.z.string().min(1), slug: zod_1.z.string().min(1), submittedAtMs: zod_1.z.number(), timeoutSeconds: zod_1.z.number().positive().optional() });
+function getRecordPath(cacheDir, jobId) {
+    if ((0, jobId_1.parseJobId)(jobId) === null)
+        throw new Error(`not a job id: ${jobId}`);
+    return path.join(cacheDir, recordsDirectoryName, `${jobId}${recordSuffix}`);
+}
+/** @description Remember where `jobId` came from; also drops the records the runner has surely pruned. */
+function writeLocalJobRecord(cacheDir, jobId, record, nowMs = Date.now()) {
+    const recordPath = getRecordPath(cacheDir, jobId);
+    fs.mkdirSync(path.dirname(recordPath), { recursive: true, mode: recordsDirectoryMode });
+    fs.writeFileSync(recordPath, JSON.stringify(record), { mode: recordFileMode });
+    pruneLocalJobRecords(cacheDir, nowMs);
+}
+/** @description The record of `jobId`, or `null` when this machine and user did not submit it (or it was pruned). */
+function readLocalJobRecord(cacheDir, jobId) {
+    try {
+        const parsed = recordSchema.safeParse(JSON.parse(fs.readFileSync(getRecordPath(cacheDir, jobId), 'utf8')));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * @description The runner that holds the most recent job of the project at `projectRoot` — the one whose copy of it is the latest — from
+ * the newest local job record; `null` when this machine has submitted nothing from that project. The runner is the one the job id names.
+ */
+function readLastRunnerNameOfProject(cacheDir, projectRoot) {
+    const directory = path.join(cacheDir, recordsDirectoryName);
+    let names;
+    try {
+        names = fs.readdirSync(directory);
+    }
+    catch {
+        return null;
+    }
+    let newest = null;
+    for (const name of names) {
+        if (!name.endsWith(recordSuffix))
+            continue;
+        const jobId = name.slice(0, -recordSuffix.length);
+        const runnerName = (0, jobId_1.parseJobId)(jobId)?.runnerName;
+        const record = runnerName === undefined ? null : readLocalJobRecord(cacheDir, jobId);
+        if (runnerName === undefined || record === null || record.projectRoot !== projectRoot)
+            continue;
+        if (newest === null || record.submittedAtMs > newest.submittedAtMs)
+            newest = { runnerName, submittedAtMs: record.submittedAtMs };
+    }
+    return newest?.runnerName ?? null;
+}
+/** @description When a record has no use any more: the job's deadline, then the days the runner keeps a job that ended. */
+function getRecordExpiryMs(record) {
+    return record.submittedAtMs + (record.timeoutSeconds ?? cliArgs_1.maxTimeoutSeconds) * 1000 + recordKeepDays * millisecondsPerDay;
+}
+/** When the file at `recordPath` expires: by its record, or — for a file that is not one — by its own age after the longest life a record can have. */
+function readFileExpiryMs(recordPath) {
+    try {
+        const parsed = recordSchema.safeParse(JSON.parse(fs.readFileSync(recordPath, 'utf8')));
+        if (parsed.success)
+            return getRecordExpiryMs(parsed.data);
+    }
+    catch {
+        /* not JSON: judged by its age below */
+    }
+    return fs.statSync(recordPath).mtimeMs + cliArgs_1.maxTimeoutSeconds * 1000 + recordKeepDays * millisecondsPerDay;
+}
+function pruneLocalJobRecords(cacheDir, nowMs) {
+    const directory = path.join(cacheDir, recordsDirectoryName);
+    for (const name of fs.readdirSync(directory)) {
+        if (!name.endsWith(recordSuffix))
+            continue;
+        const recordPath = path.join(directory, name);
+        try {
+            if (nowMs > readFileExpiryMs(recordPath))
+                fs.rmSync(recordPath, { force: true });
+        }
+        catch {
+            /* gone already: nothing to prune */
+        }
+    }
+}
+//# sourceMappingURL=jobRecords.js.map

package/dist/remoteRun/jobRecords.js.map

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

package/dist/remoteRun/jobState.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @description What a job is doing or how it ended, from the two witnesses: the job's own files (`runner.sh result`) and Pueue's task
+ * list. The job's own exit file is authoritative; a job that was SIGKILLed (a timeout whose command ignored SIGTERM, a kill after
+ * the grace time) wrote none, and then the markers it left and Pueue's verdict decide. Pueue alone is never trusted for the code:
+ * `pueue wait` exits 0 for a failed task, and a task Pueue calls `Killed` may have been a timeout.
+ */
+export type PueueResult = {
+    kind: 'success';
+} | {
+    kind: 'failed';
+    code: number;
+} | {
+    kind: 'killed';
+} | {
+    kind: 'other';
+    text: string;
+};
+export interface PueueTask {
+    id: number;
+    label: string | null;
+    state: 'queued' | 'running' | 'done' | 'other';
+    result: PueueResult | null;
+}
+/** @description The tasks of `pueue status --json` that are ours (label `rr-…`). A reply that is not Pueue's status is an error. */
+export declare function parsePueueStatus(jsonText: string): PueueTask[];
+/** @name JobFacts @description What `runner.sh result` prints. */
+export interface JobFacts {
+    /** The project's folder name on the runner. */
+    slug: string;
+    /** The exit file's content; `null` while there is none. */
+    exit: number | null;
+    phase: string;
+    taskId: number | null;
+    startedAtSeconds: number | null;
+    finishedAtSeconds: number | null;
+    isTimedOut: boolean;
+    isKilled: boolean;
+    isStarted: boolean;
+    isWithArtifacts: boolean;
+    /** `deps` when the dependencies step failed. */
+    failedStep: string;
+}
+/** @description Parse the `key=value` lines of `runner.sh result`. */
+export declare function parseJobFacts(text: string): JobFacts;
+export type JobEndReason = 'exit' | 'timeout' | 'killed' | 'deps-failed' | 'lost';
+export type JobOutcome = {
+    state: 'queued';
+} | {
+    state: 'running';
+    phase: string;
+} | {
+    state: 'done';
+    code: number;
+    reason: JobEndReason;
+} | {
+    state: 'unknown';
+};
+/** @description The job's state and, once it ended, remote-run's exit code for it and why. */
+export declare function describeJobOutcome(facts: JobFacts, task: PueueTask | null): JobOutcome;
+/** @description One short word for a job's state in `ls` and `status`. */
+export declare function describeJobState(outcome: JobOutcome): string;
+//# sourceMappingURL=jobState.d.ts.map

package/dist/remoteRun/jobState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobState.d.ts","sourceRoot":"","sources":["../../src/remoteRun/jobState.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExI,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B;AAkBD,oIAAoI;AACpI,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAwB9D;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAmBpD;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;AAElF,MAAM,MAAM,UAAU,GAClB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACrD;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzB,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,UAAU,CAkBtF;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAU5D"}

package/dist/remoteRun/jobState.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePueueStatus = parsePueueStatus;
+exports.parseJobFacts = parseJobFacts;
+exports.describeJobOutcome = describeJobOutcome;
+exports.describeJobState = describeJobState;
+const zod_1 = require("zod");
+const exitCodes_1 = require("./exitCodes");
+const jobId_1 = require("./jobId");
+const doneSchema = zod_1.z.looseObject({ result: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.union([zod_1.z.number(), zod_1.z.string()]))]) });
+const statusSchema = zod_1.z.union([
+    zod_1.z.string(),
+    zod_1.z.looseObject({ Running: zod_1.z.looseObject({}).optional(), Done: doneSchema.optional(), Paused: zod_1.z.looseObject({}).optional(), Queued: zod_1.z.looseObject({}).optional() }),
+]);
+const pueueStatusSchema = zod_1.z.looseObject({
+    tasks: zod_1.z.record(zod_1.z.string(), zod_1.z.looseObject({ id: zod_1.z.number(), label: zod_1.z.string().nullable().optional(), status: statusSchema })),
+});
+function readPueueResult(raw) {
+    if (raw === 'Success')
+        return { kind: 'success' };
+    if (raw === 'Killed')
+        return { kind: 'killed' };
+    if (typeof raw === 'object' && typeof raw.Failed === 'number')
+        return { kind: 'failed', code: raw.Failed };
+    return { kind: 'other', text: typeof raw === 'string' ? raw : JSON.stringify(raw) };
+}
+/** @description The tasks of `pueue status --json` that are ours (label `rr-…`). A reply that is not Pueue's status is an error. */
+function parsePueueStatus(jsonText) {
+    let parsed;
+    try {
+        parsed = pueueStatusSchema.safeParse(JSON.parse(jsonText));
+    }
+    catch {
+        throw new Error('pueue status did not return JSON');
+    }
+    if (!parsed.success)
+        throw new Error('pueue status returned something that is not its task list');
+    const tasks = [];
+    for (const task of Object.values(parsed.data.tasks)) {
+        const label = task.label ?? null;
+        if (label === null || !label.startsWith(jobId_1.pueueLabelPrefix))
+            continue;
+        const status = task.status;
+        if (typeof status === 'string') {
+            tasks.push({ id: task.id, label, state: status === 'Queued' ? 'queued' : 'other', result: null });
+        }
+        else if (status.Running !== undefined) {
+            tasks.push({ id: task.id, label, state: 'running', result: null });
+        }
+        else if (status.Done !== undefined) {
+            tasks.push({ id: task.id, label, state: 'done', result: readPueueResult(status.Done.result) });
+        }
+        else {
+            tasks.push({ id: task.id, label, state: status.Queued !== undefined ? 'queued' : 'other', result: null });
+        }
+    }
+    return tasks;
+}
+function readInteger(value) {
+    if (value === undefined || value.trim() === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : null;
+}
+/** @description Parse the `key=value` lines of `runner.sh result`. */
+function parseJobFacts(text) {
+    const fields = new Map();
+    for (const line of text.split('\n')) {
+        const separator = line.indexOf('=');
+        if (separator > 0)
+            fields.set(line.slice(0, separator), line.slice(separator + 1).trim());
+    }
+    return {
+        slug: fields.get('slug') ?? '',
+        exit: readInteger(fields.get('exit')),
+        phase: fields.get('phase') ?? '',
+        taskId: readInteger(fields.get('task')),
+        startedAtSeconds: readInteger(fields.get('started')),
+        finishedAtSeconds: readInteger(fields.get('finished')),
+        isTimedOut: fields.get('timeout') === '1',
+        isKilled: fields.get('killed') === '1',
+        isStarted: fields.get('has_pid') === '1',
+        isWithArtifacts: fields.get('artifacts') === '1',
+        failedStep: fields.get('failed_step') ?? '',
+    };
+}
+/** @description The job's state and, once it ended, remote-run's exit code for it and why. */
+function describeJobOutcome(facts, task) {
+    if (facts.exit !== null) {
+        let reason = 'exit';
+        if (facts.exit === exitCodes_1.remoteRunExitCodes.timedOut && facts.isTimedOut)
+            reason = 'timeout';
+        else if (facts.exit === exitCodes_1.remoteRunExitCodes.killed && facts.isKilled)
+            reason = 'killed';
+        else if (facts.exit === exitCodes_1.remoteRunExitCodes.failed && facts.failedStep === 'deps')
+            reason = 'deps-failed';
+        return { state: 'done', code: facts.exit, reason };
+    }
+    if (task === null)
+        return facts.isStarted ? { state: 'done', code: exitCodes_1.remoteRunExitCodes.failed, reason: 'lost' } : { state: 'unknown' };
+    if (task.state === 'queued')
+        return { state: 'queued' };
+    if (task.state === 'running')
+        return facts.isStarted ? { state: 'running', phase: facts.phase } : { state: 'queued' };
+    if (task.state === 'done') {
+        // The job process was killed hard: no exit file, so the markers and Pueue's verdict say what it was.
+        if (facts.isTimedOut)
+            return { state: 'done', code: exitCodes_1.remoteRunExitCodes.timedOut, reason: 'timeout' };
+        if (task.result?.kind === 'killed' || facts.isKilled)
+            return { state: 'done', code: exitCodes_1.remoteRunExitCodes.killed, reason: 'killed' };
+        return { state: 'done', code: exitCodes_1.remoteRunExitCodes.failed, reason: 'lost' };
+    }
+    return { state: 'unknown' };
+}
+/** @description One short word for a job's state in `ls` and `status`. */
+function describeJobState(outcome) {
+    if (outcome.state === 'done') {
+        if (outcome.reason === 'timeout')
+            return 'timed out';
+        if (outcome.reason === 'killed')
+            return 'killed';
+        if (outcome.reason === 'deps-failed')
+            return 'deps failed';
+        if (outcome.reason === 'lost')
+            return 'lost';
+        return outcome.code === 0 ? 'passed' : 'failed';
+    }
+    if (outcome.state === 'running')
+        return outcome.phase === '' || outcome.phase === 'running' ? 'running' : `running (${outcome.phase})`;
+    return outcome.state;
+}
+//# sourceMappingURL=jobState.js.map

package/dist/remoteRun/jobState.js.map

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

package/dist/remoteRun/leaseTiming.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @description The heartbeat lease of a foreground run, in a module of its own so the CLI reads it without loading the bot: a
+ * runner kills a job whose caller stopped writing its heartbeat byte for this long — a stock sshd never notices a half-open
+ * connection, so this is the only thing that ends an orphaned job.
+ *
+ * The test seam `CHARNESS_TEST_TIMINGS` (`testTimings.ts`) may only SHORTEN it (key `remoteRunLeaseMs`). The CLI cannot import
+ * `testTimings.ts` (its graph reaches the bot), so it reads this one key tolerantly, as the hot supervisor reads its own two; the
+ * boot of an instance that carries a bad value is what refuses it by name.
+ */
+/** Production lease: no heartbeat for this long → the job is killed. */
+export declare const remoteRunLeaseMs: number;
+/** A shorter lease than this would kill a healthy job on one slow second of the runner's. */
+export declare const remoteRunLeaseMinMs = 3000;
+/** @description The lease in force: the production one, or the test seam's shorter `remoteRunLeaseMs` when it is a whole number of ms within [min, production]. */
+export declare function readRemoteRunLeaseMs(env: NodeJS.ProcessEnv): number;
+/** @description How often the caller writes its heartbeat byte for a lease of `leaseMs`. */
+export declare function getHeartbeatIntervalMs(leaseMs: number): number;
+//# sourceMappingURL=leaseTiming.d.ts.map

package/dist/remoteRun/leaseTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaseTiming.d.ts","sourceRoot":"","sources":["../../src/remoteRun/leaseTiming.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAG1C,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAIxC,mKAAmK;AACnK,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAYnE;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/remoteRun/leaseTiming.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @description The heartbeat lease of a foreground run, in a module of its own so the CLI reads it without loading the bot: a
+ * runner kills a job whose caller stopped writing its heartbeat byte for this long — a stock sshd never notices a half-open
+ * connection, so this is the only thing that ends an orphaned job.
+ *
+ * The test seam `CHARNESS_TEST_TIMINGS` (`testTimings.ts`) may only SHORTEN it (key `remoteRunLeaseMs`). The CLI cannot import
+ * `testTimings.ts` (its graph reaches the bot), so it reads this one key tolerantly, as the hot supervisor reads its own two; the
+ * boot of an instance that carries a bad value is what refuses it by name.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remoteRunLeaseMinMs = exports.remoteRunLeaseMs = void 0;
+exports.readRemoteRunLeaseMs = readRemoteRunLeaseMs;
+exports.getHeartbeatIntervalMs = getHeartbeatIntervalMs;
+/** Production lease: no heartbeat for this long → the job is killed. */
+exports.remoteRunLeaseMs = 45 * 1000;
+/** The caller beats nine times per lease, so a few lost beats never kill a healthy job (production: every 5 s). */
+const beatsPerLease = 9;
+/** A shorter lease than this would kill a healthy job on one slow second of the runner's. */
+exports.remoteRunLeaseMinMs = 3000;
+const testTimingsVariableName = 'CHARNESS_TEST_TIMINGS';
+/** @description The lease in force: the production one, or the test seam's shorter `remoteRunLeaseMs` when it is a whole number of ms within [min, production]. */
+function readRemoteRunLeaseMs(env) {
+    const rawTestTimings = env[testTimingsVariableName];
+    if (rawTestTimings === undefined || rawTestTimings.trim() === '')
+        return exports.remoteRunLeaseMs;
+    let overrides;
+    try {
+        overrides = JSON.parse(rawTestTimings);
+    }
+    catch {
+        return exports.remoteRunLeaseMs;
+    }
+    const overrideMs = overrides?.remoteRunLeaseMs;
+    if (overrideMs === undefined || !Number.isInteger(overrideMs))
+        return exports.remoteRunLeaseMs;
+    return overrideMs >= exports.remoteRunLeaseMinMs && overrideMs <= exports.remoteRunLeaseMs ? overrideMs : exports.remoteRunLeaseMs;
+}
+/** @description How often the caller writes its heartbeat byte for a lease of `leaseMs`. */
+function getHeartbeatIntervalMs(leaseMs) {
+    return Math.floor(leaseMs / beatsPerLease);
+}
+//# sourceMappingURL=leaseTiming.js.map

package/dist/remoteRun/leaseTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaseTiming.js","sourceRoot":"","sources":["../../src/remoteRun/leaseTiming.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAYH,oDAYC;AAGD,wDAEC;AA3BD,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC1C,mHAAmH;AACnH,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,6FAA6F;AAChF,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAExD,mKAAmK;AACnK,SAAgB,oBAAoB,CAAC,GAAsB;IACzD,MAAM,cAAc,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,wBAAgB,CAAC;IAC1F,IAAI,SAA+C,CAAC;IACpD,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,wBAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,EAAE,gBAAgB,CAAC;IAC/C,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC;QAAE,OAAO,wBAAgB,CAAC;IACvF,OAAO,UAAU,IAAI,2BAAmB,IAAI,UAAU,IAAI,wBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAgB,CAAC;AAC7G,CAAC;AAED,4FAA4F;AAC5F,SAAgB,sBAAsB,CAAC,OAAe;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;AAC7C,CAAC"}

package/dist/remoteRun/output.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @description What the commands write and where: the job's output to stdout, remote-run's own lines to stderr prefixed `remote-run: `.
+ * The job script writes ITS progress lines (waiting for another job of the project, installing dependencies, a timeout) into the job's
+ * log with the same prefix, so the router sends every log line that starts with it to stderr — a command that prints such a line itself
+ * only moves it to the other stream.
+ */
+export declare const ownLinePrefix = "remote-run: ";
+export interface CliIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    homeDir: string;
+}
+/** @description One of remote-run's own lines, to stderr. */
+export declare function sayOwn(io: Pick<CliIo, 'stderr'>, line: string): void;
+export interface JobOutputRouter {
+    write: (chunk: string) => void;
+    /** The last, unfinished line, if any (a stream that ended without a newline). */
+    flush: () => void;
+}
+export declare function createJobOutputRouter(io: Pick<CliIo, 'stdout' | 'stderr'>): JobOutputRouter;
+export interface ExitMarkerFilter {
+    write: (chunk: string) => void;
+    /** Hand on what is still held back (a stream that ended). */
+    flush: () => void;
+    /** The code of the last marker seen, or `null` when none arrived. */
+    getExitCode: () => number | null;
+}
+/**
+ * @description Takes the exit marker `runner.sh exec` prints out of a stderr stream, however the stream is cut into chunks, and hands on
+ * everything else at once — a partial marker is held back only until the rest arrives or the stream ends.
+ */
+export declare function createExitMarkerFilter(forward: (text: string) => void): ExitMarkerFilter;
+//# sourceMappingURL=output.d.ts.map

package/dist/remoteRun/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/remoteRun/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iFAAiF;IACjF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,eAAe,CAqB3F;AAOD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,gBAAgB,CA2BxF"}