@outerlayer/cli 0.5.0 → 0.6.0

package/dist/{chunk-4NMBDRBS.js → chunk-RZSF5B46.js}

@@ -7,23 +7,23 @@ import { createDockerHost, childEnvironment, spawnRun } from './chunk-774HEQL6.j
 import { RecipeError } from './chunk-QOZKPLVJ.js';
 import { execCapture } from './chunk-W4SQCOZU.js';
 import { GUEST_CID } from './chunk-B2G7JHHB.js';
-import { WorkCommandError, postJson } from './chunk-RMAZ2NWA.js';
+import { WorkCommandError, postJson } from './chunk-BNMCXPG7.js';
 import { parseDuKilobytes, hostAllowed } from './chunk-F6GFZXZ3.js';
 import { RELAY_PORT, CHECKOUT_DIR, JOB_MOUNT, claudeCredential, buildEnvironment, startBuildServices, AGENT_CREDENTIAL_MISSING, GATEWAY_PORT, GATEWAY_SOCKET, CLAUDE_PORT, CLAUDE_SOCKET, DESTINATION_BASE_PORT } from './chunk-AUFG23AA.js';
-import { defaultGitRunner, materializeContext } from './chunk-XDDW4FRS.js';
+import { defaultGitRunner, materializeContext } from './chunk-OIRNH6UO.js';
 import { readContextManifest, readSourceCache } from './chunk-WIOZAJ2W.js';
 import { signingFetchFor } from './chunk-BCLJSQCV.js';
 import { signerFor } from './chunk-M5POMKKW.js';
-import { rootfsPathFor, diskTemplatesDir, RUNNER_FILE_MODE, stagedContextDir, contextHomeDir, ghConfigDir, runnerDirOfBuild, spoolDir, mirrorDir, buildDir, RUNNER_DIR_MODE, vmAssetsDir } from './chunk-ZM2IMMYN.js';
-import { relative, join, dirname, basename } from 'path';
+import { rootfsPathFor, diskTemplatesDir, RUNNER_FILE_MODE, stagedContextDir, contextHomeDir, ghConfigDir, runnerDirOfBuild, spoolDir, mirrorDir, buildDir, runnerDir, RUNNER_DIR_MODE, vmAssetsDir } from './chunk-ZM2IMMYN.js';
+import { relative, join, dirname, resolve, basename } from 'path';
+import { readFileSync, existsSync, mkdirSync, chmodSync, truncateSync, rmSync, writeFileSync, accessSync, constants, readdirSync, statSync, rmdirSync, realpathSync, renameSync, lstatSync, unlinkSync, openSync, closeSync, mkdtempSync, createWriteStream, createReadStream } from 'fs';
 import { spawnSync, spawn } from 'child_process';
-import { randomBytes, createHash } from 'crypto';
-import { existsSync, mkdirSync, chmodSync, truncateSync, rmSync, writeFileSync, renameSync, lstatSync, readFileSync, unlinkSync, readdirSync, openSync, closeSync, mkdtempSync, createWriteStream, statSync, createReadStream } from 'fs';
+import { createHash, randomBytes } from 'crypto';
 import { createServer, request } from 'http';
 import { request as request$1 } from 'https';
 import { Transform } from 'stream';
 import { pipeline, finished } from 'stream/promises';
-import { createGunzip, gunzipSync, constants } from 'zlib';
+import { createGunzip, gunzipSync, constants as constants$1 } from 'zlib';
 import { isIP, connect, createServer as createServer$1 } from 'net';
 import { lookup } from 'dns/promises';
 import { networkInterfaces } from 'os';
@@ -86,7 +86,7 @@ function isRetryable(err) {
 }
 async function retrySend(send, deps = {}) {
   const now = deps.now ?? (() => /* @__PURE__ */ new Date());
-  const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const sleep = deps.sleep ?? ((ms) => new Promise((resolve2) => setTimeout(resolve2, ms)));
   const windowMs = deps.windowMs ?? RETRY_WINDOW_MS;
   const startedMs = now().getTime();
   let attempts = 0;
@@ -255,6 +255,111 @@ var BuildTokens = class {
     );
   }
 };
+var BUILD_PREFIX = "build-";
+var LEAF = "runner";
+function serviceDirectory(selfCgroup, mount) {
+  const line = selfCgroup?.split("\n").find((l) => l.startsWith("0::"));
+  if (line === void 0) return void 0;
+  const path = line.slice(3).trim();
+  if (!path.endsWith(".service")) return void 0;
+  return join(mount, path);
+}
+function prepareRunnerCgroup(setup) {
+  if (setup.invocationId === void 0 || setup.invocationId === "") return void 0;
+  const root = serviceDirectory(setup.selfCgroup, setup.mount);
+  if (root === void 0) return void 0;
+  const { fs } = setup;
+  if (!fs.exists(root) || !fs.writable(join(root, "cgroup.procs"))) return void 0;
+  if (!(fs.read(join(root, "cgroup.controllers")) ?? "").split(/\s+/).includes("memory")) return void 0;
+  for (const name of fs.list(root)) {
+    if (!name.startsWith(BUILD_PREFIX)) continue;
+    try {
+      fs.rmdir(join(root, name));
+    } catch {
+    }
+  }
+  if (!fs.exists(join(root, LEAF))) fs.mkdir(join(root, LEAF));
+  fs.write(join(root, LEAF, "cgroup.procs"), String(setup.pid));
+  fs.write(join(root, "cgroup.subtree_control"), "+memory");
+  return { root };
+}
+function createBuildCgroup(fs, root, buildId, buildMemoryBytes) {
+  const path = join(root, `${BUILD_PREFIX}${buildId}`);
+  const firecrackerOverheadBytes = 256 * 1024 ** 2;
+  fs.mkdir(path);
+  try {
+    fs.write(join(path, "memory.max"), String(buildMemoryBytes + firecrackerOverheadBytes));
+    fs.write(join(path, "memory.swap.max"), "0");
+  } catch (err) {
+    removeBuildCgroup(fs, path);
+    throw err;
+  }
+  return path;
+}
+function oomKills(fs, path) {
+  const match = /^oom_kill (\d+)$/m.exec(fs.read(join(path, "memory.events")) ?? "");
+  return match === null ? 0 : Number(match[1]);
+}
+function removeBuildCgroup(fs, path) {
+  try {
+    fs.rmdir(path);
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+  }
+}
+function realCgroupFs() {
+  return {
+    exists: (path) => existsSync(path),
+    read: (path) => {
+      try {
+        return readFileSync(path, "utf8");
+      } catch {
+        return void 0;
+      }
+    },
+    write: (path, data) => writeFileSync(path, data),
+    mkdir: (path) => mkdirSync(path),
+    rmdir: (path) => rmdirSync(path),
+    list: (path) => readdirSync(path).filter((name) => statSync(join(path, name)).isDirectory()),
+    writable: (path) => {
+      try {
+        accessSync(path, constants.W_OK);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+var delegatedRoot;
+function setUpRunnerCgroup(over = {}) {
+  let selfCgroup;
+  try {
+    selfCgroup = readFileSync("/proc/self/cgroup", "utf8");
+  } catch {
+    selfCgroup = void 0;
+  }
+  let refusal;
+  try {
+    const prepared = prepareRunnerCgroup({ fs: realCgroupFs(), selfCgroup, pid: process.pid, invocationId: process.env.INVOCATION_ID, mount: "/sys/fs/cgroup", ...over });
+    delegatedRoot = prepared?.root;
+  } catch (err) {
+    delegatedRoot = void 0;
+    refusal = err instanceof Error ? err.message : String(err);
+  }
+  return { delegated: delegatedRoot !== void 0, ...refusal === void 0 ? {} : { refusal } };
+}
+function realCgroupPort() {
+  const fs = realCgroupFs();
+  return {
+    create: (buildId, bytes) => {
+      if (delegatedRoot === void 0) return void 0;
+      return createBuildCgroup(fs, delegatedRoot, buildId, bytes);
+    },
+    oomKills: (path) => oomKills(fs, path),
+    remove: (path) => removeBuildCgroup(fs, path)
+  };
+}
 var BranchPrepareError = class extends Error {
 };
 var OWN_PREFIX = "outerlayer/";
@@ -356,6 +461,119 @@ function lifecycleSteps(lifecycle) {
 function lifecycleFailureReason(step, exitCode) {
   return `lifecycle command ${step.name} (${step.source}) exited ${exitCode}`;
 }
+var BUILD_LABEL = "ai.outerlayer.build";
+var RUNNER_LABEL = "ai.outerlayer.runner";
+function resolvedRunnerDir(configPath) {
+  try {
+    return realpathSync(runnerDir(configPath));
+  } catch {
+    try {
+      return join(realpathSync(dirname(resolve(configPath))), "runner");
+    } catch {
+      return resolve(runnerDir(configPath));
+    }
+  }
+}
+function runnerLabelValue(configPath) {
+  return createHash("sha256").update(resolvedRunnerDir(configPath)).digest("hex").slice(0, 12);
+}
+function hardened(input) {
+  const { memory, cpus, pids } = input.limits;
+  return [
+    "--label",
+    `${BUILD_LABEL}=${input.buildId}`,
+    "--label",
+    `${RUNNER_LABEL}=${input.runnerId}`,
+    "--network",
+    "none",
+    "--cap-drop",
+    "ALL",
+    "--security-opt",
+    "no-new-privileges",
+    "--read-only",
+    "--user",
+    input.user,
+    // The same figure for swap as for memory leaves the container none.
+    "--memory",
+    memory,
+    "--memory-swap",
+    memory,
+    "--cpus",
+    String(cpus),
+    "--pids-limit",
+    String(pids)
+  ];
+}
+function mountPath(path) {
+  if (/[",]/.test(path)) throw new Error(`${path} holds a comma or a quote, which a Docker mount cannot carry; move the runner's config file`);
+  return path;
+}
+function containerRunArgs(input) {
+  return [
+    "--detach",
+    "--name",
+    input.container,
+    ...hardened(input),
+    "--mount",
+    `type=volume,src=${input.volume},dst=/build`,
+    // `/tmp` is a directory of the same volume, so it is measured and limited with the rest of the build.
+    "--mount",
+    `type=volume,src=${input.volume},dst=/tmp,volume-subpath=tmp`,
+    "--mount",
+    `type=bind,src=${mountPath(input.buildDir)},dst=${JOB_MOUNT},readonly`,
+    "--entrypoint",
+    "/opt/outerlayer/bin/tini",
+    input.image,
+    "--",
+    "/opt/outerlayer/bin/node",
+    "/opt/outerlayer/cli/dist/index.js",
+    "broker-relay",
+    "--port",
+    String(RELAY_PORT),
+    "--socket",
+    `${JOB_MOUNT}/tunnel.sock`,
+    ...Array.from({ length: input.destinations ?? 0 }, (_unused, index) => [
+      "--forward",
+      `${DESTINATION_BASE_PORT + index}=${JOB_MOUNT}/dest-${index}.sock`
+    ]).flat(),
+    ...[
+      "--forward",
+      `${GATEWAY_PORT}=${JOB_MOUNT}/${GATEWAY_SOCKET}`,
+      "--forward",
+      `${CLAUDE_PORT}=${JOB_MOUNT}/${CLAUDE_SOCKET}`
+    ] 
+  ];
+}
+function prepareRunArgs(input) {
+  return [
+    "--rm",
+    ...hardened(input),
+    "--mount",
+    `type=volume,src=${input.volume},dst=/build`,
+    "--entrypoint",
+    "mkdir",
+    input.image,
+    "-p",
+    "-m",
+    "1777",
+    "/build/tmp",
+    "/build/home",
+    "/build/work"
+  ];
+}
+function containerExecArgs(input) {
+  const literals = Object.keys(input.env.literals).sort().flatMap((name) => ["-e", `${name}=${input.env.literals[name]}`]);
+  const passed = Object.keys(input.env.passed).filter((name) => input.env.passed[name] !== void 0).sort().flatMap((name) => ["-e", name]);
+  return [
+    "-u",
+    input.user,
+    ...input.workdir === void 0 ? [] : ["-w", input.workdir],
+    ...literals,
+    ...passed,
+    input.container,
+    ...input.argv
+  ];
+}
 var AssetError = class extends Error {
   constructor(file, message) {
     super(message);
@@ -496,7 +714,7 @@ function converterArgs(dest, extra, script) {
 }
 var firstLine2 = (text) => text.trim().split("\n")[0] ?? "";
 function exportInto(container, converter) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const exporter = spawn("docker", ["export", container], { stdio: ["ignore", "pipe", "pipe"], env: childEnvironment(process.env) });
     const writer = spawn("docker", converter, { stdio: ["pipe", "ignore", "pipe"], env: childEnvironment(process.env) });
     const errors = [];
@@ -513,7 +731,7 @@ function exportInto(container, converter) {
       if (code !== 0 && failure === void 0) failure = `${name} exited ${code}`;
       exits += 1;
       if (exits < 2) return;
-      if (failure === void 0) resolve();
+      if (failure === void 0) resolve2();
       else reject(new Error(`${failure}: ${firstLine2(errors.join("\n"))}`));
     };
     exporter.once("exit", (code) => done("docker export", code));
@@ -634,7 +852,9 @@ function machineConfig(limits2, paths) {
   };
 }
 function firecrackerCommand(input) {
-  return { command: input.binary, args: ["--no-api", "--config-file", input.configPath] };
+  const args = ["--no-api", "--config-file", input.configPath];
+  if (input.cgroup === void 0) return { command: input.binary, args };
+  return { command: "sh", args: ["-c", 'echo $$ > "$1/cgroup.procs" && shift && exec "$@"', "sh", input.cgroup, input.binary, ...args] };
 }
 var STOP_WAIT_MS = 1e4;
 var POLL_MS = 20;
@@ -660,7 +880,7 @@ function createFirecrackerHost(options = {}) {
         const failed = new Promise((_resolve, reject) => child.once("error", reject));
         const pid = child.pid;
         if (pid === void 0) return await failed;
-        exits.set(pid, new Promise((resolve) => child.once("exit", () => resolve())));
+        exits.set(pid, new Promise((resolve2) => child.once("exit", () => resolve2())));
         child.unref();
         const start = startTimeOf(pid);
         if (start === null) throw new Error(`${command} exited as soon as it started; its console is at ${input.consolePath}`);
@@ -677,8 +897,8 @@ function createFirecrackerHost(options = {}) {
       }
       const exited = exits.get(vm.pid);
       const deadline = Date.now() + STOP_WAIT_MS;
-      if (exited !== void 0) await Promise.race([exited, new Promise((resolve) => setTimeout(resolve, STOP_WAIT_MS))]);
-      while (alive(vm) && Date.now() < deadline) await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+      if (exited !== void 0) await Promise.race([exited, new Promise((resolve2) => setTimeout(resolve2, STOP_WAIT_MS))]);
+      while (alive(vm) && Date.now() < deadline) await new Promise((resolve2) => setTimeout(resolve2, POLL_MS));
       exits.delete(vm.pid);
     },
     alive
@@ -688,9 +908,10 @@ function createFirecrackerHost(options = {}) {
 // src/runner/microvm/host.ts
 function createMicroVmPorts(over = {}) {
   return {
-    assets: over.assets ?? ((runnerDir) => ensureAssets({ runnerDir })),
+    assets: over.assets ?? ((runnerDir2) => ensureAssets({ runnerDir: runnerDir2 })),
     rootfs: over.rootfs ?? createRootfsHost(),
     firecracker: over.firecracker ?? createFirecrackerHost(),
+    cgroup: over.cgroup ?? realCgroupPort(),
     exec: over.exec ?? execCapture
   };
 }
@@ -845,104 +1066,6 @@ function removeStagedContext(buildDir2) {
   rmSync(stagedContextDir(buildDir2), { recursive: true, force: true });
 }
 
-// src/runner/container/run-args.ts
-var BUILD_LABEL = "ai.outerlayer.build";
-function hardened(input) {
-  const { memory, cpus, pids } = input.limits;
-  return [
-    "--label",
-    `${BUILD_LABEL}=${input.buildId}`,
-    "--network",
-    "none",
-    "--cap-drop",
-    "ALL",
-    "--security-opt",
-    "no-new-privileges",
-    "--read-only",
-    "--user",
-    input.user,
-    // The same figure for swap as for memory leaves the container none.
-    "--memory",
-    memory,
-    "--memory-swap",
-    memory,
-    "--cpus",
-    String(cpus),
-    "--pids-limit",
-    String(pids)
-  ];
-}
-function mountPath(path) {
-  if (/[",]/.test(path)) throw new Error(`${path} holds a comma or a quote, which a Docker mount cannot carry; move the runner's config file`);
-  return path;
-}
-function containerRunArgs(input) {
-  return [
-    "--detach",
-    "--name",
-    input.container,
-    ...hardened(input),
-    "--mount",
-    `type=volume,src=${input.volume},dst=/build`,
-    // `/tmp` is a directory of the same volume, so it is measured and limited with the rest of the build.
-    "--mount",
-    `type=volume,src=${input.volume},dst=/tmp,volume-subpath=tmp`,
-    "--mount",
-    `type=bind,src=${mountPath(input.buildDir)},dst=${JOB_MOUNT},readonly`,
-    "--entrypoint",
-    "/opt/outerlayer/bin/tini",
-    input.image,
-    "--",
-    "/opt/outerlayer/bin/node",
-    "/opt/outerlayer/cli/dist/index.js",
-    "broker-relay",
-    "--port",
-    String(RELAY_PORT),
-    "--socket",
-    `${JOB_MOUNT}/tunnel.sock`,
-    ...Array.from({ length: input.destinations ?? 0 }, (_unused, index) => [
-      "--forward",
-      `${DESTINATION_BASE_PORT + index}=${JOB_MOUNT}/dest-${index}.sock`
-    ]).flat(),
-    ...[
-      "--forward",
-      `${GATEWAY_PORT}=${JOB_MOUNT}/${GATEWAY_SOCKET}`,
-      "--forward",
-      `${CLAUDE_PORT}=${JOB_MOUNT}/${CLAUDE_SOCKET}`
-    ] 
-  ];
-}
-function prepareRunArgs(input) {
-  return [
-    "--rm",
-    ...hardened(input),
-    "--mount",
-    `type=volume,src=${input.volume},dst=/build`,
-    "--entrypoint",
-    "mkdir",
-    input.image,
-    "-p",
-    "-m",
-    "1777",
-    "/build/tmp",
-    "/build/home",
-    "/build/work"
-  ];
-}
-function containerExecArgs(input) {
-  const literals = Object.keys(input.env.literals).sort().flatMap((name) => ["-e", `${name}=${input.env.literals[name]}`]);
-  const passed = Object.keys(input.env.passed).filter((name) => input.env.passed[name] !== void 0).sort().flatMap((name) => ["-e", name]);
-  return [
-    "-u",
-    input.user,
-    ...input.workdir === void 0 ? [] : ["-w", input.workdir],
-    ...literals,
-    ...passed,
-    input.container,
-    ...input.argv
-  ];
-}
-
 // src/runner/container/docker.ts
 function createContainerHost(deps = {}) {
   const run = deps.run ?? spawnRun;
@@ -1027,9 +1150,9 @@ async function git(args, cwd, env, input) {
     if (size < maxOutputBytes) out.push(chunk);
     size += chunk.length;
   });
-  const closed = new Promise((resolve, reject) => {
+  const closed = new Promise((resolve2, reject) => {
     child.once("error", reject);
-    child.once("close", (status) => resolve(status));
+    child.once("close", (status) => resolve2(status));
   });
   if (input !== void 0) {
     await pipeline(input, child.stdin).catch(() => void 0);
@@ -1078,7 +1201,7 @@ function decode(prefix, gzip) {
   if (!gzip) return prefix;
   try {
     const { compressedWindow, inflatedBytes } = limits();
-    return gunzipSync(prefix.subarray(0, compressedWindow), { finishFlush: constants.Z_SYNC_FLUSH, maxOutputLength: inflatedBytes });
+    return gunzipSync(prefix.subarray(0, compressedWindow), { finishFlush: constants$1.Z_SYNC_FLUSH, maxOutputLength: inflatedBytes });
   } catch (err) {
     const code = err.code;
     if (code === "ERR_BUFFER_TOO_LARGE") return refused(TOO_LONG);
@@ -1226,14 +1349,14 @@ async function drain(req) {
   }
 }
 function readPrefix(req, gzip) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const held = [];
     const finish = (section) => {
       req.off("data", onData);
       req.off("end", onEnd);
       req.off("error", reject);
       req.pause();
-      resolve({ held, section });
+      resolve2({ held, section });
     };
     const onData = (chunk) => {
       held.push(chunk);
@@ -1247,19 +1370,19 @@ function readPrefix(req, gzip) {
   });
 }
 function readBody(req, limit) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const chunks = [];
     let size = 0;
     req.on("data", (chunk) => {
       size += chunk.length;
       if (size > limit) {
         req.pause();
-        resolve(void 0);
+        resolve2(void 0);
         return;
       }
       chunks.push(chunk);
     });
-    req.once("end", () => resolve(Buffer.concat(chunks)));
+    req.once("end", () => resolve2(Buffer.concat(chunks)));
     req.once("error", reject);
   });
 }
@@ -1272,7 +1395,7 @@ function createGitRemote(options) {
     const { route, res } = input;
     const url = new URL(`${gitUrl}/${route.owner}/${route.name}.git/${route.kind === "info-refs" ? "info/refs" : route.kind === "lfs-batch" ? "info/lfs/objects/batch" : `git-${route.kind}`}${route.search === "" ? "" : `?${route.search}`}`);
     const send = url.protocol === "https:" ? request$1 : request;
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       const upstream = send(url, { method: input.method, headers: { ...input.headers, connection: "close" } }, (answer) => {
         const headers = {};
         for (const [name, value] of Object.entries(answer.headers)) {
@@ -1294,18 +1417,18 @@ function createGitRemote(options) {
         });
         answer.once("end", () => {
           res.end();
-          resolve();
+          resolve2();
         });
         answer.once("error", () => {
           res.destroy();
-          resolve();
+          resolve2();
         });
       });
       upstream.on("error", (err) => {
         log(`could not reach GitHub for ${route.kind}: ${err.message}`);
         if (res.headersSent) res.destroy();
         else plain(res, 502, "the runner could not reach GitHub\n");
-        resolve();
+        resolve2();
       });
       res.once("close", () => upstream.destroy());
       input.feed(upstream);
@@ -1594,7 +1717,7 @@ async function startTunnel(socketPath, opts = {}) {
   if (Buffer.byteLength(socketPath) > MAX_SOCKET_PATH_BYTES) {
     throw new Error(`${socketPath} is too long for a Unix socket; keep the runner's config file nearer the root of the filesystem`);
   }
-  const resolve = opts.resolve ?? systemResolve;
+  const resolve2 = opts.resolve ?? systemResolve;
   const openConnection = opts.connect ?? ((t) => connect({ host: t.address, port: t.port }));
   const ownAddresses = opts.hostAddresses ?? systemHostAddresses;
   const connectTimeoutMs = opts.connectTimeoutMs ?? CONNECT_TIMEOUT_MS;
@@ -1678,7 +1801,7 @@ async function startTunnel(socketPath, opts = {}) {
     }
     let addresses;
     try {
-      addresses = await resolve(host);
+      addresses = await resolve2(host);
     } catch {
       return { ok: false, status: 502, body: `could not resolve ${host}
 ` };
@@ -1863,7 +1986,7 @@ function createContainerRuntime(opts = {}) {
     )),
     startTunnel: opts.startTunnel ?? startTunnel,
     tunnelOptions: opts.tunnelOptions,
-    sleep: opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))),
+    sleep: opts.sleep ?? ((ms) => new Promise((resolve2) => setTimeout(resolve2, ms))),
     hostEnv: opts.hostEnv ?? process.env,
     credentials: opts.credentials ?? /* @__PURE__ */ new Map(),
     github: { gitUrl: opts.github?.gitUrl ?? "https://github.com", apiUrl: opts.github?.apiUrl ?? "https://api.github.com" },
@@ -2035,11 +2158,13 @@ async function provisionContainer(input) {
     return bail(`the tunnel could not start: ${describeCallFailure(err)}`);
   }
   const limits2 = { memory: config.build?.memory ?? "8g", cpus: config.build?.cpus ?? 4, pids: config.build?.pids ?? 4096 };
-  const volume = await host.createVolume(name, { [BUILD_LABEL]: buildId });
+  const runnerId = runnerLabelValue(config.configPath);
+  const volume = await host.createVolume(name, { [BUILD_LABEL]: buildId, [RUNNER_LABEL]: runnerId });
   if (volume.status !== 0) return dockerFailed("creating the build's volume", volume);
   if (input.aborted()) return bail("", true);
   const runInput = {
     buildId,
+    runnerId,
     container: name,
     volume: name,
     buildDir: buildDir2,
@@ -2132,6 +2257,40 @@ function containerCommandLine(input) {
     env: { ...childEnvironment(input.runtime.hostEnv), ...env.passed }
   };
 }
+function containerSenderCommand(input) {
+  const state = input.job.container;
+  const env = buildEnvironment({
+    config: input.config,
+    item: input.job.item,
+    itemKey: input.job.itemKey,
+    branch: input.job.branch,
+    repository: state.repository,
+    hostEnv: input.runtime.hostEnv,
+    containerEnv: state.containerEnv ?? {},
+    builtIns: state.builtIns === true,
+    identity: input.job.commitIdentity
+  });
+  const args = containerExecArgs({
+    container: state.container,
+    user: state.agentUser ?? ADDED_USER,
+    workdir: CHECKOUT_DIR,
+    env,
+    argv: ["outerlayer", "session-sender"]
+  });
+  return { command: "docker", args: ["exec", ...args], env: { ...childEnvironment(input.runtime.hostEnv), ...env.passed } };
+}
+function senderSignalScript(pidfile, signal) {
+  const file = shellQuote(pidfile);
+  return `p="$(cat ${file})" && [ -n "$p" ] && grep -qa session-sender "/proc/$p/cmdline" && kill -${signal} "$p"`;
+}
+async function signalInContainer(runtime, state, pidfile, signal) {
+  await runtime.host.exec({
+    container: state.container,
+    user: state.agentUser ?? ADDED_USER,
+    env: NO_ENV,
+    argv: ["/bin/sh", "-c", senderSignalScript(pidfile, signal)]
+  });
+}
 async function stopContainer(runtime, state) {
   await runtime.host.stop(state.container);
   state.stopped = true;
@@ -2230,4 +2389,4 @@ async function cleanupContainer(runtime, state, jobDir) {
   if (failures.length > 0) throw new Error(failures.join("; "));
 }
 
-export { ADDED_USER, AgentUserError, AssetError, BuildTokens, GH_CONFIG_YML, MIN_ENGINE_MAJOR, classifyRefusal, cleanupContainer, containerCommandLine, createBuildDisk, createContainerRuntime, createRunnerLog, deleteBuildDisk, describeCallFailure, ensureRootfs, ensureTunnel, formatClock, formatDuration, ghHostsYml, gitRemoteFor, isLiteralAddress, keepGhConfigCurrent, lifecycleFailureReason, lifecycleSteps, machineConfig, measureDisk, obtainImage, prepareBranch, provisionContainer, refusalCode, relativeToRunner, removeStagedContext, resolveAgentUser, retrySend, runBuildSteps, shellQuote, shortClaim, stageGovernedContext, startServicesFor, stopContainer, syncInContainer };
+export { ADDED_USER, AgentUserError, AssetError, BUILD_LABEL, BuildTokens, GH_CONFIG_YML, MIN_ENGINE_MAJOR, RUNNER_LABEL, classifyRefusal, cleanupContainer, containerCommandLine, containerSenderCommand, createBuildDisk, createContainerRuntime, createRunnerLog, deleteBuildDisk, describeCallFailure, ensureRootfs, ensureTunnel, formatClock, formatDuration, ghHostsYml, gitRemoteFor, isLiteralAddress, keepGhConfigCurrent, lifecycleFailureReason, lifecycleSteps, machineConfig, measureDisk, obtainImage, prepareBranch, provisionContainer, refusalCode, relativeToRunner, removeStagedContext, resolveAgentUser, retrySend, runBuildSteps, runnerLabelValue, senderSignalScript, setUpRunnerCgroup, shellQuote, shortClaim, signalInContainer, stageGovernedContext, startServicesFor, stopContainer, syncInContainer };

package/dist/chunk-T6OIJQRT.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { RUNNER_DIR_MODE, RUNNER_FILE_MODE } from './chunk-ZM2IMMYN.js';
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+
+createRequire(import.meta.url);
+function readJobFile(path) {
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function readJobFileChecked(path) {
+  if (!existsSync(path)) return { kind: "missing" };
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return { kind: "unreadable" };
+    return { kind: "ok", job: parsed };
+  } catch {
+    return { kind: "unreadable" };
+  }
+}
+function writeJobFile(path, job) {
+  mkdirSync(dirname(path), { recursive: true, mode: RUNNER_DIR_MODE });
+  writeFileSync(path, JSON.stringify(job, null, 2), { mode: RUNNER_FILE_MODE });
+}
+
+export { readJobFile, readJobFileChecked, writeJobFile };

package/dist/chunk-UGP76IZ5.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { RUNNER_DIR_MODE, RUNNER_FILE_MODE } from './chunk-ZM2IMMYN.js';
+import { readFileSync, mkdirSync, writeFileSync, renameSync } from 'fs';
+import { join } from 'path';
+
+createRequire(import.meta.url);
+var FILE = "housekeeping.json";
+function readHousekeepingRecord(runnerDirPath) {
+  const path = join(runnerDirPath, FILE);
+  try {
+    const raw = JSON.parse(readFileSync(path, "utf8"));
+    const record = {};
+    if (typeof raw.lastRunAt === "string") record.lastRunAt = raw.lastRunAt;
+    if (typeof raw.freedBytes === "number") record.freedBytes = raw.freedBytes;
+    const holding = raw.holding;
+    if (typeof holding?.free === "number" && typeof holding.needed === "number" && typeof holding.since === "string") {
+      record.holding = { free: holding.free, needed: holding.needed, since: holding.since };
+    }
+    return record;
+  } catch {
+    return {};
+  }
+}
+function writeHousekeepingRecord(runnerDirPath, patch) {
+  const merged = { ...readHousekeepingRecord(runnerDirPath), ...patch };
+  mkdirSync(runnerDirPath, { recursive: true, mode: RUNNER_DIR_MODE });
+  const path = join(runnerDirPath, FILE);
+  const temp = `${path}.partial-${process.pid}`;
+  writeFileSync(temp, JSON.stringify(merged, null, 2), { mode: RUNNER_FILE_MODE });
+  renameSync(temp, path);
+}
+
+export { readHousekeepingRecord, writeHousekeepingRecord };