@outerlayer/cli 0.33.0-next.20261023120437 → 0.33.0-next.20261023151440

package/README.md

@@ -168,9 +168,19 @@ content:
   fetches the package's dependencies, and both npm runs use this user's npm
   configuration, including any registry token in `~/.npmrc`. Set
   `runner.autoUpdate` to `false` to stop them.
+  When `outerlayer runner start` fails a start-up check before its first
+  heartbeat, it sends one report with `POST /v1/hosts/startup-report`. The
+  report holds the host name, the CLI version, the name of the failed check
+  and the error text, with terminal control codes removed, scrubbed of the
+  keys the runner holds and cut to 200 characters. It sends none when another
+  runner already runs on the same config, or when the gateway refused the
+  runner key or its host key's signature. The call waits at most 5 seconds,
+  and a gateway with no such route ignores it.
   `outerlayer runner container-start`, the runner image's entrypoint, writes
-  the config from its environment variables with no network call. It then
-  runs `outerlayer runner start`, which makes the calls above. In the image
+  the config from its environment variables. When the container reaches no
+  Docker it can use, it sends that report, with the check `docker`, and
+  stops. Otherwise it runs `outerlayer runner start`, which makes the calls
+  above. In the image
   the runner never calls the npm registry. It logs the image tag to pull.
   `runner check` makes a list call and a host-key lookup to confirm the key
   works and sends nothing else; `runner status` and `runner logs` make no network call at all.

package/dist/build-info.json

@@ -1 +1 @@
-{"id":"2026-10-23T12:05:53.102Z+82d4e55","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}
+{"id":"2026-10-23T15:16:37.060Z+5648b3a","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}

package/dist/{check-4QNLMDP7.js → check-XPMN4GHD.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { probeCredentials } from './chunk-YSM4EEUK.js';
-import './chunk-FZUFUVLK.js';
+import { probeCredentials } from './chunk-YY3OQJ4X.js';
 import './chunk-GH246BGV.js';
-import './chunk-ZVB57WI6.js';
 import './chunk-57L2YAJA.js';
 import './chunk-3JVYMD4G.js';
 import './chunk-E7R2GIAW.js';
-import './chunk-YGZLRX5U.js';
-import './chunk-MZYOUIY5.js';
+import './chunk-RZOO7X4G.js';
+import './chunk-2LFWCIIE.js';
+import './chunk-ZVB57WI6.js';
+import './chunk-DA3PLB5N.js';
 import './chunk-HVRQQOMH.js';
 import './chunk-6LBSAW6I.js';
 import './chunk-I3LTIAOR.js';
@@ -16,10 +16,10 @@ import './chunk-7IFYI7XF.js';
 import './chunk-D3EDZPJR.js';
 import './chunk-7UPMYRPS.js';
 import './chunk-ESVW4MJY.js';
-import { managedProblems, managedFactsOf } from './chunk-SQQD5MST.js';
+import { managedProblems, managedFactsOf } from './chunk-VMIOUVJF.js';
 import './chunk-NBZ7XBT6.js';
 import './chunk-TBT347UY.js';
-import { placeholderQueues, placeholderProblem, permissionModeProblems, permissionModeProblem, probeHelper, HELPER_ENV, helperSocketPath, needsClaudeCredential, claudeCredentialCheck, claimPermissionProblem, formerSkillQueues, formerSkillProblem } from './chunk-IUPY54BZ.js';
+import { placeholderQueues, placeholderProblem, permissionModeProblems, permissionModeProblem, probeHelper, HELPER_ENV, helperSocketPath, needsClaudeCredential, claudeCredentialCheck, claimPermissionProblem, formerSkillQueues, formerSkillProblem } from './chunk-4YLL2E7Y.js';
 import './chunk-2PGI6RDE.js';
 import './chunk-EXZACZ2P.js';
 import './chunk-YXHKCHWG.js';
@@ -28,7 +28,7 @@ import './chunk-JBJTC3UU.js';
 import './chunk-OGFGZQA3.js';
 import './chunk-5THSC6BD.js';
 import './chunk-L26V6ILJ.js';
-import './chunk-XCRET2GZ.js';
+import './chunk-Z57X4KNC.js';
 import './chunk-MZBQTVFG.js';
 import './chunk-TQMI335S.js';
 import { DEFAULT_UNIT_NAME } from './chunk-EHOFFTVX.js';
@@ -37,7 +37,7 @@ import './chunk-X4JEBMYN.js';
 import './chunk-OGMXVPCS.js';
 import './chunk-3Z3MPR55.js';
 import './chunk-NE63JADS.js';
-import './chunk-YXMGHGHR.js';
+import './chunk-VSLJ6PPG.js';
 import './chunk-IP7BIBXJ.js';
 import './chunk-HLZMAJJD.js';
 import './chunk-S5CNYXUA.js';

package/dist/{chunk-FZUFUVLK.js → chunk-2LFWCIIE.js}

@@ -6,23 +6,23 @@ import { writeDockerClientConfig } from './chunk-6LBSAW6I.js';
 import { zodProblem } from './chunk-I3LTIAOR.js';
 import { senderPidfile } from './chunk-7IFYI7XF.js';
 import { installScrubContext } from './chunk-D3EDZPJR.js';
-import { ADDED_USER, shellQuote, GH_CONFIG_YML, ghHostsYml, AssetError, obtainImage, ensureRootfs, makeBuildsDirPrivate, gitRemoteFor, startServicesFor, createLeaseChannel, createBuildDisk, machineConfig, startJailedInto, resolveAgentUser, AgentUserError, runBuildSteps, startHostServices, LEASE_SECONDS, createContainerRuntime, stopContainer, cleanupContainer, outOfMemoryReason, closeHostBuild, containerSenderCommand, hostCommandEnvironment, execArgv, signalInContainer, syncInContainer, copyTranscriptsFromContainer, MANAGED_UNJAILED_REASON, senderAliveScript, helperFirecrackerNote, stopJailed, deleteBuildDisk, startCheckContainer, lifecycleSteps, lifecycleFailureReason, writeEvalInput, DeliveryFailure, EVAL_INPUT_NAME, copyTranscripts, senderSignalScript, containerJudgeEnvironment, ROOT_DISK_ID_PREFIX, copyJudgeTree } from './chunk-IUPY54BZ.js';
+import { ADDED_USER, shellQuote, GH_CONFIG_YML, ghHostsYml, AssetError, obtainImage, ensureRootfs, makeBuildsDirPrivate, gitRemoteFor, startServicesFor, createLeaseChannel, createBuildDisk, machineConfig, startJailedInto, resolveAgentUser, AgentUserError, runBuildSteps, startHostServices, LEASE_SECONDS, createContainerRuntime, stopContainer, cleanupContainer, outOfMemoryReason, closeHostBuild, containerSenderCommand, hostCommandEnvironment, execArgv, signalInContainer, syncInContainer, copyTranscriptsFromContainer, MANAGED_UNJAILED_REASON, senderAliveScript, helperFirecrackerNote, stopJailed, deleteBuildDisk, startCheckContainer, lifecycleSteps, lifecycleFailureReason, writeEvalInput, DeliveryFailure, EVAL_INPUT_NAME, copyTranscripts, senderSignalScript, containerJudgeEnvironment, ROOT_DISK_ID_PREFIX, copyJudgeTree } from './chunk-4YLL2E7Y.js';
 import { readBranchHead, fetchCommit, diffBetween } from './chunk-YXHKCHWG.js';
 import { isSameProcess, startTimeOf } from './chunk-JBJTC3UU.js';
 import { waitForAgent, vmExecArgs } from './chunk-5THSC6BD.js';
 import { socketPathProblem, vsockLinks, LEASE_LINK, linkVsockSockets } from './chunk-L26V6ILJ.js';
-import { describeCallFailure, resolveGoverningSource, prefetchGovernedContext, refusalCode, removeStagedContext, stageGovernedContext, pinnedSourceOf, commandWithShim, logStamp, createRunnerLog, removeKeptContext, formatDuration, retrySend, formatClock, WORKFLOW_PERMISSION_REASON, keptContextTree } from './chunk-XCRET2GZ.js';
+import { describeCallFailure, resolveGoverningSource, prefetchGovernedContext, refusalCode, removeStagedContext, stageGovernedContext, pinnedSourceOf, commandWithShim, logStamp, createRunnerLog, removeKeptContext, formatDuration, retrySend, formatClock, WORKFLOW_PERMISSION_REASON, keptContextTree } from './chunk-Z57X4KNC.js';
 import { imageBuildOf, isBuiltinContainer, isBuiltinProcess, isBuiltinVm, DEFAULT_CHECK_TIME_LIMIT_MINUTES } from './chunk-VWQCYOBS.js';
 import { DEFAULT_CACHE_DISK, formatBytes, allocatedBytes } from './chunk-X4JEBMYN.js';
 import { parseSize, HASH_ARGV, parseProgramHash, JUDGE_PROGRAM, writeJobFile, readJobFile, childEnvironment, withAnswerProtocol, judgeCommand, MAX_REPORT_BYTES, JUDGE_MAX_TURNS, JUDGE_DIR, COMMAND_DIR, MAX_ITEMS_BYTES } from './chunk-OGMXVPCS.js';
 import { CLAUDE_CODE_VERSION, FIRECRACKER_VERSION } from './chunk-NE63JADS.js';
-import { WorkCommandError, postJson, isSignatureRefusal, getJson } from './chunk-YXMGHGHR.js';
+import { WorkCommandError, postJson, isSignatureRefusal, getJson } from './chunk-VSLJ6PPG.js';
 import { planArtifactUpload } from './chunk-MPC2UAW2.js';
 import { scrubText } from './chunk-NIY2UBT6.js';
 import { readCloudConfig } from './chunk-PJDQPF5N.js';
 import { signerFor } from './chunk-SOI6K5DY.js';
 import { RUNNER_FILE_MODE, runnerDir, buildDir, vsockPath, jobConsolePath } from './chunk-PA6CK6WQ.js';
-import { JOB_MOUNT, claudeCredential, repositoriesOf, primaryOf, buildEnvironment, CHECKOUT_DIR, AGENT_CREDENTIAL_MISSING, sharedUserEnvironment, headerVariables, authorEnvironment, withTunnelRecord, commitIdentityRecord, buildMavenSettingsXml, RELAY_PORT, repositoryPath, lifecycleWorkdir, CHECK_ITEMS_FILE, MAVEN_SETTINGS_FILE, CLAUDE_CREDENTIAL_VARIABLES, currentClaudeCredential, removedClaudeCredentialValues, checkEnvironment, EVAL_INPUT_DIR } from './chunk-BALIE3BA.js';
+import { JOB_MOUNT, claudeCredential, repositoriesOf, primaryOf, buildEnvironment, CHECKOUT_DIR, AGENT_CREDENTIAL_MISSING, sharedUserEnvironment, headerVariables, authorEnvironment, withTunnelRecord, commitIdentityRecord, buildMavenSettingsXml, CLAUDE_CREDENTIAL_VARIABLES, currentClaudeCredential, removedClaudeCredentialValues, RELAY_PORT, repositoryPath, lifecycleWorkdir, CHECK_ITEMS_FILE, MAVEN_SETTINGS_FILE, checkEnvironment, EVAL_INPUT_DIR } from './chunk-BALIE3BA.js';
 import { resolvePackRoot } from './chunk-44V5SD4G.js';
 import { MAINTAINED_SKILLS } from './chunk-CDDED64E.js';
 import { resolveVersion } from './chunk-RA3O54FC.js';
@@ -3547,4 +3547,4 @@ async function stopSender(input) {
   }
 }
 
-export { ALREADY_RELEASED, AttemptLogBook, EXIT_CODE_FILE, GUEST_USAGE_INTERVAL_MS, MICROVM_COMMAND_DIR, RENEW_INTERVAL_SECONDS, appendCommandLog, commandLogOffset, deliverCommitHooks, describeHookEnd, finishJob, foldSample, hookLimitsFor, inTeardown, isContainerTracked, isGroupAlive, isIdle, isMicroVmTracked, isReadable, isTimedOut, isTracked, isUnfinished, jobEnv, judgeProbe, listAdoptableJobs, listTrackedJobs, listUnreadableJobs, microVmCommandLine, microVmOomKills, needsRenew, outcomeFromExitCode, probeCommand, probeMicroVmCommand, provisionMicroVm, provisionProcess, readCpuUsec, readProvisionOut, recoverLostJobs, releaseLease, renewLease, restartSender, retryFailedReleases, runCommand, runHook, sampleGuest, serveLease, setStage, startMicroVmCommand, startSender, stopOrphanedMicroVms, unfinishedJobs, vmAlive, workdirProblem, writeGuestGhConfig };
+export { ALREADY_RELEASED, AttemptLogBook, EXIT_CODE_FILE, GUEST_USAGE_INTERVAL_MS, MICROVM_COMMAND_DIR, RENEW_INTERVAL_SECONDS, appendCommandLog, commandLogOffset, deliverCommitHooks, describeHookEnd, finishJob, foldSample, hookLimitsFor, inTeardown, isContainerTracked, isGroupAlive, isIdle, isMicroVmTracked, isReadable, isTimedOut, isTracked, isUnfinished, jobEnv, judgeProbe, listAdoptableJobs, listTrackedJobs, listUnreadableJobs, microVmCommandLine, microVmOomKills, needsRenew, outcomeFromExitCode, probeCommand, probeMicroVmCommand, provisionMicroVm, provisionProcess, readCpuUsec, readProvisionOut, recoverLostJobs, releaseLease, renewLease, restartSender, retryFailedReleases, runCommand, runHook, sampleGuest, scrubReason, serveLease, setStage, startMicroVmCommand, startSender, stopOrphanedMicroVms, stripTerminalControls, unfinishedJobs, vmAlive, workdirProblem, writeGuestGhConfig };

package/dist/{chunk-IUPY54BZ.js → chunk-4YLL2E7Y.js}

@@ -7,14 +7,14 @@ import { startTimeOf, isSameProcess } from './chunk-JBJTC3UU.js';
 import { currentCliBuild } from './chunk-OGFGZQA3.js';
 import { runExec, execCapture, waitForAgent } from './chunk-5THSC6BD.js';
 import { GUEST_CID, linkVsockSockets } from './chunk-L26V6ILJ.js';
-import { describeCallFailure, keepStagedContext, controlPlaneTokenFailure, refusalCode, resolveGoverningSource, prefetchGovernedContext, removeStagedContext, stageGovernedContext, pinnedSourceOf, commandWithShim, shimScript, WORKFLOW_PERMISSION_REASON } from './chunk-XCRET2GZ.js';
+import { describeCallFailure, keepStagedContext, controlPlaneTokenFailure, refusalCode, resolveGoverningSource, prefetchGovernedContext, removeStagedContext, stageGovernedContext, pinnedSourceOf, commandWithShim, shimScript, WORKFLOW_PERMISSION_REASON } from './chunk-Z57X4KNC.js';
 import { runnerImageVersion } from './chunk-MZBQTVFG.js';
 import { runnerCredentialProblem, builtinKind, hostAllowed } from './chunk-VWQCYOBS.js';
 import { formatBytes, allocatedBytes } from './chunk-X4JEBMYN.js';
 import { createDockerHost, builderSpec, runnerLabelValue, RUNNER_LABEL, BUILD_LABEL, prepareRunArgs, containerRunArgs, HASH_ARGV, parseProgramHash, JUDGE_PROGRAM, containerExecArgs, childEnvironment, readDu, JUDGE_DIR, MAX_ITEMS_BYTES, JUDGE_ITEMS, MAX_REPORT_BYTES, JUDGE_REPORT, spawnRun } from './chunk-OGMXVPCS.js';
 import { RecipeError, DOCKER_FEATURE, writeSanitizedRecipe, classifyProperties } from './chunk-3Z3MPR55.js';
 import { firecrackerArch, MICROVM_ARCHES, FIRECRACKER_VERSION, hostHelperPinned, CLAUDE_CODE_VERSION, guestAssetsPinned, GUEST_HELPER_SHA256, GUEST_ASSETS_BASE_URL, GUEST_KERNEL_SHA256, JAILER_BINARY_SHA256, FIRECRACKER_BINARY_SHA256, FIRECRACKER_SHA256, GUEST_ASSETS_VERSION, BUILDER_DISK_VERSION, builderDiskPinned, FFMPEG_STATIC, FFMPEG_BUILD_TAG, GH_SHA256, GH_VERSION, TINI_SHA256, TINI_VERSION, VOICE_PACK_FILES, BUILDER_DISK_SHA256, BUILDER_DISK_BASE_URL, DEFAULT_BASE_IMAGE } from './chunk-NE63JADS.js';
-import { WorkCommandError, getJson } from './chunk-YXMGHGHR.js';
+import { WorkCommandError, getJson } from './chunk-VSLJ6PPG.js';
 import { sanitizeTerminal } from './chunk-MPC2UAW2.js';
 import { setCustomScrubbers, setLocalIdentity, setRepoRoot, parseTranscript, scrubDeep, scrubText } from './chunk-NIY2UBT6.js';
 import { signerFor } from './chunk-SOI6K5DY.js';

package/dist/{chunk-2JLM4GUF.js → chunk-BLHUFOOB.js}

@@ -2,7 +2,7 @@
 import { createRequire } from 'node:module';
 import { checkStarterFiles, contextIsGoverned } from './chunk-DKFUXYGD.js';
 import { fleetCheck, checkBuildSkill, checkMachineSkills, checkCommittedMaintainedSkills, checkMaintainedReferences, checkIgnoredSkillFolders } from './chunk-EJL6CWSP.js';
-import { resolveCredentials, getJson, WorkCommandError } from './chunk-YXMGHGHR.js';
+import { resolveCredentials, getJson, WorkCommandError } from './chunk-VSLJ6PPG.js';
 import { isLinkedRepository } from './chunk-S5CNYXUA.js';
 import { sanitizeTerminal } from './chunk-MPC2UAW2.js';
 import { resolveRepoIdentity, compareVersions, SUPPORTED_VERSIONS } from './chunk-NIY2UBT6.js';
@@ -1217,7 +1217,7 @@ async function gatherDoctorChecks() {
     const { runnerVmCheck } = await import('./doctor-53F2PYY7.js');
     checks.push(runnerVmCheck(configPath, { lima: realLima(), home: homeFromEnv(), instance: runnerVm.instance }));
   } else if (hasRunnerBlock(configPath)) {
-    const { runnerHostChecks } = await import('./doctor-4YZOP343.js');
+    const { runnerHostChecks } = await import('./doctor-MFLM7DMY.js');
     const gateway = (() => {
       try {
         const { url, apiKey, appId } = loadRunnerConfig(configPath);

package/dist/{chunk-MZYOUIY5.js → chunk-DA3PLB5N.js}

@@ -4,6 +4,6 @@ import { createRequire } from 'node:module';
 createRequire(import.meta.url);
 
 // src/runner/protocol.ts
-var RUNNER_PROTOCOL = 28;
+var RUNNER_PROTOCOL = 31;
 
 export { RUNNER_PROTOCOL };

package/dist/chunk-RZOO7X4G.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { scrubReason, stripTerminalControls } from './chunk-2LFWCIIE.js';
+import { RunnerAlreadyRunningError, readPidFile } from './chunk-F5UL23I2.js';
+import { isSameProcess } from './chunk-JBJTC3UU.js';
+import { checkFit, RUNNER_RESERVE_BYTES } from './chunk-EHOFFTVX.js';
+import { isSignatureRefusal, postJson } from './chunk-VSLJ6PPG.js';
+import { signerFor } from './chunk-SOI6K5DY.js';
+import { pidFilePath } from './chunk-PA6CK6WQ.js';
+import { readFileSync } from 'fs';
+
+createRequire(import.meta.url);
+var GIB = 1024 ** 3;
+var DEFAULT_GIB = 8;
+var MINIMUM_GIB = 4;
+var BUILD_MEMORY_VARIABLE = "OUTERLAYER_BUILD_MEMORY";
+function memoryIsSet(configPath) {
+  try {
+    const raw = JSON.parse(readFileSync(configPath, "utf8"));
+    return raw.runner.build.memory !== void 0;
+  } catch {
+    return false;
+  }
+}
+function gib(bytes) {
+  return `${Number((bytes / GIB).toFixed(1))} GiB`;
+}
+function fitImageBuildMemory(config, totalMemoryBytes) {
+  if (memoryIsSet(config.configPath)) return { config };
+  const current = config.build?.memory ?? `${DEFAULT_GIB}g`;
+  if (checkFit({ concurrency: config.concurrency, buildMemory: current, usableBytes: totalMemoryBytes }).fits) return { config };
+  const available = Math.max(0, totalMemoryBytes - RUNNER_RESERVE_BYTES);
+  const perBuild = Math.floor(available / config.concurrency / GIB);
+  if (perBuild < MINIMUM_GIB) return { config };
+  const memory = `${perBuild}g`;
+  return {
+    config: { ...config, build: { ...config.build, memory } },
+    note: `builds get ${memory} of memory to fit this machine's ${gib(totalMemoryBytes)}; set ${BUILD_MEMORY_VARIABLE} to choose another value`
+  };
+}
+
+// src/runner/startup-report.ts
+var REPORT_TIMEOUT_MS = 5e3;
+var EMPTY_MESSAGE = "the check failed with no message";
+async function reportFailedStart(failed, fetchImpl, deps = {}) {
+  try {
+    if (failed.error instanceof RunnerAlreadyRunningError || refusesReport(failed.refusal)) return;
+    if (otherRunnerLive(failed.config.configPath, deps.isSameProcess ?? isSameProcess)) return;
+    await sendStartupReport(failed, fetchImpl, deps);
+  } catch {
+  }
+}
+function refusesReport(refusal) {
+  return refusal !== void 0 && (refusal.status === 401 || isSignatureRefusal(refusal.code));
+}
+function otherRunnerLive(configPath, isSame) {
+  const entry = readPidFile(pidFilePath(configPath));
+  return entry !== null && entry.pid !== process.pid && isSame(entry.pid, entry.start);
+}
+async function sendStartupReport(failed, fetchImpl, deps) {
+  const now = deps.now ?? (() => performance.now());
+  const startedAt = now();
+  const { config } = failed;
+  const text = failed.error instanceof Error ? failed.error.message : String(failed.error);
+  const message = (deps.scrub ?? scrubReason)(stripTerminalControls(text), config) ?? EMPTY_MESSAGE;
+  const signer = await signerFor(config.configPath).catch(() => void 0);
+  const left = REPORT_TIMEOUT_MS - (now() - startedAt);
+  if (left <= 0) return;
+  await postJson(
+    config.url,
+    "/v1/hosts/startup-report",
+    config.apiKey,
+    config.appId,
+    { host: config.host, cliVersion: failed.cliVersion, check: failed.check, message },
+    fetchImpl,
+    left,
+    signer
+  );
+}
+
+export { BUILD_MEMORY_VARIABLE, fitImageBuildMemory, reportFailedStart };

package/dist/{chunk-SQQD5MST.js → chunk-VMIOUVJF.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { placeholderQueues, placeholderProblem } from './chunk-IUPY54BZ.js';
+import { placeholderQueues, placeholderProblem } from './chunk-4YLL2E7Y.js';
 import { checkFit } from './chunk-EHOFFTVX.js';
 import { builtinKind, imageBuildOf } from './chunk-VWQCYOBS.js';
 import { realBuildDiskProbe, checkDiskFit, DEFAULT_CACHE_DISK, DEFAULT_BUILD_DISK } from './chunk-X4JEBMYN.js';

package/dist/{chunk-YXMGHGHR.js → chunk-VSLJ6PPG.js}

@@ -115,13 +115,14 @@ var WorkCommandError = class extends Error {
    * reached a response. A caller that has to tell one refusal from another —
    * a claim lost to another host from a key that no longer works — reads it
    * rather than matching on the message. */
-  constructor(message, retryable = false, status, code, reason, billingUrl) {
+  constructor(message, retryable = false, status, code, reason, billingUrl, lowestVersion) {
     super(message);
     this.retryable = retryable;
     this.status = status;
     this.code = code;
     this.reason = reason;
     this.billingUrl = billingUrl;
+    this.lowestVersion = lowestVersion;
   }
 };
 var WORK_LINK_RETRY_DELAYS_MS = [1e3, 5e3, 15e3, 6e4];
@@ -247,7 +248,10 @@ async function sendJsonBefore(method, url, path, apiKey, appId, body, fetchImpl,
       json.error?.message ?? `request failed (${response.status})`,
       response.status >= 500 || response.status === 429,
       response.status,
-      json.error?.code
+      json.error?.code,
+      void 0,
+      void 0,
+      typeof json.error?.lowestVersion === "string" ? json.error.lowestVersion : void 0
     );
   }
   return { status: response.status, data: json.data ?? json };

package/dist/{chunk-YSM4EEUK.js → chunk-YY3OQJ4X.js}

@@ -1,26 +1,26 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { releaseLease, isUnfinished, setStage, jobEnv, runHook, describeHookEnd, provisionMicroVm, deliverCommitHooks, provisionProcess, readProvisionOut, workdirProblem, MICROVM_COMMAND_DIR, commandLogOffset, startMicroVmCommand, microVmCommandLine, runCommand, startSender, finishJob, sampleGuest, foldSample, isContainerTracked, isMicroVmTracked, probeMicroVmCommand, probeCommand, appendCommandLog, judgeProbe, EXIT_CODE_FILE, isTracked, isGroupAlive, outcomeFromExitCode, isTimedOut, readCpuUsec, isIdle, stopOrphanedMicroVms, unfinishedJobs, listUnreadableJobs, listAdoptableJobs, retryFailedReleases, recoverLostJobs, GUEST_USAGE_INTERVAL_MS, hookLimitsFor, AttemptLogBook, microVmOomKills, needsRenew, renewLease, RENEW_INTERVAL_SECONDS, listTrackedJobs, restartSender, serveLease, vmAlive, writeGuestGhConfig, ALREADY_RELEASED, inTeardown } from './chunk-FZUFUVLK.js';
 import { writePendingUpdate } from './chunk-GH246BGV.js';
-import { JOB_STATE_FORMAT, readsJobState, jobStateFormatOf } from './chunk-ZVB57WI6.js';
 import { readHousekeepingRecord, writeHousekeepingRecord } from './chunk-57L2YAJA.js';
 import { decideInstalledSwitch } from './chunk-3JVYMD4G.js';
 import { fetchVersionMeta, npmVersion, npmSupportsProvenance, fetchTarballDigest, fetchProvenance, installVersion, auditSignatures } from './chunk-E7R2GIAW.js';
-import { fitImageBuildMemory } from './chunk-YGZLRX5U.js';
-import { RUNNER_PROTOCOL } from './chunk-MZYOUIY5.js';
-import { realBlockedProbes, checkBlockedWithSlots, keepsHostBuilder } from './chunk-SQQD5MST.js';
-import { writeMarker, readMarker, currentVersion, removeMarker, entryIn, versionDir, startedThroughCurrent, switchCurrent, isInLayout, cleanVersions, stagingDir } from './chunk-NBZ7XBT6.js';
+import { reportFailedStart, fitImageBuildMemory } from './chunk-RZOO7X4G.js';
+import { releaseLease, isUnfinished, setStage, jobEnv, runHook, describeHookEnd, provisionMicroVm, deliverCommitHooks, provisionProcess, readProvisionOut, workdirProblem, MICROVM_COMMAND_DIR, commandLogOffset, startMicroVmCommand, microVmCommandLine, runCommand, startSender, finishJob, sampleGuest, foldSample, isContainerTracked, isMicroVmTracked, probeMicroVmCommand, probeCommand, appendCommandLog, judgeProbe, EXIT_CODE_FILE, isTracked, isGroupAlive, outcomeFromExitCode, isTimedOut, readCpuUsec, isIdle, stopOrphanedMicroVms, unfinishedJobs, listUnreadableJobs, listAdoptableJobs, retryFailedReleases, recoverLostJobs, GUEST_USAGE_INTERVAL_MS, hookLimitsFor, AttemptLogBook, microVmOomKills, needsRenew, renewLease, RENEW_INTERVAL_SECONDS, listTrackedJobs, restartSender, serveLease, vmAlive, writeGuestGhConfig, ALREADY_RELEASED, inTeardown } from './chunk-2LFWCIIE.js';
+import { JOB_STATE_FORMAT, readsJobState, jobStateFormatOf } from './chunk-ZVB57WI6.js';
+import { RUNNER_PROTOCOL } from './chunk-DA3PLB5N.js';
+import { realBlockedProbes, checkBlockedWithSlots, keepsHostBuilder } from './chunk-VMIOUVJF.js';
+import { writeMarker, readMarker, currentVersion, removeMarker, isInLayout, startedThroughCurrent, entryIn, versionDir, switchCurrent, cleanVersions, stagingDir } from './chunk-NBZ7XBT6.js';
 import { RepoFilter } from './chunk-TBT347UY.js';
-import { leaseTimeLeftMs, createContainerRuntime, withTunnelLog, LEASE_SECONDS, attemptNote, needsBuildSkill, provisionContainer, leaseExpiresAtMs, deliverContainerHooks, provisionEnvironment, resolveHostBuild, listenOnBroker, hostEnvironment, deliverExecMaven, runWithSpawn, hostCommandEnvironment, lifecycleSteps, execArgv, lifecycleFailureReason, decideHostBuildSkill, prepareBranch, currentSkillCommand, formerSkillProblem, containerCommandExec, execCommandLine, startHostServices, setUpRunnerCgroup, sweepImageBuilders, measureDisk, parseCpuList, ensureTunnel, keepGhConfigCurrent, filesAreCopied, gitRemoteFor, startServicesFor, createLeaseChannel } from './chunk-IUPY54BZ.js';
+import { leaseTimeLeftMs, createContainerRuntime, withTunnelLog, LEASE_SECONDS, attemptNote, needsBuildSkill, provisionContainer, leaseExpiresAtMs, deliverContainerHooks, provisionEnvironment, resolveHostBuild, listenOnBroker, hostEnvironment, deliverExecMaven, runWithSpawn, hostCommandEnvironment, lifecycleSteps, execArgv, lifecycleFailureReason, decideHostBuildSkill, prepareBranch, currentSkillCommand, formerSkillProblem, containerCommandExec, execCommandLine, startHostServices, setUpRunnerCgroup, sweepImageBuilders, measureDisk, parseCpuList, ensureTunnel, keepGhConfigCurrent, filesAreCopied, gitRemoteFor, startServicesFor, createLeaseChannel } from './chunk-4YLL2E7Y.js';
 import { claimPidFile, writePidFile, readPidFile, releasePidFile } from './chunk-F5UL23I2.js';
 import { startTimeOf, isSameProcess } from './chunk-JBJTC3UU.js';
-import { describeCallFailure, retrySend, shortClaim, relativeToRunner, formatDuration, resolveGoverningSource, BuildTokens, classifyRefusal, refusalCode, createRunnerLog, formatClock } from './chunk-XCRET2GZ.js';
+import { describeCallFailure, retrySend, shortClaim, relativeToRunner, formatDuration, resolveGoverningSource, BuildTokens, classifyRefusal, refusalCode, createRunnerLog, formatClock } from './chunk-Z57X4KNC.js';
 import { tagToPull, pullInstruction, imageTag, writeUpdateStatus } from './chunk-MZBQTVFG.js';
 import { isVersion, compareVersions, satisfiesRange } from './chunk-TQMI335S.js';
 import { isBuiltinContainer, isBuiltinVm, isBuiltinProcess, loadRunnerConfig, checkHooks, builtinKind, DEFAULT_UPDATE_MAX_WAIT_HOURS } from './chunk-VWQCYOBS.js';
 import { freeBytes, formatBytes, volumeBytes } from './chunk-X4JEBMYN.js';
 import { writeJobFile, ensureRunnerIdentity, readJobFile, exceedsDisk, builderName, runnerLabelValue, ensureFailureCount, builderSpec, ensureBuilder, spawnRun, BUILD_LABEL, RUNNER_LABEL, readJobFileChecked } from './chunk-OGMXVPCS.js';
-import { isSignatureRefusal, WorkCommandError, getJson, postJson } from './chunk-YXMGHGHR.js';
+import { isSignatureRefusal, WorkCommandError, getJson, postJson } from './chunk-VSLJ6PPG.js';
 import { loadHostKey, ensureHostKey, signerFor } from './chunk-SOI6K5DY.js';
 import { RUNNER_DIR_MODE, runnerDir, buildDir, attemptStamp, jobDir, RUNNER_FILE_MODE, jobsDir, pidFilePath, spoolDir, imagesDir, rootfsDir, builderCacheDiskPath } from './chunk-PA6CK6WQ.js';
 import { parseClaimIdentity, parseClaimedRepositories, parseUnreachable, repositoriesOf, primaryOf, sharedUserEnvironment, JOB_MOUNT, takeClaudeCredential, heldClaudeCredential, currentClaudeCredential } from './chunk-BALIE3BA.js';
@@ -121,7 +121,8 @@ async function sendHeartbeat(args, fetchImpl) {
     blocked: args.blocked === void 0 ? void 0 : { reason: cutForGateway(args.blocked.reason, BLOCKED_REASON_MAX) },
     state: args.state,
     waitingItems: args.waitingItems === void 0 ? void 0 : args.waitingItems.slice(0, WAITING_ITEMS_MAX),
-    takes: args.takes === void 0 ? void 0 : takesBody(args.takes)
+    takes: args.takes === void 0 ? void 0 : takesBody(args.takes),
+    selfUpdate: args.selfUpdate
   };
   try {
     const response = await postJson(
@@ -1284,10 +1285,12 @@ async function sendTickHeartbeat(state, workRequest) {
           }),
           // Left out unless a draining runner has builds to wait on, so the gateway stores null.
           waitingItems: waitingItems.length > 0 ? waitingItems : void 0,
-          takes: { queues: state.config.queues, repos: { include: state.config.repos?.include, exclude: state.config.repos?.exclude } }
+          takes: { queues: state.config.queues, repos: { include: state.config.repos?.include, exclude: state.config.repos?.exclude } },
+          selfUpdate: selfUpdateReport(state)
         },
         state.deps.fetchImpl
       );
+      if (result.ok) state.heartbeatSent = true;
       reportRepeating(state, "the heartbeat", result.ok ? void 0 : `heartbeat failed: ${result.reason}`);
       if (result.ok) {
         considerNamedVersion(state, result.runnerVersion);
@@ -1335,7 +1338,18 @@ function selfUpdateBlocker(configPath, entryPath, own) {
   if (current !== own) return `\`current\` names ${current ?? "nothing"}, not the running ${own} \xB7 restart the runner`;
   return void 0;
 }
+function selfUpdateReport(state) {
+  if (state.deps.image !== void 0) return { enabled: false, reason: "runner-image" };
+  const update = state.deps.update;
+  const configPath = state.config.configPath;
+  if (update === void 0 || !isInLayout(configPath, update.entryPath) || !startedThroughCurrent(configPath, update.entryPath)) {
+    return { enabled: false, reason: "outside-install-layout" };
+  }
+  if (!state.config.autoUpdate) return { enabled: false, reason: "auto-update-off" };
+  return { enabled: true };
+}
 function considerNamedVersion(state, named) {
+  if (named !== void 0 && isVersion(named)) state.namedVersion = named;
   if (state.deps.image !== void 0) {
     considerNamedImage(state, named);
     return;
@@ -1371,6 +1385,14 @@ function considerNamedImage(state, named) {
   state.imageLogged = named;
   logOf(state).line(`the factory names ${named}, newer than the ${own} this image runs \xB7 ${pullInstruction(imageTag(named))}`);
 }
+function upgradeStepFor(state, floor) {
+  const named = state.namedVersion ?? floor;
+  const target = named !== void 0 && isVersion(named) ? named : void 0;
+  if (state.deps.image !== void 0) return pullInstruction(tagToPull(target));
+  const npm = `npm install -g @outerlayer/cli@${target ?? "latest"}, then "$(npm prefix -g)/bin/outerlayer" runner install`;
+  if (state.deps.update?.underService !== true) return `${npm}, then start the runner again`;
+  return builtinKind(state.config.hooks.provision) === "own" ? npm : `${npm} --service`;
+}
 function recordImageStatus(state) {
   if (state.deps.image === void 0) return;
   const named = state.imageNamed;
@@ -1864,7 +1886,7 @@ var CLAIM_REFUSAL_CODES = new Set(
   "pull_request_from_fork pull_request_on_default_branch pull_request_ambiguous pull_request_repository_not_connected repository_not_reachable branch_claimed_elsewhere".split(" ")
 );
 async function tryClaimAndStart(state, item, queue) {
-  const { postJson: postJson2 } = await import('./work-cmd-OO6K6ELP.js');
+  const { postJson: postJson2 } = await import('./work-cmd-J2LJ3V4A.js');
   const log = logOf(state);
   const hostKey = await loadHostKey(state.config.configPath);
   const claim = await retrySend(
@@ -1878,6 +1900,7 @@ async function tryClaimAndStart(state, item, queue) {
         kind: queue,
         seconds: LEASE_SECONDS,
         runnerProtocol: RUNNER_PROTOCOL,
+        cliVersion: state.deps.cliVersion ?? resolveVersion(),
         ...hostKey === void 0 ? {} : { hostKey: hostKey.hostKey }
       },
       state.deps.fetchImpl,
@@ -1904,6 +1927,17 @@ async function tryClaimAndStart(state, item, queue) {
       reportRepeating(state, "the organization's billing", claim.message ?? claim.reason);
       return { kind: "read_only" };
     }
+    if (claim.code === "runner_version_unsupported") {
+      if (state.heartbeatSent !== true) return { kind: "outdated" };
+      const floor = claim.lowestVersion ?? "the minimum version";
+      if (state.versionRefusalLogged !== floor) {
+        state.versionRefusalLogged = floor;
+        logOf(state).error(`the gateway refuses work from this runner: it runs ${ownVersionOf(state.deps)}, below ${floor} \xB7 ${upgradeStepFor(state, claim.lowestVersion)}`);
+      }
+      state.upgradeRefused = true;
+      recordImageStatus(state);
+      return { kind: "outdated" };
+    }
     if (claim.code === "runner_upgrade_required") {
       const tag = tagToPull(state.imageNamed);
       reportRepeating(
@@ -1920,6 +1954,7 @@ async function tryClaimAndStart(state, item, queue) {
   reportRepeating(state, "the organization's billing", void 0);
   reportRepeating(state, "the runner protocol", void 0);
   state.upgradeRefused = false;
+  state.versionRefusalLogged = void 0;
   recordImageStatus(state);
   reportRepeating(state, "the request signature", void 0);
   const { data } = claim.value;
@@ -2813,21 +2848,26 @@ async function probeCredentials(config, fetchImpl = fetch) {
     return { ok: true };
   } catch (err) {
     const status = err instanceof WorkCommandError ? err.status : void 0;
+    const code = err instanceof WorkCommandError ? err.code : void 0;
     if (err instanceof WorkCommandError && isSignatureRefusal(err.code)) {
       return {
         ok: false,
         fatal: err.code === "runner_key_signature_invalid",
-        reason: `${config.configPath}: ${err.message}`
+        reason: `${config.configPath}: ${err.message}`,
+        status,
+        code
       };
     }
     if (status === 401 || status === 403) {
       return {
         ok: false,
         fatal: true,
-        reason: `${config.configPath}: the API key was refused (${status}). A runner key needs git.read and work.read to list and read work items, and work.claim to claim, renew and release.`
+        reason: `${config.configPath}: the API key was refused (${status}). A runner key needs git.read and work.read to list and read work items, and work.claim to claim, renew and release.`,
+        status,
+        code
       };
     }
-    return { ok: false, fatal: false, reason: describeCallFailure(err) };
+    return { ok: false, fatal: false, reason: describeCallFailure(err), status, code };
   }
 }
 async function rejoinContainerBuild(state, adopted) {
@@ -3071,6 +3111,15 @@ function hooksOf(configPath) {
   }
 }
 async function start(configPath, deps = { fetchImpl: fetch }) {
+  const startup = {};
+  try {
+    return await startRunner(configPath, deps, startup);
+  } catch (err) {
+    await startup.report?.(err);
+    throw err;
+  }
+}
+async function startRunner(configPath, deps, startup) {
   const log = deps.log ??= createRunnerLog(deps.now ?? (() => /* @__PURE__ */ new Date()));
   takeClaudeCredential(process.env, hooksOf(configPath));
   const update = deps.update;
@@ -3081,7 +3130,7 @@ async function start(configPath, deps = { fetchImpl: fetch }) {
       check: update.check ? () => update.check(configPath) : async () => {
         const held = heldClaudeCredential();
         const env = held === void 0 ? process.env : { ...process.env, [held.variable]: held.value };
-        return (await import('./check-4QNLMDP7.js')).runRunnerCheck(configPath, { fetchImpl: deps.fetchImpl, env });
+        return (await import('./check-XPMN4GHD.js')).runRunnerCheck(configPath, { fetchImpl: deps.fetchImpl, env });
       },
       now: () => (deps.now ?? (() => /* @__PURE__ */ new Date()))().getTime(),
       log
@@ -3092,22 +3141,37 @@ async function start(configPath, deps = { fetchImpl: fetch }) {
     }
   }
   const loaded = loadRunnerConfig(configPath);
+  let check = "hooks";
+  let probeRefusal;
+  startup.report = (err) => reportFailedStart(
+    { config: loaded, cliVersion: deps.cliVersion ?? resolveVersion(), check, error: err, refusal: probeRefusal },
+    deps.fetchImpl
+  );
   const hookProblem = checkHooks(loaded);
   if (hookProblem) throw new RunnerStartError(hookProblem);
+  check = "image";
   const { config, note: fitNote } = fitForImage(deps, loaded);
+  check = "host-key";
   await ensureHostKey(configPath);
+  check = "identity";
   if (builtinKind(config.hooks.provision) === "container" || builtinKind(config.hooks.provision) === "vm") {
     await ensureRunnerIdentity(configPath, {
       docker: deps.runnerIdentity ?? (deps.container?.host === void 0 ? void 0 : { holdsObjects: async () => false }),
       log: (line) => log.error(line)
     }).catch((err) => log.error(`the runner's Docker identity could not be stored: ${describeCallFailure(err)} \xB7 using the names its folder's path gives`));
   }
+  check = "credentials";
   const probe = await probeCredentials(config, deps.fetchImpl);
-  if (!probe.ok && probe.fatal) throw new RunnerStartError(probe.reason);
+  if (!probe.ok && probe.fatal) {
+    probeRefusal = { status: probe.status, code: probe.code };
+    throw new RunnerStartError(probe.reason);
+  }
   if (!probe.ok) log.error(`the gateway did not answer at start: ${probe.reason} \xB7 starting anyway`);
+  check = "pid-file";
   mkdirSync(jobsDir(configPath), { recursive: true, mode: RUNNER_DIR_MODE });
   const self = { pid: process.pid, start: startTimeOf(process.pid) ?? "" };
   claimPidFile(pidFilePath(configPath), self);
+  check = "cgroup";
   const { delegated, refusal } = setUpRunnerCgroup();
   if (refusal !== void 0) log.error(`the kernel refused a cgroup step for the runner's service: ${refusal}`);
   if (isBuiltinVm(config.hooks.provision) && !delegated) {
@@ -3122,6 +3186,7 @@ async function start(configPath, deps = { fetchImpl: fetch }) {
   const state = { config, jobs: /* @__PURE__ */ new Map(), deps, configMtimeMs };
   log.line(`runner ${config.host} started \xB7 config ${configPath} \xB7 ${describeConfig(config)}`);
   if (fitNote !== void 0) log.line(fitNote);
+  check = "recovery";
   const leavesBuilds = await canLeaveBuilds(state);
   let sigusr2Target;
   let sigusr2Early = false;
@@ -3189,6 +3254,7 @@ async function start(configPath, deps = { fetchImpl: fetch }) {
       `recovered job ${recovered.queue} #${recovered.item} (claim ${shortClaim(recovered.claimId)}) as ${recovered.outcome ?? "interrupted"}: ${why}`
     );
   }
+  startup.report = void 0;
   let intakeClosed = false;
   let closed = false;
   let stopping = false;

package/dist/{chunk-XCRET2GZ.js → chunk-Z57X4KNC.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { WorkCommandError, postJson } from './chunk-YXMGHGHR.js';
+import { WorkCommandError, postJson } from './chunk-VSLJ6PPG.js';
 import { defaultGitRunner, materializeContext, fetchControlPlaneCommit, lookupGoverningSource } from './chunk-AKZRGFGT.js';
 import { signingFetchFor } from './chunk-6RKD7YZ6.js';
 import { signerFor } from './chunk-SOI6K5DY.js';
@@ -92,9 +92,10 @@ async function retrySend(send, deps = {}) {
       const code = err instanceof WorkCommandError ? err.code : void 0;
       const status = err instanceof WorkCommandError ? err.status : void 0;
       const message = err instanceof WorkCommandError ? err.message : void 0;
-      if (!isRetryable(err)) return { ok: false, attempts, reason, retryable: false, code, status, message };
+      const lowestVersion = err instanceof WorkCommandError ? err.lowestVersion : void 0;
+      if (!isRetryable(err)) return { ok: false, attempts, reason, retryable: false, code, status, message, lowestVersion };
       const elapsedMs = now().getTime() - startedMs;
-      if (elapsedMs + backoffMs >= windowMs) return { ok: false, attempts, reason, retryable: true, code, status, message };
+      if (elapsedMs + backoffMs >= windowMs) return { ok: false, attempts, reason, retryable: true, code, status, message, lowestVersion };
       await sleep(backoffMs);
       backoffMs = Math.min(backoffMs * 2, MAX_BACKOFF_MS);
     }