Function createSandboxUsageEvent

services/cloud-agent-next/src/workspace.ts:678–692

(
  executor: CommandExecutor,
  sessionId?: string
)

/**
 * Check available disk space and total disk space for the container.
 * Uses `df` command on the root filesystem which is available in the sandbox environment.
 * Always checks `/` since all paths in the container share the same filesystem.
 *
 * @param session - Execution session to run the check
 * @returns Structured disk space result
 * @throws Error if disk check fails (command error, parse error, or exception)
 */
export async function checkDiskSpace(executor: CommandExecutor): Promise<DiskSpaceResult> {
  // df -B1 gives output in bytes for clean numeric parsing (no M/G/K suffixes)
  // --output=avail,size gives available and total space
  // Always use "/" since all container paths share the same root filesystem
  let result: ExecResult;
  try {
    result = await timedExec(
      executor,
      'df -B1 --output=avail,size / | tail -1',
      'workspace.checkDiskSpace',
      { timeoutMs: DISK_CHECK_TIMEOUT_MS }