@ai-development-environment/control-agent 0.0.54 → 0.0.56

package/dist/control-agent.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -3728,15 +3730,15 @@ var require_windows = __commonJS({
       }
       return false;
     }
-    function checkStat(stat9, path, options) {
-      if (!stat9.isSymbolicLink() && !stat9.isFile()) {
+    function checkStat(stat10, path, options) {
+      if (!stat10.isSymbolicLink() && !stat10.isFile()) {
         return false;
       }
       return checkPathExt(path, options);
     }
     function isexe(path, options, cb2) {
-      fs.stat(path, function(er2, stat9) {
-        cb2(er2, er2 ? false : checkStat(stat9, path, options));
+      fs.stat(path, function(er2, stat10) {
+        cb2(er2, er2 ? false : checkStat(stat10, path, options));
       });
     }
     function sync(path, options) {
@@ -3752,20 +3754,20 @@ var require_mode = __commonJS({
     isexe.sync = sync;
     var fs = __require("fs");
     function isexe(path, options, cb2) {
-      fs.stat(path, function(er2, stat9) {
-        cb2(er2, er2 ? false : checkStat(stat9, options));
+      fs.stat(path, function(er2, stat10) {
+        cb2(er2, er2 ? false : checkStat(stat10, options));
       });
     }
     function sync(path, options) {
       return checkStat(fs.statSync(path), options);
     }
-    function checkStat(stat9, options) {
-      return stat9.isFile() && checkMode(stat9, options);
+    function checkStat(stat10, options) {
+      return stat10.isFile() && checkMode(stat10, options);
     }
-    function checkMode(stat9, options) {
-      var mod = stat9.mode;
-      var uid = stat9.uid;
-      var gid = stat9.gid;
+    function checkMode(stat10, options) {
+      var mod = stat10.mode;
+      var uid = stat10.uid;
+      var gid = stat10.gid;
       var myUid = options.uid !== void 0 ? options.uid : process.getuid && process.getuid();
       var myGid = options.gid !== void 0 ? options.gid : process.getgid && process.getgid();
       var u = parseInt("100", 8);
@@ -5164,6 +5166,24 @@ var AgentGraphQLClient = class {
       }
     );
   }
+  async diskSpaceConfiguration() {
+    const data = await this.request(`query AgentDiskSpaceConfiguration {
+      agentDiskSpaceConfiguration {
+        enabled pollIntervalSeconds baseRepoDirectory
+        derivedDataLocationMode derivedDataPath
+        worktrees { id folder }
+      }
+    }`);
+    return data.agentDiskSpaceConfiguration;
+  }
+  reportDiskSpace(input) {
+    return this.request(
+      `mutation ReportAgentDiskSpace($input: AgentDiskSpaceReportInput!) {
+        reportAgentDiskSpace(input: $input)
+      }`,
+      { input }
+    );
+  }
   async pendingJobs(agentId) {
     const data = await this.request(
       `query PendingJobs($agentId: ID!) {
@@ -5592,6 +5612,10 @@ function nullableString(value, name) {
   if (value === null) return null;
   return stringValue2(value, name);
 }
+function optionalNullableString(value, name) {
+  if (value === void 0 || value === null) return null;
+  return stringValue2(value, name);
+}
 function exactKeys(value, allowed, name) {
   const unexpected = Object.keys(value).find((key) => !allowed.includes(key));
   if (unexpected) throw new Error(`Unexpected ${name} field: ${unexpected}`);
@@ -5621,6 +5645,44 @@ function target(value, index) {
     )
   };
 }
+function deleteTarget(value, index) {
+  const item = objectValue2(value, `build data delete targets[${index}]`);
+  exactKeys(
+    item,
+    ["path", "rootPath", "name", "kind", "worktreeId", "worktreePath"],
+    "build data delete target"
+  );
+  const kind = item.kind;
+  if (kind !== void 0 && !["PROJECT", "PENDING", "SHARED_CACHE", "DEVICE_SUPPORT"].includes(kind)) {
+    throw new Error(`build data delete targets[${index}].kind is invalid`);
+  }
+  return {
+    path: stringValue2(item.path, `build data delete targets[${index}].path`),
+    rootPath: stringValue2(
+      item.rootPath,
+      `build data delete targets[${index}].rootPath`
+    ),
+    ...item.name === void 0 ? {} : {
+      name: stringValue2(
+        item.name,
+        `build data delete targets[${index}].name`
+      )
+    },
+    ...kind === void 0 ? {} : { kind },
+    ...item.worktreeId === void 0 ? {} : {
+      worktreeId: optionalNullableString(
+        item.worktreeId,
+        `build data delete targets[${index}].worktreeId`
+      )
+    },
+    ...item.worktreePath === void 0 ? {} : {
+      worktreePath: optionalNullableString(
+        item.worktreePath,
+        `build data delete targets[${index}].worktreePath`
+      )
+    }
+  };
+}
 function buildDataScanPayload(value) {
   const payload = objectValue2(value, "build data scan payload");
   exactKeys(payload, ["mode", "path", "worktrees"], "build data scan payload");
@@ -5651,6 +5713,23 @@ function buildDataTargetsPayload(value) {
   }
   return { targets: payload.targets.map(target) };
 }
+function buildDataDeletePayload(value) {
+  const payload = objectValue2(value, "build data delete payload");
+  exactKeys(payload, ["targets", "source"], "build data delete payload");
+  if (!Array.isArray(payload.targets) || payload.targets.length > 1e4) {
+    throw new Error(
+      "build data delete targets must be an array of at most 10,000 items"
+    );
+  }
+  const source = payload.source ?? "USER";
+  if (source !== "USER" && source !== "AUTOMATIC") {
+    throw new Error("build data delete source is invalid");
+  }
+  return {
+    targets: payload.targets.map(deleteTarget),
+    source
+  };
+}
 
 // ../agent-contract/src/codebases.ts
 var CODEBASE_BROWSE_JOB_KIND = "codebase.browse";
@@ -8987,7 +9066,15 @@ async function runCcusage(payload, timeoutMs, signal, onLog) {
 }
 
 // src/handlers/build-data.ts
-import { lstat, opendir, readdir as readdir2, realpath as realpath2, rm as rm4 } from "node:fs/promises";
+import {
+  lstat,
+  opendir,
+  readdir as readdir2,
+  realpath as realpath2,
+  rm as rm4,
+  stat as stat3,
+  statfs
+} from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
 import { basename as basename2, dirname as dirname2, isAbsolute, join as join4, resolve } from "node:path";
 var successfulProcess2 = {
@@ -9063,10 +9150,13 @@ async function scanRoot(configuredRoot, timeoutMs, signal) {
     };
   }
   const entries = [];
+  const rootStats = await stat3(rootPath2);
+  const volumeId = String(rootStats.dev);
   for (const child of children) {
     signal.throwIfAborted();
     if (!child.isDirectory()) continue;
     const path = join4(rootPath2, child.name);
+    const information = await lstat(path);
     const projectPath = await workspacePath(
       join4(path, "info.plist"),
       timeoutMs,
@@ -9077,7 +9167,9 @@ async function scanRoot(configuredRoot, timeoutMs, signal) {
       rootPath: rootPath2,
       name: child.name,
       kind: projectPath ? "PROJECT" : child.name.toLocaleLowerCase().endsWith(".noindex") ? "SHARED_CACHE" : "PENDING",
-      workspacePath: projectPath
+      workspacePath: projectPath,
+      modifiedAt: information.mtime.toISOString(),
+      volumeId
     });
   }
   entries.sort((first, second) => first.name.localeCompare(second.name));
@@ -9109,7 +9201,9 @@ async function scanDeviceSupport(signal) {
         rootPath: rootPath2,
         name: child.name,
         kind: "DEVICE_SUPPORT",
-        workspacePath: null
+        workspacePath: null,
+        modifiedAt: null,
+        volumeId: null
       })).sort((first, second) => first.name.localeCompare(second.name)),
       warning: null
     };
@@ -9203,7 +9297,7 @@ var sizeBuildData = async (rawPayload, _timeoutMs, signal) => {
   return { ...successfulProcess2, sizes };
 };
 var deleteBuildData = async (rawPayload, _timeoutMs, signal) => {
-  const payload = buildDataTargetsPayload(rawPayload);
+  const payload = buildDataDeletePayload(rawPayload);
   const deleted = [];
   for (const target2 of payload.targets) {
     signal.throwIfAborted();
@@ -9230,9 +9324,120 @@ var deleteBuildData = async (rawPayload, _timeoutMs, signal) => {
   }
   return { ...successfulProcess2, deleted };
 };
+async function sharedCapacityId(canonicalPath, volumeId, signal) {
+  try {
+    const result = await captureCommand({
+      command: "/usr/sbin/diskutil",
+      args: ["info", "-plist", canonicalPath],
+      timeoutMs: 5e3,
+      signal
+    });
+    signal.throwIfAborted();
+    if (result.exitCode !== 0) return volumeId;
+    const information = parsePlist(result.stdout);
+    if (!information || typeof information !== "object") return volumeId;
+    const container = information.APFSContainerReference;
+    return typeof container === "string" && container.trim() ? `apfs:${container.trim()}` : volumeId;
+  } catch {
+    signal.throwIfAborted();
+    return volumeId;
+  }
+}
+async function inspectVolume(configuredPath, role, signal) {
+  signal.throwIfAborted();
+  const canonicalPath = await realpath2(configuredPath);
+  const [information, filesystem] = await Promise.all([
+    stat3(canonicalPath),
+    statfs(canonicalPath, { bigint: true })
+  ]);
+  const id2 = String(information.dev);
+  return {
+    canonicalPath,
+    volume: {
+      id: id2,
+      capacityId: id2,
+      totalBytes: Number(filesystem.blocks * filesystem.bsize),
+      freeBytes: Number(filesystem.bavail * filesystem.bsize),
+      roles: /* @__PURE__ */ new Set([role]),
+      paths: /* @__PURE__ */ new Set([canonicalPath])
+    }
+  };
+}
+async function collectAgentDiskSpace(configuration, signal) {
+  const scanPayload = buildDataScanPayload({
+    mode: configuration.derivedDataLocationMode,
+    path: configuration.derivedDataPath,
+    worktrees: configuration.worktrees
+  });
+  const roots = await configuredRoots(scanPayload);
+  const requested = [
+    { path: "/", role: "MAIN" },
+    ...configuration.baseRepoDirectory ? [{ path: configuration.baseRepoDirectory, role: "BASE_REPO" }] : [],
+    ...roots.map((path) => ({ path, role: "DERIVED_DATA" }))
+  ];
+  const warnings = [];
+  const volumes = /* @__PURE__ */ new Map();
+  for (const request of requested) {
+    signal.throwIfAborted();
+    try {
+      const inspected = await inspectVolume(request.path, request.role, signal);
+      const existing = volumes.get(inspected.volume.id);
+      if (existing) {
+        existing.roles.add(request.role);
+        existing.paths.add(inspected.canonicalPath);
+        existing.totalBytes = inspected.volume.totalBytes;
+        existing.freeBytes = inspected.volume.freeBytes;
+      } else {
+        inspected.volume.capacityId = await sharedCapacityId(
+          inspected.canonicalPath,
+          inspected.volume.id,
+          signal
+        );
+        volumes.set(inspected.volume.id, inspected.volume);
+      }
+    } catch (error) {
+      warnings.push(`${request.path}: ${errorMessage(error)}`);
+    }
+  }
+  const entries = [];
+  const scannedRoots = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    signal.throwIfAborted();
+    let canonical = root;
+    try {
+      canonical = await realpath2(root);
+    } catch {
+    }
+    if (scannedRoots.has(canonical)) continue;
+    scannedRoots.add(canonical);
+    const result = await scanRoot(root, 45e3, signal);
+    if (result.warning) warnings.push(result.warning);
+    for (const entry of result.entries) {
+      if (!entry.modifiedAt || !entry.volumeId) continue;
+      entries.push({
+        ...entry,
+        modifiedAt: entry.modifiedAt,
+        volumeId: entry.volumeId
+      });
+    }
+  }
+  return {
+    observedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    volumes: [...volumes.values()].map((volume) => ({
+      id: volume.id,
+      capacityId: volume.capacityId,
+      totalBytes: volume.totalBytes,
+      freeBytes: volume.freeBytes,
+      roles: [...volume.roles],
+      paths: [...volume.paths]
+    })),
+    entries,
+    warnings: [...new Set(warnings)]
+  };
+}
 
 // src/handlers/codebases.ts
-import { readdir as readdir3, realpath as realpath3, stat as stat3 } from "node:fs/promises";
+import { readdir as readdir3, realpath as realpath3, stat as stat4 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
 import { dirname as dirname3, join as join5, resolve as resolve2 } from "node:path";
 var successfulProcess3 = {
@@ -9311,7 +9516,7 @@ function baseSnapshot(folder) {
 }
 async function fetchedAt(commonDirectory) {
   try {
-    return (await stat3(join5(commonDirectory, "FETCH_HEAD"))).mtime.toISOString();
+    return (await stat4(join5(commonDirectory, "FETCH_HEAD"))).mtime.toISOString();
   } catch {
     return null;
   }
@@ -9322,7 +9527,7 @@ async function inspectCodebaseProcess(selectedFolder, timeoutMs, signal, expecte
   let selected;
   try {
     selected = await realpath3(fallbackFolder);
-    if (!(await stat3(selected)).isDirectory())
+    if (!(await stat4(selected)).isDirectory())
       throw new Error("Folder is not a directory");
   } catch (error) {
     return {
@@ -9492,7 +9697,7 @@ var browseCodebaseDirectories = async (payload) => {
   const input = codebaseBrowsePayload(payload);
   const homePath = await realpath3(homedir5());
   const path = await realpath3(input.path ? resolve2(input.path) : homePath);
-  if (!(await stat3(path)).isDirectory())
+  if (!(await stat4(path)).isDirectory())
     throw new Error("Path is not a directory");
   const candidates = await readdir3(path, { withFileTypes: true });
   const entries = [];
@@ -9506,7 +9711,7 @@ var browseCodebaseDirectories = async (payload) => {
     } else if (candidate.isSymbolicLink()) {
       try {
         const target2 = join5(path, candidate.name);
-        if ((await stat3(target2)).isDirectory()) {
+        if ((await stat4(target2)).isDirectory()) {
           entries.push({
             name: candidate.name,
             path: target2,
@@ -10115,7 +10320,7 @@ import {
   readdir as readdir4,
   rename as rename2,
   rm as rm5,
-  stat as stat4,
+  stat as stat5,
   writeFile as writeFile4
 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
@@ -10174,7 +10379,7 @@ var PROJECT_ROOTS = {
 };
 async function directoryExists(path) {
   try {
-    return (await stat4(path)).isDirectory();
+    return (await stat5(path)).isDirectory();
   } catch {
     return false;
   }
@@ -10508,7 +10713,7 @@ var applySkills = async (payload) => {
 };
 
 // src/handlers/runs.ts
-import { readFile as readFile4, readdir as readdir5, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile4, readdir as readdir5, stat as stat6 } from "node:fs/promises";
 import { homedir as homedir7 } from "node:os";
 import { join as join7 } from "node:path";
 var successfulProcess5 = {
@@ -10519,7 +10724,7 @@ var successfulProcess5 = {
 };
 async function fileExists(path) {
   try {
-    return (await stat5(path)).isFile();
+    return (await stat6(path)).isFile();
   } catch {
     return false;
   }
@@ -10574,7 +10779,7 @@ var readRunSession = async (payload) => {
       `No ${input.provider === "CLAUDE" ? "Claude" : "Codex"} session file found for this run on this agent`
     );
   }
-  const { size } = await stat5(path);
+  const { size } = await stat6(path);
   if (size > MAX_RUN_SESSION_FILE_BYTES) {
     throw new Error(
       `Session file is too large to export (${size} bytes exceeds the ${MAX_RUN_SESSION_FILE_BYTES} byte limit)`
@@ -10594,7 +10799,7 @@ import {
   readFile as readFile6,
   realpath as realpath6,
   rm as rm8,
-  stat as stat7,
+  stat as stat8,
   writeFile as writeFile6
 } from "node:fs/promises";
 import { tmpdir as tmpdir5 } from "node:os";
@@ -10792,7 +10997,7 @@ import {
   realpath as realpath5,
   rename as rename3,
   rm as rm7,
-  stat as stat6,
+  stat as stat7,
   writeFile as writeFile5
 } from "node:fs/promises";
 import { createReadStream as createReadStream3, createWriteStream } from "node:fs";
@@ -11058,7 +11263,7 @@ function requireSuccess2(result, fallback) {
 }
 async function validateWorktree(input, timeoutMs, signal) {
   const folder = await realpath5(input.folder);
-  if (!(await stat6(folder)).isDirectory())
+  if (!(await stat7(folder)).isDirectory())
     throw new Error("Worktree is missing");
   const gitDirectory2 = requireSuccess2(
     await command(
@@ -11105,7 +11310,7 @@ async function validateSource(root, source) {
   if (difference === ".." || difference.startsWith(`..${sep4}`) || isAbsolute4(difference)) {
     throw new Error("Build source resolves outside the worktree");
   }
-  const information = await stat6(resolved);
+  const information = await stat7(resolved);
   if (source.kind === "PACKAGE" && !information.isFile()) {
     throw new Error("Package.swift is missing");
   }
@@ -11221,7 +11426,7 @@ async function workspaceProjectPaths(workspacePath2, folder) {
     try {
       const resolved = await realpath5(candidate);
       const resolvedDifference = relative4(folder, resolved);
-      if (resolvedDifference === ".." || resolvedDifference.startsWith(`..${sep4}`) || isAbsolute4(resolvedDifference) || !(await stat6(resolved)).isDirectory()) {
+      if (resolvedDifference === ".." || resolvedDifference.startsWith(`..${sep4}`) || isAbsolute4(resolvedDifference) || !(await stat7(resolved)).isDirectory()) {
         continue;
       }
       projects.push(resolved);
@@ -11916,10 +12121,10 @@ function runLoggedCommand(options) {
       let remainder = "";
       const drain = (final = false) => {
         while (remainder) {
-          const delimiter = remainder.search(/[\r\n]/);
-          if (delimiter < 0 && !final) return;
-          let end = delimiter < 0 ? remainder.length : delimiter + 1;
-          if (remainder[delimiter] === "\r" && remainder[delimiter + 1] === "\n") {
+          const delimiter2 = remainder.search(/[\r\n]/);
+          if (delimiter2 < 0 && !final) return;
+          let end = delimiter2 < 0 ? remainder.length : delimiter2 + 1;
+          if (remainder[delimiter2] === "\r" && remainder[delimiter2 + 1] === "\n") {
             end += 1;
           }
           const record = remainder.slice(0, end);
@@ -12272,14 +12477,14 @@ if (typeof hookModule.default === "function") {
 }
 async function pathExists(path) {
   try {
-    await stat6(path);
+    await stat7(path);
     return true;
   } catch {
     return false;
   }
 }
 async function pathSize(path) {
-  const information = await stat6(path);
+  const information = await stat7(path);
   if (information.isFile()) return information.size;
   if (!information.isDirectory()) return 0;
   let size = 0;
@@ -12291,7 +12496,7 @@ async function pathSize(path) {
 }
 async function fileChecksum(path) {
   try {
-    const information = await stat6(path);
+    const information = await stat7(path);
     if (!information.isFile()) return null;
     const hash = createHash5("sha256");
     await pipeline(createReadStream3(path), hash);
@@ -12875,10 +13080,10 @@ var runIosBuild = async (payload, timeoutMs, signal, onLog, context) => {
     const testProductsPath = input.advancedSettings.priorTestProductsPath;
     const xctestrunPath = input.advancedSettings.priorXctestrunPath;
     if (testProductsPath) {
-      if (!testProductsPath.endsWith(".xctestproducts") || !await pathExists(testProductsPath) || !(await stat6(testProductsPath)).isDirectory()) {
+      if (!testProductsPath.endsWith(".xctestproducts") || !await pathExists(testProductsPath) || !(await stat7(testProductsPath)).isDirectory()) {
         throw new Error("The captured test-products artifact is unavailable");
       }
-    } else if (!xctestrunPath?.endsWith(".xctestrun") || !await pathExists(xctestrunPath) || !(await stat6(xctestrunPath)).isFile()) {
+    } else if (!xctestrunPath?.endsWith(".xctestrun") || !await pathExists(xctestrunPath) || !(await stat7(xctestrunPath)).isFile()) {
       throw new Error("The captured .xctestrun artifact is unavailable");
     }
   }
@@ -13176,7 +13381,7 @@ var downloadIosBuildArtifact = async (payload, timeoutMs, signal, onLog, context
   if (!difference || difference === ".." || difference.startsWith(`..${sep4}`) || isAbsolute4(difference)) {
     throw new Error("Build artifact resolves outside the build folder");
   }
-  const information = await stat6(target2);
+  const information = await stat7(target2);
   let uploadPath = target2;
   let filename = basename3(target2);
   let contentType = "application/octet-stream";
@@ -13560,7 +13765,7 @@ var success = {
 var runWorkflowTerminal = async (payloadValue, timeoutMs, signal, onLog, context) => {
   const payload = parseWorkflowTerminalPayload(payloadValue);
   const cwd = await realpath6(payload.cwd);
-  const information = await stat7(cwd);
+  const information = await stat8(cwd);
   if (!information.isDirectory())
     throw new Error("Workflow working directory is not a directory");
   const directory = await mkdtemp5(join10(tmpdir5(), "aide-workflow-"));
@@ -13657,7 +13862,7 @@ var runWorkflowGitCheckpoint = async (payloadValue, _timeoutMs, signal) => {
 
 // src/handlers/worktrees.ts
 import { createWriteStream as createWriteStream2, watch } from "node:fs";
-import { mkdtemp as mkdtemp6, open as open2, readFile as readFile7, realpath as realpath7, rm as rm9, stat as stat8 } from "node:fs/promises";
+import { mkdtemp as mkdtemp6, open as open2, readFile as readFile7, realpath as realpath7, rm as rm9, stat as stat9 } from "node:fs/promises";
 import { tmpdir as tmpdir6 } from "node:os";
 import { basename as basename4, dirname as dirname6, isAbsolute as isAbsolute5, join as join11, relative as relative5 } from "node:path";
 import { spawn as spawn6 } from "node:child_process";
@@ -13714,7 +13919,7 @@ async function rebaseInProgress(folder, timeoutMs, signal) {
     const candidate = pathResult.stdout.trim();
     if (!candidate) continue;
     try {
-      await stat8(isAbsolute5(candidate) ? candidate : join11(folder, candidate));
+      await stat9(isAbsolute5(candidate) ? candidate : join11(folder, candidate));
       return true;
     } catch {
     }
@@ -13928,7 +14133,7 @@ async function origin(folder, timeoutMs, signal) {
 }
 async function validateWorktree2(input, timeoutMs, signal) {
   const folder = await realpath7(input.folder);
-  if (!(await stat8(folder)).isDirectory())
+  if (!(await stat9(folder)).isDirectory())
     throw new Error("Worktree is missing");
   const observedGitDirectory = await gitDirectory(folder, timeoutMs, signal);
   if (observedGitDirectory !== input.gitDirectory) {
@@ -14169,7 +14374,7 @@ function parseNumstat(value) {
 }
 async function untrackedLines(folder, path) {
   try {
-    const file = await stat8(`${folder}/${path}`);
+    const file = await stat9(`${folder}/${path}`);
     if (!file.isFile() || file.size > 1024 * 1024) return null;
     const contents = await readFile7(`${folder}/${path}`);
     if (contents.includes(0)) return null;
@@ -14465,7 +14670,7 @@ async function availableSide(side, folder, timeoutMs, signal) {
   try {
     const resolved = await realpath7(side.path);
     const difference = relative5(folder, resolved);
-    return difference !== ".." && !difference.startsWith("../") && (await stat8(resolved)).isFile();
+    return difference !== ".." && !difference.startsWith("../") && (await stat9(resolved)).isFile();
   } catch {
     return false;
   }
@@ -14734,7 +14939,7 @@ var downloadWorktreeDiffAsset = async (payload, timeoutMs, signal, _onLog, conte
         signal
       );
     }
-    const information = await stat8(uploadPath);
+    const information = await stat9(uploadPath);
     if (!information.isFile() || information.size > 20 * 1024 * 1024) {
       throw new Error("Diff image exceeds the 20 MiB limit");
     }
@@ -14925,7 +15130,7 @@ async function chooseNewBranch(folder, candidates, allowedCurrentBranch, timeout
 }
 async function validateBranchRoot(input, timeoutMs, signal) {
   const rootFolder = await realpath7(input.rootFolder);
-  if (!(await stat8(rootFolder)).isDirectory()) {
+  if (!(await stat9(rootFolder)).isDirectory()) {
     throw new Error("Base repository is missing");
   }
   if (await origin(rootFolder, timeoutMs, signal) !== input.expectedOrigin) {
@@ -14994,7 +15199,7 @@ var branchWorktree = async (payload, timeoutMs, signal) => {
   ) : changeFolder;
   if (input.action === "CREATE") {
     try {
-      await stat8(targetFolder);
+      await stat9(targetFolder);
       throw new Error(`Worktree folder already exists: ${targetFolder}`);
     } catch (error) {
       if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
@@ -15233,7 +15438,7 @@ var checkoutMovedWorktree = async (payload, timeoutMs, signal) => {
       `${basename4(rootFolder)}-${input.branch.replaceAll("/", "-")}`
     );
     try {
-      await stat8(targetFolder);
+      await stat9(targetFolder);
       throw new Error(`Worktree folder already exists: ${targetFolder}`);
     } catch (error) {
       if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
@@ -15394,7 +15599,7 @@ var checkoutMovedWorktree = async (payload, timeoutMs, signal) => {
 var deleteWorktree = async (payload, timeoutMs, signal) => {
   const input = worktreeDeleteJobPayload(payload);
   const rootFolder = await realpath7(input.rootFolder);
-  if (!(await stat8(rootFolder)).isDirectory()) {
+  if (!(await stat9(rootFolder)).isDirectory()) {
     throw new Error("Base repository is missing");
   }
   if (await origin(rootFolder, timeoutMs, signal) !== input.expectedOrigin) {
@@ -15942,7 +16147,7 @@ var CodebaseMonitor = class {
 // src/runs/run-manager.ts
 import { execFile as execFile4 } from "node:child_process";
 import { mkdir as mkdir6, rm as rm13 } from "node:fs/promises";
-import { dirname as dirname8, join as join15 } from "node:path";
+import { dirname as dirname8, join as join16 } from "node:path";
 import { promisify as promisify4 } from "node:util";
 
 // src/runs/journal.ts
@@ -16095,6 +16300,9 @@ var RunJournal = class {
 
 // src/runs/claude-adapter.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
+import { accessSync, constants } from "node:fs";
+import { homedir as homedir8 } from "node:os";
+import { delimiter, join as join14 } from "node:path";
 
 // ../../node_modules/@anthropic-ai/claude-agent-sdk/sdk.mjs
 import { createRequire as RV } from "node:module";
@@ -41902,6 +42110,28 @@ function answerArrays(value) {
 }
 
 // src/runs/claude-adapter.ts
+function isExecutable(path) {
+  try {
+    accessSync(path, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findClaudeCodeExecutable(options = {}) {
+  const env = options.env ?? process.env;
+  const home = options.home ?? homedir8();
+  const platform = options.platform ?? process.platform;
+  const executable = platform === "win32" ? "claude.exe" : "claude";
+  const candidates = [
+    env.CONTROL_AGENT_CLAUDE_EXECUTABLE?.trim(),
+    ...(env.PATH ?? "").split(delimiter).filter(Boolean).map((directory) => join14(directory, executable)),
+    join14(home, ".local", "bin", executable),
+    ...platform === "darwin" ? ["/opt/homebrew/bin/claude", "/usr/local/bin/claude"] : []
+  ].filter((candidate) => Boolean(candidate));
+  const canExecute = options.isExecutable ?? isExecutable;
+  return [...new Set(candidates)].find(canExecute);
+}
 var MessageQueue = class {
   values = [];
   waiters = [];
@@ -42035,9 +42265,11 @@ var ClaudeAdapter = class {
   catalog() {
     this.catalogPromise ??= (async () => {
       const messages = new MessageQueue();
+      const pathToClaudeCodeExecutable = findClaudeCodeExecutable();
       const instance = uAt({
         prompt: messages,
         options: {
+          ...pathToClaudeCodeExecutable ? { pathToClaudeCodeExecutable } : {},
           env: claudeEnvironment(),
           permissionMode: "plan"
         }
@@ -42071,9 +42303,11 @@ var ClaudeAdapter = class {
     const effort = ["low", "medium", "high", "xhigh", "max"].includes(
       input.run.effort ?? ""
     ) ? input.run.effort : void 0;
+    const pathToClaudeCodeExecutable = findClaudeCodeExecutable();
     activeQuery = uAt({
       prompt: messages,
       options: {
+        ...pathToClaudeCodeExecutable ? { pathToClaudeCodeExecutable } : {},
         cwd: input.run.worktree.folder,
         ...input.run.model !== "default" ? { model: input.run.model } : {},
         ...effort ? { effort } : {},
@@ -42236,7 +42470,7 @@ import {
 } from "node:child_process";
 import { mkdtemp as mkdtemp7, rm as rm12, writeFile as writeFile8 } from "node:fs/promises";
 import { tmpdir as tmpdir7 } from "node:os";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 import { createInterface } from "node:readline";
 import { promisify as promisify3 } from "node:util";
 var SUPPORTED_CODEX_APP_SERVER_MINORS = ["0.144", "0.145"];
@@ -42363,7 +42597,7 @@ var CodexAppServer = class {
     }
   }
   async createBundledModelCatalog() {
-    const directory = await mkdtemp7(join14(tmpdir7(), "aide-codex-models-"));
+    const directory = await mkdtemp7(join15(tmpdir7(), "aide-codex-models-"));
     try {
       const { stdout } = await execFileAsync2(
         "codex",
@@ -42373,7 +42607,7 @@ var CodexAppServer = class {
           maxBuffer: 16 * 1024 * 1024
         }
       );
-      const catalogPath = join14(directory, "models.json");
+      const catalogPath = join15(directory, "models.json");
       await writeFile8(catalogPath, stdout, "utf8");
       this.modelCatalogDirectory = directory;
       return catalogPath;
@@ -49067,7 +49301,7 @@ var RunManager = class {
         5
       );
       await this.completeCommand(command3.id, "SUCCEEDED");
-      await rm13(join15(dirname8(configPath()), "runs", run.id, "attachments"), {
+      await rm13(join16(dirname8(configPath()), "runs", run.id, "attachments"), {
         recursive: true,
         force: true
       }).catch(() => void 0);
@@ -49248,7 +49482,7 @@ var RunManager = class {
         this.active.delete(run.id);
       this.interruptionRequests.delete(run.id);
       this.executingCommands.delete(command3.id);
-      await rm13(join15(dirname8(configPath()), "runs", run.id, "attachments"), {
+      await rm13(join16(dirname8(configPath()), "runs", run.id, "attachments"), {
         recursive: true,
         force: true
       }).catch(() => void 0);
@@ -49476,11 +49710,11 @@ var RunManager = class {
   }
   async stageAttachments(runId, attachments) {
     if (!attachments.length) return [];
-    const directory = join15(dirname8(configPath()), "runs", runId, "attachments");
+    const directory = join16(dirname8(configPath()), "runs", runId, "attachments");
     await mkdir6(directory, { recursive: true, mode: 448 });
     return Promise.all(
       attachments.map(async (attachment) => {
-        const path = join15(
+        const path = join16(
           directory,
           `${attachment.id}-${safeFilename(attachment.filename)}`
         );
@@ -49596,6 +49830,10 @@ var RunManager = class {
   }
 };
 
+// ../agent-contract/src/disk-space.ts
+var DISK_SPACE_POLL_INTERVAL_SECONDS = 60;
+var DISK_SPACE_STALE_AFTER_SECONDS = DISK_SPACE_POLL_INTERVAL_SECONDS * 2;
+
 // src/agent-runtime.ts
 function configuredIntervalMs(value, fallbackSeconds, minSeconds, maxSeconds) {
   return (Number.isInteger(value) && value >= minSeconds && value <= maxSeconds ? value : fallbackSeconds) * 1e3;
@@ -49618,6 +49856,9 @@ async function runAgent(config, signal) {
   let heartbeatTimer;
   let jobReconciliationTimer;
   let codebaseTimer;
+  let diskSpaceTimer;
+  let diskSpaceRunning = false;
+  let diskSpaceIntervalMs = DISK_SPACE_POLL_INTERVAL_SECONDS * 1e3;
   let startupRecoveryPending = true;
   const interruptedJobs = /* @__PURE__ */ new Set();
   const reconcileJobs = async (recoverInterrupted) => {
@@ -49771,11 +50012,48 @@ async function runAgent(config, signal) {
     codebaseTimer = void 0;
     void reconcileCodebases();
   };
+  const scheduleDiskSpacePoll = () => {
+    if (diskSpaceTimer) clearTimeout(diskSpaceTimer);
+    if (!signal.aborted) {
+      diskSpaceTimer = setTimeout(
+        () => void runDiskSpacePoll(),
+        diskSpaceIntervalMs
+      );
+    }
+  };
+  const runDiskSpacePoll = async () => {
+    if (diskSpaceRunning || signal.aborted) return;
+    diskSpaceRunning = true;
+    if (diskSpaceTimer) clearTimeout(diskSpaceTimer);
+    diskSpaceTimer = void 0;
+    try {
+      const configuration = await client2.diskSpaceConfiguration();
+      diskSpaceIntervalMs = Math.max(
+        1e3,
+        configuration.pollIntervalSeconds * 1e3
+      );
+      if (configuration.enabled) {
+        const report = await collectAgentDiskSpace(configuration, signal);
+        await client2.reportDiskSpace(report);
+      }
+    } catch (error) {
+      if (!signal.aborted) {
+        console.error(
+          "Disk space poll failed:",
+          error instanceof Error ? error.message : error
+        );
+      }
+    } finally {
+      diskSpaceRunning = false;
+      scheduleDiskSpacePoll();
+    }
+  };
   await refreshCadence();
   await heartbeat();
   await runJobReconciliation();
   await runManager.start();
   void reconcileCodebases();
+  void runDiskSpacePoll();
   const subscriptionClient = createAgentSubscriptionClient(config);
   const unsubscribe = subscribeToAgentEvents(
     subscriptionClient,
@@ -49788,11 +50066,14 @@ async function runAgent(config, signal) {
         requestCodebaseReconcile();
       } else if (event.type === "RUN_COMMAND_AVAILABLE") {
         runManager.execute(event.runCommand);
+      } else if (event.type === "DISK_SPACE_POLL_REQUESTED") {
+        void runDiskSpacePoll();
       } else {
         void refreshCadence().then(() => {
           scheduleHeartbeat();
           scheduleJobReconciliation();
           requestCodebaseReconcile();
+          void runDiskSpacePoll();
         });
       }
     }
@@ -49804,6 +50085,7 @@ async function runAgent(config, signal) {
   if (heartbeatTimer) clearTimeout(heartbeatTimer);
   if (jobReconciliationTimer) clearTimeout(jobReconciliationTimer);
   if (codebaseTimer) clearTimeout(codebaseTimer);
+  if (diskSpaceTimer) clearTimeout(diskSpaceTimer);
   unsubscribe();
   await subscriptionClient.dispose();
   await executor.cancelAll();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-development-environment/control-agent",
-  "version": "0.0.54",
+  "version": "0.0.56",
   "description": "Control agent for the AI Development Environment",
   "license": "MIT",
   "repository": {
@@ -28,7 +28,8 @@
     "ws": "8.21.1"
   },
   "scripts": {
-    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node24 --outfile=dist/control-agent.js --banner:js=\"#!/usr/bin/env node\"",
+    "build": "node esbuild.config.mjs",
+    "smoke": "node dist/control-agent.js --help",
     "prepublishOnly": "npm run build",
     "dev": "node --watch --watch-preserve-output --import tsx src/index.ts dev",
     "format": "prettier --write --ignore-path ../../.gitignore --ignore-path ../../.prettierignore .",
@@ -38,8 +39,8 @@
     "type-check": "tsc --noEmit -p tsconfig.json",
     "test": "vitest",
     "test:run": "vitest run",
-    "full-check": "npm run format && npm run lint:fix && npm run type-check && npm run test:run && npm run build",
-    "full-check:ci": "npm run format:check && npm run lint && npm run type-check && npm run test:run && npm run build",
+    "full-check": "npm run format && npm run lint:fix && npm run type-check && npm run test:run && npm run build && npm run smoke",
+    "full-check:ci": "npm run format:check && npm run lint && npm run type-check && npm run test:run && npm run build && npm run smoke",
     "full-check:dev": "npm run full-check && npm run dev",
     "upgrade": "ncu -u --cooldown 48h && npm install",
     "upgrade:check": "ncu --cooldown 48h"