feat: Integrate vendor VFIO vGPUs into the instance lifecycle

Stainless-Generated-From: 5c23aa338b3131721f25174807fe8ae9270f7851

Author: kernel-internal[bot]

src/hypeman/types/gpu_profile.py

@@ -9,7 +9,11 @@ class GPUProfile(BaseModel):
     """Available vGPU profile"""
 
     available: int
-    """Number of instances that can be created with this profile"""
+    """Number of virtual functions currently able to create this profile.
+
+    Best-effort: creating an instance may reduce availability on sibling functions
+    sharing GPU framebuffer.
+    """
 
     framebuffer_mb: int
     """Frame buffer size in MB"""

src/hypeman/types/instance.py

@@ -19,8 +19,11 @@
 class GPU(BaseModel):
     """GPU information attached to the instance"""
 
+    device_path: Optional[str] = None
+    """sysfs path of the assigned vGPU device"""
+
     mdev_uuid: Optional[str] = None
-    """mdev device UUID"""
+    """mdev device UUID (mdev hosts only)"""
 
     profile: Optional[str] = None
     """vGPU profile name"""