@ai-devkit/agent-manager 0.38.0 → 0.40.0

package/dist/utils/process.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/process.ts"],"sourcesContent":["/**\n * Process Detection Utilities\n *\n * Shared shell command wrappers for detecting and inspecting running processes.\n * Built-in refresh discovery uses captureProcessSnapshot(); synchronous helpers\n * remain exported for compatibility with existing consumers.\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { execFile, execFileSync } from \"child_process\";\nimport type { ProcessInfo } from \"../adapters/AgentAdapter.js\";\n\nconst PROCESS_EXEC_MAX_BUFFER = 10 * 1024 * 1024;\nconst VALID_EXECUTABLE_NAME = /^[a-zA-Z0-9_-]+$/;\nconst ABSOLUTE_PATH = /^(?:\\/|[a-zA-Z]:[\\\\/])/;\nconst PATH_SEPARATOR = /[\\\\/]/;\n\nfunction pathBasename(executable: string): string {\n  return path.basename(executable.replace(/\\\\/g, \"/\")).toLowerCase();\n}\n\nfunction isFile(filePath: string): boolean {\n  try {\n    return fs.statSync(filePath, { throwIfNoEntry: false })?.isFile() ?? false;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolve argv[0] from a `ps` command line.\n *\n * `ps` joins argv with spaces, so an executable installed under a directory\n * containing spaces (`/Applications/Some App.app/Contents/Resources/codex`)\n * spans several whitespace tokens. When the first token of an absolute path\n * is not itself a file, longer space-joined prefixes ending in a token with a\n * path separator are tried, and the first one that exists on disk wins.\n * Otherwise the first token is returned, so arguments are never folded into\n * the executable path unless that combined path really is a file.\n */\nexport function executablePath(command: string): string {\n  const parts = command.trim().split(/(\\s+)/);\n  const first = parts[0] ?? \"\";\n  if (parts.length === 1 || !ABSOLUTE_PATH.test(first) || isFile(first)) return first;\n\n  let prefix = first;\n  for (let i = 2; i < parts.length; i += 2) {\n    prefix += parts[i - 1] + parts[i];\n    if (PATH_SEPARATOR.test(parts[i]) && isFile(prefix)) return prefix;\n  }\n  return first;\n}\n\nexport function executableBasename(command: string): string {\n  return pathBasename(executablePath(command));\n}\n\nfunction normalizeExecutableName(name: string): string {\n  const lower = name.toLowerCase();\n  return lower.endsWith(\".exe\") ? lower.slice(0, -4) : lower;\n}\n\nfunction normalizedProcessNames(namePatterns: readonly string[]): Set<string> {\n  return new Set(namePatterns.filter(Boolean).map(normalizeExecutableName));\n}\n\n/**\n * Whether argv[0] of `command` is one of `names`.\n *\n * The first token is checked with string operations only, as before. The\n * filesystem is consulted only for absolute commands where a later\n * path-like token ends in one of the names, i.e. a possible executable under\n * a directory containing spaces.\n */\nfunction matchesExecutableName(command: string, names: ReadonlySet<string>): boolean {\n  const tokens = command.trim().split(/\\s+/);\n  const first = tokens[0] ?? \"\";\n  if (names.has(normalizeExecutableName(pathBasename(first)))) return true;\n  if (!ABSOLUTE_PATH.test(first)) return false;\n\n  const mayContinuePath = tokens\n    .slice(1)\n    .some(\n      (token) =>\n        PATH_SEPARATOR.test(token) && names.has(normalizeExecutableName(pathBasename(token))),\n    );\n  return mayContinuePath && names.has(normalizeExecutableName(executableBasename(command)));\n}\n\nexport function filterByProcessNames(\n  processes: readonly ProcessInfo[],\n  namePatterns: readonly string[],\n): ProcessInfo[] {\n  const names = normalizedProcessNames(namePatterns);\n  if (names.size === 0) return [];\n  return processes.filter((process) => matchesExecutableName(process.command, names));\n}\n\n/**\n * List running processes matching an agent executable name.\n *\n * Uses `ps -axo` then filters in JS for exact executable basename match.\n * This avoids shell pipelines and string interpolation.\n *\n * Returned ProcessInfo has pid, ppid, command, tty populated.\n * cwd and startTime are NOT populated — call enrichProcesses() to fill them.\n */\nexport function listAgentProcesses(namePattern: string): ProcessInfo[] {\n  // Validate pattern contains only safe characters (alphanumeric, dash, underscore)\n  if (!namePattern || !VALID_EXECUTABLE_NAME.test(namePattern)) {\n    return [];\n  }\n\n  try {\n    const output = execFileSync(\"ps\", [\"-axo\", \"pid=,ppid=,tty=,command=\"], { encoding: \"utf-8\" });\n\n    const names = normalizedProcessNames([namePattern]);\n    const processes: ProcessInfo[] = [];\n\n    for (const line of output.trim().split(\"\\n\")) {\n      if (!line.trim()) continue;\n\n      const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n      if (!match) continue;\n\n      const pid = parseInt(match[1], 10);\n      const ppid = parseInt(match[2], 10);\n      if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n\n      const tty = match[3];\n      const command = match[4];\n\n      if (!matchesExecutableName(command, names)) continue;\n\n      const ttyShort = tty.startsWith(\"/dev/\") ? tty.slice(5) : tty;\n\n      processes.push({\n        pid,\n        ppid,\n        command,\n        cwd: \"\",\n        tty: ttyShort,\n      });\n    }\n\n    return processes;\n  } catch {\n    return [];\n  }\n}\n\n/** Runs an executable and resolves with its stdout. Injectable for tests. */\nexport type ProcessExec = (file: string, args: readonly string[]) => Promise<string>;\n\nexport interface ProcessSnapshotOptions {\n  /**\n   * Decides which name-matched processes are worth enriching with cwd and\n   * start time. Non-candidates are still returned (pid, ppid, tty, command\n   * only) so adapters can walk parent chains. Omitted = enrich everything.\n   */\n  isCandidate?: (process: ProcessInfo) => boolean;\n}\n\nexport type ProcessSnapshotCapture = (\n  namePatterns: readonly string[],\n  options?: ProcessSnapshotOptions,\n) => Promise<ProcessInfo[]>;\n\nconst execFileText: ProcessExec = (file, args) =>\n  new Promise((resolve, reject) => {\n    execFile(\n      file,\n      args,\n      { encoding: \"utf-8\", maxBuffer: PROCESS_EXEC_MAX_BUFFER },\n      (error, stdout) => {\n        if (error) {\n          reject(error);\n          return;\n        }\n        resolve(stdout);\n      },\n    );\n  });\n\ninterface ParsedProcessList {\n  /** Every PID in the listing, used to evict cache entries for exited processes. */\n  allPids: Set<number>;\n  /** Processes whose executable matches one of the requested names. */\n  matched: ProcessInfo[];\n}\n\nfunction parseProcessList(output: string, namePatterns: ReadonlySet<string>): ParsedProcessList {\n  const allPids = new Set<number>();\n  const matched: ProcessInfo[] = [];\n\n  for (const line of output.trim().split(\"\\n\")) {\n    if (!line.trim()) continue;\n\n    const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n    if (!match) continue;\n\n    const pid = parseInt(match[1], 10);\n    const ppid = parseInt(match[2], 10);\n    if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n    allPids.add(pid);\n\n    const tty = match[3];\n    const command = match[4];\n    if (!matchesExecutableName(command, namePatterns)) continue;\n\n    matched.push({\n      pid,\n      ppid,\n      command,\n      cwd: \"\",\n      tty: tty.startsWith(\"/dev/\") ? tty.slice(5) : tty,\n    });\n  }\n\n  return { allPids, matched };\n}\n\nasync function batchGetProcessCwdsAsync(\n  exec: ProcessExec,\n  pids: number[],\n): Promise<Map<number, string>> {\n  const result = new Map<number, string>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = await exec(\"lsof\", [\"-a\", \"-d\", \"cwd\", \"-Fn\", \"-p\", pids.join(\",\")]);\n    let currentPid: number | null = null;\n    for (const line of output.trim().split(\"\\n\")) {\n      if (line.startsWith(\"p\")) {\n        currentPid = parseInt(line.slice(1), 10);\n      } else if (line.startsWith(\"n\") && currentPid !== null) {\n        result.set(currentPid, line.slice(1));\n        currentPid = null;\n      }\n    }\n    return result;\n  } catch {\n    const entries = await Promise.all(\n      pids.map(async (pid) => {\n        try {\n          const output = await exec(\"pwdx\", [String(pid)]);\n          const match = output.match(/^\\d+:\\s*(.+)$/);\n          return match ? ([pid, match[1].trim()] as const) : null;\n        } catch {\n          return null;\n        }\n      }),\n    );\n    for (const entry of entries) {\n      if (entry) result.set(entry[0], entry[1]);\n    }\n    return result;\n  }\n}\n\nasync function batchGetProcessStartTimesAsync(\n  exec: ProcessExec,\n  pids: number[],\n): Promise<Map<number, Date>> {\n  const result = new Map<number, Date>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = await exec(\"ps\", [\"-o\", \"pid=,lstart=\", \"-p\", pids.join(\",\")]);\n    for (const rawLine of output.split(\"\\n\")) {\n      const match = rawLine.trim().match(/^(\\d+)\\s+(.+)$/);\n      if (!match) continue;\n      const pid = parseInt(match[1], 10);\n      const date = new Date(match[2].trim());\n      if (Number.isFinite(pid) && !Number.isNaN(date.getTime())) result.set(pid, date);\n    }\n  } catch {\n    // Return partial/empty data, matching the synchronous helper.\n  }\n  return result;\n}\n\ninterface CachedStartTime {\n  /** ppid + command seen when the start time was read; a mismatch means PID reuse. */\n  identity: string;\n  startTime: Date;\n}\n\nfunction processIdentity(process: ProcessInfo): string {\n  return `${process.ppid ?? \"\"}\\0${process.command}`;\n}\n\n/**\n * Create a snapshot capture function with its own start-time cache.\n *\n * Start times never change for a live process, so each PID is queried with\n * `ps lstart` once and reused on later refreshes. A cache entry is dropped\n * when its PID disappears from the base listing, and ignored when the PID's\n * ppid/command no longer match (PID reuse). cwd is re-read every refresh\n * because a process can change directory.\n */\nexport function createProcessSnapshotCapture(\n  deps: { exec?: ProcessExec } = {},\n): ProcessSnapshotCapture {\n  const exec = deps.exec ?? execFileText;\n  const startTimeCache = new Map<number, CachedStartTime>();\n\n  const cachedStartTime = (process: ProcessInfo): Date | undefined => {\n    const cached = startTimeCache.get(process.pid);\n    return cached?.identity === processIdentity(process) ? cached.startTime : undefined;\n  };\n\n  return async (namePatterns, options = {}) => {\n    const names = normalizedProcessNames(\n      namePatterns.filter((name) => Boolean(name) && VALID_EXECUTABLE_NAME.test(name)),\n    );\n    if (names.size === 0) return [];\n\n    try {\n      const output = await exec(\"ps\", [\"-axo\", \"pid=,ppid=,tty=,command=\"]);\n      const { allPids, matched } = parseProcessList(output, names);\n\n      for (const pid of startTimeCache.keys()) {\n        if (!allPids.has(pid)) startTimeCache.delete(pid);\n      }\n\n      const { isCandidate } = options;\n      const candidates = isCandidate ? matched.filter((process) => isCandidate(process)) : matched;\n      const candidatePids = candidates.map((process) => process.pid);\n      const uncachedPids = candidates\n        .filter((process) => cachedStartTime(process) === undefined)\n        .map((process) => process.pid);\n\n      const [cwdMap, startTimeMap] = await Promise.all([\n        batchGetProcessCwdsAsync(exec, candidatePids),\n        batchGetProcessStartTimesAsync(exec, uncachedPids),\n      ]);\n\n      for (const process of candidates) {\n        const startTime = startTimeMap.get(process.pid);\n        if (startTime) {\n          startTimeCache.set(process.pid, { identity: processIdentity(process), startTime });\n        }\n      }\n\n      const candidateSet = new Set(candidatePids);\n      return matched.map((process) =>\n        candidateSet.has(process.pid)\n          ? {\n              ...process,\n              cwd: cwdMap.get(process.pid) || \"\",\n              startTime: cachedStartTime(process),\n            }\n          : process,\n      );\n    } catch {\n      return [];\n    }\n  };\n}\n\n/**\n * Capture and enrich relevant processes without blocking the event loop.\n * One base process listing is shared by every requested executable name;\n * only processes accepted by `options.isCandidate` are enriched.\n */\nexport const captureProcessSnapshot: ProcessSnapshotCapture = createProcessSnapshotCapture();\n\n/**\n * Batch-get current working directories for multiple PIDs.\n *\n * Single `lsof -a -d cwd -Fn -p PID1,PID2,...` call.\n * Returns partial results — if lsof fails for one PID, others still return.\n */\nexport function batchGetProcessCwds(pids: number[]): Map<number, string> {\n  const result = new Map<number, string>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = execFileSync(\"lsof\", [\"-a\", \"-d\", \"cwd\", \"-Fn\", \"-p\", pids.join(\",\")], {\n      encoding: \"utf-8\",\n      stdio: [\"pipe\", \"pipe\", \"ignore\"],\n    });\n\n    // lsof output format: p{PID}\\nn{path}\\np{PID}\\nn{path}...\n    let currentPid: number | null = null;\n    for (const line of output.trim().split(\"\\n\")) {\n      if (line.startsWith(\"p\")) {\n        currentPid = parseInt(line.slice(1), 10);\n      } else if (line.startsWith(\"n\") && currentPid !== null) {\n        result.set(currentPid, line.slice(1));\n        currentPid = null;\n      }\n    }\n  } catch {\n    // Try per-PID fallback with pwdx (Linux)\n    for (const pid of pids) {\n      try {\n        const output = execFileSync(\"pwdx\", [String(pid)], {\n          encoding: \"utf-8\",\n          stdio: [\"pipe\", \"pipe\", \"ignore\"],\n        });\n        const match = output.match(/^\\d+:\\s*(.+)$/);\n        if (match) {\n          result.set(pid, match[1].trim());\n        }\n      } catch {\n        // Skip this PID\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Batch-get process start times for multiple PIDs.\n *\n * Single `ps -o pid=,lstart= -p PID1,PID2,...` call.\n * Uses lstart format which gives full timestamp (e.g., \"Thu Feb  5 16:00:57 2026\").\n * Returns partial results.\n */\nexport function batchGetProcessStartTimes(pids: number[]): Map<number, Date> {\n  const result = new Map<number, Date>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = execFileSync(\"ps\", [\"-o\", \"pid=,lstart=\", \"-p\", pids.join(\",\")], {\n      encoding: \"utf-8\",\n    });\n\n    for (const rawLine of output.split(\"\\n\")) {\n      const line = rawLine.trim();\n      if (!line) continue;\n\n      // Format: \"  PID  DAY MON DD HH:MM:SS YYYY\"\n      // e.g., \" 78070 Wed Mar 18 23:18:01 2026\"\n      const match = line.match(/^\\s*(\\d+)\\s+(.+)$/);\n      if (!match) continue;\n\n      const pid = parseInt(match[1], 10);\n      const dateStr = match[2].trim();\n\n      if (!Number.isFinite(pid)) continue;\n\n      const date = new Date(dateStr);\n      if (!Number.isNaN(date.getTime())) {\n        result.set(pid, date);\n      }\n    }\n  } catch {\n    // Return whatever we have\n  }\n\n  return result;\n}\n\n/**\n * Enrich ProcessInfo array with cwd and startTime.\n *\n * Calls batchGetProcessCwds and batchGetProcessStartTimes in batched shell calls,\n * then populates each ProcessInfo in-place. Returns partial results —\n * if a PID fails, that process keeps empty cwd / undefined startTime.\n */\nexport function enrichProcesses(processes: ProcessInfo[]): ProcessInfo[] {\n  if (processes.length === 0) return processes;\n\n  const pids = processes.map((p) => p.pid);\n  const cwdMap = batchGetProcessCwds(pids);\n  const startTimeMap = batchGetProcessStartTimes(pids);\n\n  for (const proc of processes) {\n    proc.cwd = cwdMap.get(proc.pid) || \"\";\n    proc.startTime = startTimeMap.get(proc.pid);\n  }\n\n  return processes;\n}\n\nfunction isSameTerminalProcess(proc: ProcessInfo, matched: ProcessInfo): boolean {\n  const sameTty = proc.tty !== \"\" && proc.tty !== \"?\" && proc.tty === matched.tty;\n  const sameCwd = proc.cwd !== \"\" && proc.cwd === matched.cwd;\n\n  return sameTty && (sameCwd || proc.cwd === \"\" || matched.cwd === \"\");\n}\n\nfunction matchesProcessIdentity(proc: ProcessInfo, matched: ProcessInfo): boolean {\n  return proc.pid === matched.pid || isSameTerminalProcess(proc, matched);\n}\n\nexport function findWrapperProcess(\n  processes: ProcessInfo[],\n  child: ProcessInfo,\n): ProcessInfo | undefined {\n  return processes.find(\n    (proc) =>\n      proc.pid !== child.pid && child.ppid === proc.pid && matchesProcessIdentity(proc, child),\n  );\n}\n\n/**\n * Find parent wrapper processes that should not be reported as separate agents.\n *\n * A process is considered a wrapper when it is the parent of another candidate\n * agent process in the same terminal/worktree, or when it points at the same\n * terminal/worktree as an already session-matched process.\n */\nexport function findWrapperProcessPids(\n  processes: ProcessInfo[],\n  matchedProcesses: ProcessInfo[] = [],\n): Set<number> {\n  const wrappers = new Set<number>();\n\n  for (const child of processes) {\n    const wrapper = findWrapperProcess(processes, child);\n    if (wrapper) {\n      wrappers.add(wrapper.pid);\n    }\n  }\n\n  for (const proc of processes) {\n    if (\n      matchedProcesses.some(\n        (matched) => proc.pid !== matched.pid && isSameTerminalProcess(proc, matched),\n      )\n    ) {\n      wrappers.add(proc.pid);\n    }\n  }\n\n  return wrappers;\n}\n\n/**\n * Get the TTY device for a specific process\n */\nexport function getProcessTty(pid: number): string {\n  try {\n    const output = execFileSync(\"ps\", [\"-p\", String(pid), \"-o\", \"tty=\"], { encoding: \"utf-8\" });\n\n    const tty = output.trim();\n    return tty.startsWith(\"/dev/\") ? tty.slice(5) : tty;\n  } catch {\n    return \"?\";\n  }\n}\n"],"names":["fs","path","execFile","execFileSync","PROCESS_EXEC_MAX_BUFFER","VALID_EXECUTABLE_NAME","ABSOLUTE_PATH","PATH_SEPARATOR","pathBasename","executable","basename","replace","toLowerCase","isFile","filePath","statSync","throwIfNoEntry","executablePath","command","parts","trim","split","first","length","test","prefix","i","executableBasename","normalizeExecutableName","name","lower","endsWith","slice","normalizedProcessNames","namePatterns","Set","filter","Boolean","map","matchesExecutableName","names","tokens","has","mayContinuePath","some","token","filterByProcessNames","processes","size","process","listAgentProcesses","namePattern","output","encoding","line","match","pid","parseInt","ppid","Number","isNaN","tty","ttyShort","startsWith","push","cwd","execFileText","file","args","Promise","resolve","reject","maxBuffer","error","stdout","parseProcessList","allPids","matched","add","batchGetProcessCwdsAsync","exec","pids","result","Map","join","currentPid","set","entries","all","String","entry","batchGetProcessStartTimesAsync","rawLine","date","Date","isFinite","getTime","processIdentity","createProcessSnapshotCapture","deps","startTimeCache","cachedStartTime","cached","get","identity","startTime","undefined","options","keys","delete","isCandidate","candidates","candidatePids","uncachedPids","cwdMap","startTimeMap","candidateSet","captureProcessSnapshot","batchGetProcessCwds","stdio","batchGetProcessStartTimes","dateStr","enrichProcesses","p","proc","isSameTerminalProcess","sameTty","sameCwd","matchesProcessIdentity","findWrapperProcess","child","find","findWrapperProcessPids","matchedProcesses","wrappers","wrapper","getProcessTty"],"mappings":"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"}
+{"version":3,"sources":["../../src/utils/process.ts"],"sourcesContent":["/**\n * Process Detection Utilities\n *\n * Shared shell command wrappers for detecting and inspecting running processes.\n * Built-in refresh discovery uses captureProcessSnapshot(); synchronous helpers\n * remain exported for compatibility with existing consumers.\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { execFile, execFileSync } from \"child_process\";\nimport type { ProcessInfo } from \"../adapters/AgentAdapter.js\";\n\nconst PROCESS_EXEC_MAX_BUFFER = 10 * 1024 * 1024;\nconst VALID_EXECUTABLE_NAME = /^[a-zA-Z0-9_-]+$/;\nconst ABSOLUTE_PATH = /^(?:\\/|[a-zA-Z]:[\\\\/])/;\nconst PATH_SEPARATOR = /[\\\\/]/;\n\nfunction pathBasename(executable: string): string {\n  return path.basename(executable.replace(/\\\\/g, \"/\")).toLowerCase();\n}\n\nfunction isFile(filePath: string): boolean {\n  try {\n    return fs.statSync(filePath, { throwIfNoEntry: false })?.isFile() ?? false;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolve argv[0] from a `ps` command line.\n *\n * `ps` joins argv with spaces, so an executable installed under a directory\n * containing spaces (`/Applications/Some App.app/Contents/Resources/codex`)\n * spans several whitespace tokens. When the first token of an absolute path\n * is not itself a file, longer space-joined prefixes ending in a token with a\n * path separator are tried, and the first one that exists on disk wins.\n * Otherwise the first token is returned, so arguments are never folded into\n * the executable path unless that combined path really is a file.\n */\nexport function executablePath(command: string): string {\n  const parts = command.trim().split(/(\\s+)/);\n  const first = parts[0] ?? \"\";\n  if (parts.length === 1 || !ABSOLUTE_PATH.test(first) || isFile(first)) return first;\n\n  let prefix = first;\n  for (let i = 2; i < parts.length; i += 2) {\n    prefix += parts[i - 1] + parts[i];\n    if (PATH_SEPARATOR.test(parts[i]) && isFile(prefix)) return prefix;\n  }\n  return first;\n}\n\nexport function executableBasename(command: string): string {\n  return pathBasename(executablePath(command));\n}\n\nfunction normalizeExecutableName(name: string): string {\n  const lower = name.toLowerCase();\n  return lower.endsWith(\".exe\") ? lower.slice(0, -4) : lower;\n}\n\nfunction normalizedProcessNames(namePatterns: readonly string[]): Set<string> {\n  return new Set(namePatterns.filter(Boolean).map(normalizeExecutableName));\n}\n\n/**\n * Whether argv[0] of `command` is one of `names`.\n *\n * The first token is checked with string operations only, as before. The\n * filesystem is consulted only for absolute commands where a later\n * path-like token ends in one of the names, i.e. a possible executable under\n * a directory containing spaces.\n */\nfunction matchesExecutableName(command: string, names: ReadonlySet<string>): boolean {\n  const tokens = command.trim().split(/\\s+/);\n  const first = tokens[0] ?? \"\";\n  if (names.has(normalizeExecutableName(pathBasename(first)))) return true;\n  if (!ABSOLUTE_PATH.test(first)) return false;\n\n  const mayContinuePath = tokens\n    .slice(1)\n    .some(\n      (token) =>\n        PATH_SEPARATOR.test(token) && names.has(normalizeExecutableName(pathBasename(token))),\n    );\n  return mayContinuePath && names.has(normalizeExecutableName(executableBasename(command)));\n}\n\nexport function filterByProcessNames(\n  processes: readonly ProcessInfo[],\n  namePatterns: readonly string[],\n): ProcessInfo[] {\n  const names = normalizedProcessNames(namePatterns);\n  if (names.size === 0) return [];\n  return processes.filter((process) => matchesExecutableName(process.command, names));\n}\n\n/**\n * List running processes matching an agent executable name.\n *\n * Uses `ps -axo` then filters in JS for exact executable basename match.\n * This avoids shell pipelines and string interpolation.\n *\n * Returned ProcessInfo has pid, ppid, command, tty populated.\n * cwd and startTime are NOT populated — call enrichProcesses() to fill them.\n */\nexport function listAgentProcesses(namePattern: string): ProcessInfo[] {\n  // Validate pattern contains only safe characters (alphanumeric, dash, underscore)\n  if (!namePattern || !VALID_EXECUTABLE_NAME.test(namePattern)) {\n    return [];\n  }\n\n  try {\n    const output = execFileSync(\"ps\", [\"-axo\", \"pid=,ppid=,tty=,command=\"], { encoding: \"utf-8\" });\n\n    const names = normalizedProcessNames([namePattern]);\n    const processes: ProcessInfo[] = [];\n\n    for (const line of output.trim().split(\"\\n\")) {\n      if (!line.trim()) continue;\n\n      const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n      if (!match) continue;\n\n      const pid = parseInt(match[1], 10);\n      const ppid = parseInt(match[2], 10);\n      if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n\n      const tty = match[3];\n      const command = match[4];\n\n      if (!matchesExecutableName(command, names)) continue;\n\n      const ttyShort = tty.startsWith(\"/dev/\") ? tty.slice(5) : tty;\n\n      processes.push({\n        pid,\n        ppid,\n        command,\n        cwd: \"\",\n        tty: ttyShort,\n      });\n    }\n\n    return processes;\n  } catch {\n    return [];\n  }\n}\n\n/** Runs an executable and resolves with its stdout. Injectable for tests. */\nexport type ProcessExec = (file: string, args: readonly string[]) => Promise<string>;\n\nexport interface ProcessSnapshotOptions {\n  /**\n   * Decides which name-matched processes are worth enriching with cwd and\n   * start time. Non-candidates are still returned (pid, ppid, tty, command\n   * only) so adapters can walk parent chains. Omitted = enrich everything.\n   */\n  isCandidate?: (process: ProcessInfo) => boolean;\n}\n\nexport type ProcessSnapshotCapture = (\n  namePatterns: readonly string[],\n  options?: ProcessSnapshotOptions,\n) => Promise<ProcessInfo[]>;\n\nconst execFileText: ProcessExec = (file, args) =>\n  new Promise((resolve, reject) => {\n    execFile(\n      file,\n      args,\n      { encoding: \"utf-8\", maxBuffer: PROCESS_EXEC_MAX_BUFFER },\n      (error, stdout) => {\n        if (error) {\n          reject(error);\n          return;\n        }\n        resolve(stdout);\n      },\n    );\n  });\n\ninterface ParsedProcessList {\n  /** Every PID in the listing, used to evict cache entries for exited processes. */\n  allPids: Set<number>;\n  /** Processes whose executable matches one of the requested names. */\n  matched: ProcessInfo[];\n}\n\nfunction parseProcessList(output: string, namePatterns: ReadonlySet<string>): ParsedProcessList {\n  const allPids = new Set<number>();\n  const matched: ProcessInfo[] = [];\n\n  for (const line of output.trim().split(\"\\n\")) {\n    if (!line.trim()) continue;\n\n    const match = line.match(/^\\s*(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n    if (!match) continue;\n\n    const pid = parseInt(match[1], 10);\n    const ppid = parseInt(match[2], 10);\n    if (Number.isNaN(pid) || Number.isNaN(ppid)) continue;\n    allPids.add(pid);\n\n    const tty = match[3];\n    const command = match[4];\n    if (!matchesExecutableName(command, namePatterns)) continue;\n\n    matched.push({\n      pid,\n      ppid,\n      command,\n      cwd: \"\",\n      tty: tty.startsWith(\"/dev/\") ? tty.slice(5) : tty,\n    });\n  }\n\n  return { allPids, matched };\n}\n\n/** Working directories of `pids` (async `lsof`); PIDs it cannot read are omitted. */\nexport function getProcessCwdsAsync(pids: number[]): Promise<Map<number, string>> {\n  return batchGetProcessCwdsAsync(execFileText, pids);\n}\n\nasync function batchGetProcessCwdsAsync(\n  exec: ProcessExec,\n  pids: number[],\n): Promise<Map<number, string>> {\n  const result = new Map<number, string>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = await exec(\"lsof\", [\"-a\", \"-d\", \"cwd\", \"-Fn\", \"-p\", pids.join(\",\")]);\n    let currentPid: number | null = null;\n    for (const line of output.trim().split(\"\\n\")) {\n      if (line.startsWith(\"p\")) {\n        currentPid = parseInt(line.slice(1), 10);\n      } else if (line.startsWith(\"n\") && currentPid !== null) {\n        result.set(currentPid, line.slice(1));\n        currentPid = null;\n      }\n    }\n    return result;\n  } catch {\n    const entries = await Promise.all(\n      pids.map(async (pid) => {\n        try {\n          const output = await exec(\"pwdx\", [String(pid)]);\n          const match = output.match(/^\\d+:\\s*(.+)$/);\n          return match ? ([pid, match[1].trim()] as const) : null;\n        } catch {\n          return null;\n        }\n      }),\n    );\n    for (const entry of entries) {\n      if (entry) result.set(entry[0], entry[1]);\n    }\n    return result;\n  }\n}\n\nasync function batchGetProcessStartTimesAsync(\n  exec: ProcessExec,\n  pids: number[],\n): Promise<Map<number, Date>> {\n  const result = new Map<number, Date>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = await exec(\"ps\", [\"-o\", \"pid=,lstart=\", \"-p\", pids.join(\",\")]);\n    for (const rawLine of output.split(\"\\n\")) {\n      const match = rawLine.trim().match(/^(\\d+)\\s+(.+)$/);\n      if (!match) continue;\n      const pid = parseInt(match[1], 10);\n      const date = new Date(match[2].trim());\n      if (Number.isFinite(pid) && !Number.isNaN(date.getTime())) result.set(pid, date);\n    }\n  } catch {\n    // Return partial/empty data, matching the synchronous helper.\n  }\n  return result;\n}\n\ninterface CachedStartTime {\n  /** ppid + command seen when the start time was read; a mismatch means PID reuse. */\n  identity: string;\n  startTime: Date;\n}\n\nfunction processIdentity(process: ProcessInfo): string {\n  return `${process.ppid ?? \"\"}\\0${process.command}`;\n}\n\n/**\n * Create a snapshot capture function with its own start-time cache.\n *\n * Start times never change for a live process, so each PID is queried with\n * `ps lstart` once and reused on later refreshes. A cache entry is dropped\n * when its PID disappears from the base listing, and ignored when the PID's\n * ppid/command no longer match (PID reuse). cwd is re-read every refresh\n * because a process can change directory.\n */\nexport function createProcessSnapshotCapture(\n  deps: { exec?: ProcessExec } = {},\n): ProcessSnapshotCapture {\n  const exec = deps.exec ?? execFileText;\n  const startTimeCache = new Map<number, CachedStartTime>();\n\n  const cachedStartTime = (process: ProcessInfo): Date | undefined => {\n    const cached = startTimeCache.get(process.pid);\n    return cached?.identity === processIdentity(process) ? cached.startTime : undefined;\n  };\n\n  return async (namePatterns, options = {}) => {\n    const names = normalizedProcessNames(\n      namePatterns.filter((name) => Boolean(name) && VALID_EXECUTABLE_NAME.test(name)),\n    );\n    if (names.size === 0) return [];\n\n    try {\n      const output = await exec(\"ps\", [\"-axo\", \"pid=,ppid=,tty=,command=\"]);\n      const { allPids, matched } = parseProcessList(output, names);\n\n      for (const pid of startTimeCache.keys()) {\n        if (!allPids.has(pid)) startTimeCache.delete(pid);\n      }\n\n      const { isCandidate } = options;\n      const candidates = isCandidate ? matched.filter((process) => isCandidate(process)) : matched;\n      const candidatePids = candidates.map((process) => process.pid);\n      const uncachedPids = candidates\n        .filter((process) => cachedStartTime(process) === undefined)\n        .map((process) => process.pid);\n\n      const [cwdMap, startTimeMap] = await Promise.all([\n        batchGetProcessCwdsAsync(exec, candidatePids),\n        batchGetProcessStartTimesAsync(exec, uncachedPids),\n      ]);\n\n      for (const process of candidates) {\n        const startTime = startTimeMap.get(process.pid);\n        if (startTime) {\n          startTimeCache.set(process.pid, { identity: processIdentity(process), startTime });\n        }\n      }\n\n      const candidateSet = new Set(candidatePids);\n      return matched.map((process) =>\n        candidateSet.has(process.pid)\n          ? {\n              ...process,\n              cwd: cwdMap.get(process.pid) || \"\",\n              startTime: cachedStartTime(process),\n            }\n          : process,\n      );\n    } catch {\n      return [];\n    }\n  };\n}\n\n/**\n * Capture and enrich relevant processes without blocking the event loop.\n * One base process listing is shared by every requested executable name;\n * only processes accepted by `options.isCandidate` are enriched.\n */\nexport const captureProcessSnapshot: ProcessSnapshotCapture = createProcessSnapshotCapture();\n\n/**\n * Batch-get current working directories for multiple PIDs.\n *\n * Single `lsof -a -d cwd -Fn -p PID1,PID2,...` call.\n * Returns partial results — if lsof fails for one PID, others still return.\n */\nexport function batchGetProcessCwds(pids: number[]): Map<number, string> {\n  const result = new Map<number, string>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = execFileSync(\"lsof\", [\"-a\", \"-d\", \"cwd\", \"-Fn\", \"-p\", pids.join(\",\")], {\n      encoding: \"utf-8\",\n      stdio: [\"pipe\", \"pipe\", \"ignore\"],\n    });\n\n    // lsof output format: p{PID}\\nn{path}\\np{PID}\\nn{path}...\n    let currentPid: number | null = null;\n    for (const line of output.trim().split(\"\\n\")) {\n      if (line.startsWith(\"p\")) {\n        currentPid = parseInt(line.slice(1), 10);\n      } else if (line.startsWith(\"n\") && currentPid !== null) {\n        result.set(currentPid, line.slice(1));\n        currentPid = null;\n      }\n    }\n  } catch {\n    // Try per-PID fallback with pwdx (Linux)\n    for (const pid of pids) {\n      try {\n        const output = execFileSync(\"pwdx\", [String(pid)], {\n          encoding: \"utf-8\",\n          stdio: [\"pipe\", \"pipe\", \"ignore\"],\n        });\n        const match = output.match(/^\\d+:\\s*(.+)$/);\n        if (match) {\n          result.set(pid, match[1].trim());\n        }\n      } catch {\n        // Skip this PID\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Batch-get process start times for multiple PIDs.\n *\n * Single `ps -o pid=,lstart= -p PID1,PID2,...` call.\n * Uses lstart format which gives full timestamp (e.g., \"Thu Feb  5 16:00:57 2026\").\n * Returns partial results.\n */\nexport function batchGetProcessStartTimes(pids: number[]): Map<number, Date> {\n  const result = new Map<number, Date>();\n  if (pids.length === 0) return result;\n\n  try {\n    const output = execFileSync(\"ps\", [\"-o\", \"pid=,lstart=\", \"-p\", pids.join(\",\")], {\n      encoding: \"utf-8\",\n    });\n\n    for (const rawLine of output.split(\"\\n\")) {\n      const line = rawLine.trim();\n      if (!line) continue;\n\n      // Format: \"  PID  DAY MON DD HH:MM:SS YYYY\"\n      // e.g., \" 78070 Wed Mar 18 23:18:01 2026\"\n      const match = line.match(/^\\s*(\\d+)\\s+(.+)$/);\n      if (!match) continue;\n\n      const pid = parseInt(match[1], 10);\n      const dateStr = match[2].trim();\n\n      if (!Number.isFinite(pid)) continue;\n\n      const date = new Date(dateStr);\n      if (!Number.isNaN(date.getTime())) {\n        result.set(pid, date);\n      }\n    }\n  } catch {\n    // Return whatever we have\n  }\n\n  return result;\n}\n\n/**\n * Enrich ProcessInfo array with cwd and startTime.\n *\n * Calls batchGetProcessCwds and batchGetProcessStartTimes in batched shell calls,\n * then populates each ProcessInfo in-place. Returns partial results —\n * if a PID fails, that process keeps empty cwd / undefined startTime.\n */\nexport function enrichProcesses(processes: ProcessInfo[]): ProcessInfo[] {\n  if (processes.length === 0) return processes;\n\n  const pids = processes.map((p) => p.pid);\n  const cwdMap = batchGetProcessCwds(pids);\n  const startTimeMap = batchGetProcessStartTimes(pids);\n\n  for (const proc of processes) {\n    proc.cwd = cwdMap.get(proc.pid) || \"\";\n    proc.startTime = startTimeMap.get(proc.pid);\n  }\n\n  return processes;\n}\n\nfunction isSameTerminalProcess(proc: ProcessInfo, matched: ProcessInfo): boolean {\n  const sameTty = proc.tty !== \"\" && proc.tty !== \"?\" && proc.tty === matched.tty;\n  const sameCwd = proc.cwd !== \"\" && proc.cwd === matched.cwd;\n\n  return sameTty && (sameCwd || proc.cwd === \"\" || matched.cwd === \"\");\n}\n\nfunction matchesProcessIdentity(proc: ProcessInfo, matched: ProcessInfo): boolean {\n  return proc.pid === matched.pid || isSameTerminalProcess(proc, matched);\n}\n\nexport function findWrapperProcess(\n  processes: ProcessInfo[],\n  child: ProcessInfo,\n): ProcessInfo | undefined {\n  return processes.find(\n    (proc) =>\n      proc.pid !== child.pid && child.ppid === proc.pid && matchesProcessIdentity(proc, child),\n  );\n}\n\n/**\n * Find parent wrapper processes that should not be reported as separate agents.\n *\n * A process is considered a wrapper when it is the parent of another candidate\n * agent process in the same terminal/worktree, or when it points at the same\n * terminal/worktree as an already session-matched process.\n */\nexport function findWrapperProcessPids(\n  processes: ProcessInfo[],\n  matchedProcesses: ProcessInfo[] = [],\n): Set<number> {\n  const wrappers = new Set<number>();\n\n  for (const child of processes) {\n    const wrapper = findWrapperProcess(processes, child);\n    if (wrapper) {\n      wrappers.add(wrapper.pid);\n    }\n  }\n\n  for (const proc of processes) {\n    if (\n      matchedProcesses.some(\n        (matched) => proc.pid !== matched.pid && isSameTerminalProcess(proc, matched),\n      )\n    ) {\n      wrappers.add(proc.pid);\n    }\n  }\n\n  return wrappers;\n}\n\n/**\n * Get the TTY device for a specific process\n */\nexport function getProcessTty(pid: number): string {\n  try {\n    const output = execFileSync(\"ps\", [\"-p\", String(pid), \"-o\", \"tty=\"], { encoding: \"utf-8\" });\n\n    const tty = output.trim();\n    return tty.startsWith(\"/dev/\") ? tty.slice(5) : tty;\n  } catch {\n    return \"?\";\n  }\n}\n"],"names":["fs","path","execFile","execFileSync","PROCESS_EXEC_MAX_BUFFER","VALID_EXECUTABLE_NAME","ABSOLUTE_PATH","PATH_SEPARATOR","pathBasename","executable","basename","replace","toLowerCase","isFile","filePath","statSync","throwIfNoEntry","executablePath","command","parts","trim","split","first","length","test","prefix","i","executableBasename","normalizeExecutableName","name","lower","endsWith","slice","normalizedProcessNames","namePatterns","Set","filter","Boolean","map","matchesExecutableName","names","tokens","has","mayContinuePath","some","token","filterByProcessNames","processes","size","process","listAgentProcesses","namePattern","output","encoding","line","match","pid","parseInt","ppid","Number","isNaN","tty","ttyShort","startsWith","push","cwd","execFileText","file","args","Promise","resolve","reject","maxBuffer","error","stdout","parseProcessList","allPids","matched","add","getProcessCwdsAsync","pids","batchGetProcessCwdsAsync","exec","result","Map","join","currentPid","set","entries","all","String","entry","batchGetProcessStartTimesAsync","rawLine","date","Date","isFinite","getTime","processIdentity","createProcessSnapshotCapture","deps","startTimeCache","cachedStartTime","cached","get","identity","startTime","undefined","options","keys","delete","isCandidate","candidates","candidatePids","uncachedPids","cwdMap","startTimeMap","candidateSet","captureProcessSnapshot","batchGetProcessCwds","stdio","batchGetProcessStartTimes","dateStr","enrichProcesses","p","proc","isSameTerminalProcess","sameTty","sameCwd","matchesProcessIdentity","findWrapperProcess","child","find","findWrapperProcessPids","matchedProcesses","wrappers","wrapper","getProcessTty"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-devkit/agent-manager",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "Standalone agent detection and management utilities for AI DevKit",
   "keywords": [
     "agent",

package/src/__tests__/capacity/devin.test.ts

@@ -0,0 +1,210 @@
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it, vi } from "vitest";
+import { parseDevinCapacity } from "../../capacity/providers/devin.js";
+import { probeDevinCapacity } from "../../capacity/sources/devin.js";
+import { resolveDevinCredential } from "../../harnesses/devin/credentials.js";
+
+const checkedAt = "2026-10-05T10:00:00.000Z";
+const fixture = (name: string) =>
+  readFile(fileURLToPath(new URL(`./fixtures/${name}`, import.meta.url)), "utf8");
+
+const credentialFiles = async (path: string): Promise<string> => {
+  if (path === "/users/test/.local/share/devin/credentials.toml") {
+    return fixture("devin-credentials.toml");
+  }
+  if (path === "/users/test/.config/devin/config.json") {
+    return fixture("devin-config.json");
+  }
+  throw Object.assign(new Error("missing"), { code: "ENOENT" });
+};
+
+describe("devin credential resolution", () => {
+  it("prefers DEVIN_API_KEY and DEVIN_ORG_ID without reading files", async () => {
+    const reader = vi.fn(credentialFiles);
+    await expect(
+      resolveDevinCredential({
+        env: { DEVIN_API_KEY: "env-key", DEVIN_ORG_ID: "org-env" },
+        readFile: reader,
+      }),
+    ).resolves.toEqual({ key: "env-key", orgId: "org-env" });
+    expect(reader).not.toHaveBeenCalled();
+  });
+
+  it("reads the key from credentials.toml and org from config.json", async () => {
+    const reader = vi.fn(credentialFiles);
+    await expect(
+      resolveDevinCredential({ env: { HOME: "/users/test" }, readFile: reader }),
+    ).resolves.toEqual({ key: "devin-test-key", orgId: "org-test1234" });
+    expect(reader).toHaveBeenCalledWith("/users/test/.local/share/devin/credentials.toml", "utf8");
+    expect(reader).toHaveBeenCalledWith("/users/test/.config/devin/config.json", "utf8");
+  });
+
+  it.each([
+    [
+      "missing credentials file",
+      async (path: string) => {
+        if (path.endsWith("config.json")) return fixture("devin-config.json");
+        throw Object.assign(new Error("missing"), { code: "ENOENT" });
+      },
+      /Devin API key not found/,
+    ],
+    [
+      "malformed credentials file",
+      async (path: string) => {
+        if (path.endsWith("credentials.toml")) return "not = [valid";
+        return fixture("devin-config.json");
+      },
+      /credentials file is malformed/,
+    ],
+    [
+      "credentials without key",
+      async (path: string) => {
+        if (path.endsWith("credentials.toml")) return 'api_server_url = "https://x"';
+        return fixture("devin-config.json");
+      },
+      /Devin API key not found/,
+    ],
+    [
+      "missing config file",
+      async (path: string) => {
+        if (path.endsWith("credentials.toml")) return fixture("devin-credentials.toml");
+        throw Object.assign(new Error("missing"), { code: "ENOENT" });
+      },
+      /Devin organization id not found/,
+    ],
+    [
+      "config without org_id",
+      async (path: string) => {
+        if (path.endsWith("credentials.toml")) return fixture("devin-credentials.toml");
+        return JSON.stringify({ devin: {} });
+      },
+      /Devin organization id not found/,
+    ],
+  ])("fails clearly for %s without exposing file content", async (_name, readFileImpl, pattern) => {
+    await expect(
+      resolveDevinCredential({ env: { HOME: "/users/test" }, readFile: readFileImpl }),
+    ).rejects.toThrow(pattern);
+  });
+});
+
+describe("devin quota mapping", () => {
+  it("maps daily and weekly windows with credits", async () => {
+    const report = parseDevinCapacity(JSON.parse(await fixture("devin-quota.json")));
+    expect(report).toMatchObject({
+      authenticated: true,
+      available: "yes",
+      creditsRemaining: 12.5,
+    });
+    expect(report.windows).toEqual([
+      {
+        id: "devin:daily",
+        label: "Daily",
+        durationMinutes: 1440,
+        usedPercent: 25,
+        resetsAt: "2026-10-06T08:00:00.000Z",
+      },
+      {
+        id: "devin:weekly",
+        label: "Weekly",
+        durationMinutes: 10080,
+        usedPercent: 60,
+        resetsAt: "2026-10-11T08:00:00.000Z",
+      },
+    ]);
+  });
+
+  it("omits the daily window when hide_daily_quota is true", () => {
+    const report = parseDevinCapacity({
+      is_quota_plan: true,
+      has_quota_allocation: true,
+      daily_percentage: 90,
+      weekly_percentage: 10,
+      hide_daily_quota: true,
+    });
+    expect(report.windows.map((window) => window.id)).toEqual(["devin:weekly"]);
+  });
+
+  it("reports authenticated unknown availability for non-quota plans", async () => {
+    const report = parseDevinCapacity(JSON.parse(await fixture("devin-quota-nonplan.json")));
+    expect(report).toEqual({
+      authenticated: true,
+      available: "unknown",
+      windows: [],
+      creditsRemaining: null,
+    });
+  });
+
+  it("clamps percentages and degrades missing fields honestly", () => {
+    const report = parseDevinCapacity({
+      is_quota_plan: true,
+      has_quota_allocation: true,
+      daily_percentage: 140,
+      weekly_reset_at: "not-a-date",
+      overage_balance: "unknown",
+    });
+    const [daily, weekly] = report.windows;
+    expect(daily.usedPercent).toBe(100);
+    expect(weekly.usedPercent).toBeNull();
+    expect(weekly.resetsAt).toBeNull();
+    expect(report.creditsRemaining).toBeNull();
+    expect(report.available).toBe("no");
+  });
+
+  it("rejects non-object responses", () => {
+    expect(() => parseDevinCapacity("nope")).toThrow(/Devin quota/);
+    expect(() => parseDevinCapacity(null)).toThrow(/Devin quota/);
+  });
+});
+
+describe("devin request", () => {
+  it("GETs the org quota endpoint with only Bearer authentication", async () => {
+    const body = await fixture("devin-quota.json");
+    const fetch = vi.fn(async () => new Response(body, { status: 200 }));
+    const report = await probeDevinCapacity({
+      checkedAt,
+      env: { DEVIN_API_KEY: "request-test-key", DEVIN_ORG_ID: "org-abc" },
+      fetch,
+    });
+    expect(fetch).toHaveBeenCalledWith(
+      "https://app.devin.ai/api/org-abc/billing/quota/usage",
+      expect.objectContaining({
+        method: "GET",
+        headers: { Authorization: "Bearer request-test-key" },
+      }),
+    );
+    expect(report.harness).toBe("devin");
+    expect(report.provider).toBe("devin");
+    expect(JSON.stringify(report)).not.toContain("request-test-key");
+  });
+
+  it.each([401, 403])("reports HTTP %i as unauthenticated", async (status) => {
+    const report = await probeDevinCapacity({
+      checkedAt,
+      env: { DEVIN_API_KEY: "request-test-key", DEVIN_ORG_ID: "org-abc" },
+      fetch: vi.fn(async () => new Response("denied", { status })),
+    });
+    expect(report).toMatchObject({
+      authenticated: false,
+      available: "unknown",
+      windows: [],
+    });
+  });
+
+  it("rejects other non-200 and malformed JSON responses with sanitized errors", async () => {
+    await expect(
+      probeDevinCapacity({
+        checkedAt,
+        env: { DEVIN_API_KEY: "never-expose-this-key", DEVIN_ORG_ID: "org-abc" },
+        fetch: vi.fn(async () => new Response("private body", { status: 503 })),
+      }),
+    ).rejects.toThrow("Devin quota request failed: HTTP 503");
+    await expect(
+      probeDevinCapacity({
+        checkedAt,
+        env: { DEVIN_API_KEY: "never-expose-this-key", DEVIN_ORG_ID: "org-abc" },
+        fetch: vi.fn(async () => new Response("not-json", { status: 200 })),
+      }),
+    ).rejects.toThrow("Devin quota response is not valid JSON");
+  });
+});

package/src/__tests__/capacity/fixtures/devin-config.json

@@ -0,0 +1,6 @@
+{
+  "version": 1,
+  "devin": {
+    "org_id": "org-test1234"
+  }
+}

package/src/__tests__/capacity/fixtures/devin-credentials.toml

@@ -0,0 +1,4 @@
+windsurf_api_key = "devin-test-key"
+api_server_url = "https://server.codeium.com"
+devin_webapp_host = "app.devin.ai"
+devin_api_url = "https://api.devin.ai"

package/src/__tests__/capacity/fixtures/devin-quota-nonplan.json

@@ -0,0 +1,5 @@
+{
+  "is_quota_plan": false,
+  "has_quota_allocation": false,
+  "overage_balance": 0.0
+}

package/src/__tests__/capacity/fixtures/devin-quota.json

@@ -0,0 +1,10 @@
+{
+  "is_quota_plan": true,
+  "has_quota_allocation": true,
+  "daily_percentage": 25,
+  "weekly_percentage": 60,
+  "daily_reset_at": "2026-10-06T00:00:00-08:00",
+  "weekly_reset_at": "2026-10-11T00:00:00-08:00",
+  "overage_balance": 12.5,
+  "hide_daily_quota": false
+}