Add sandboxes.delete_image for DELETE /images/:key (#112)

* Add sandboxes.delete_image for DELETE /images/:key

Expose sync and async image deletion so Python clients can remove team
Firecracker images by name or id against the new control-plane endpoint.

Co-authored-by: shri <shri@metlo.com>

* Accept deleted image revision fields on delete_image

Parse optional id, imageName, and uploaded from DELETE /images/:key
so callers can tell which revision was removed.

Co-authored-by: shri <shri@metlo.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Author: shrisukhani

hyperbrowser/client/managers/async_manager/sandbox.py

@@ -27,6 +27,7 @@
     SandboxNetworkPolicy,
     SandboxNetworkUpdateResult,
     SandboxRuntimeSession,
+    SandboxImageDeleteResult,
     SandboxSnapshotDeleteResult,
     SandboxSnapshotListParams,
     SandboxSnapshotListResponse,
@@ -427,6 +428,10 @@ async def list(
         )
         return SandboxListResponse(**payload)
 
+    async def delete_image(self, image: str) -> SandboxImageDeleteResult:
+        payload = await self._request("DELETE", f"/images/{image}")
+        return SandboxImageDeleteResult(**payload)
+
     async def list_images(
         self,
         params: Optional[

hyperbrowser/client/managers/sync_manager/sandbox.py

@@ -25,6 +25,7 @@
     SandboxNetworkPolicy,
     SandboxNetworkUpdateResult,
     SandboxRuntimeSession,
+    SandboxImageDeleteResult,
     SandboxSnapshotDeleteResult,
     SandboxSnapshotListParams,
     SandboxSnapshotListResponse,
@@ -419,6 +420,10 @@ def list(
         )
         return SandboxListResponse(**payload)
 
+    def delete_image(self, image: str) -> SandboxImageDeleteResult:
+        payload = self._request("DELETE", f"/images/{image}")
+        return SandboxImageDeleteResult(**payload)
+
     def list_images(
         self,
         params: Optional[

hyperbrowser/models/__init__.py

@@ -311,6 +311,7 @@
     SandboxImageSummary,
     SandboxSnapshotStatus,
     SandboxSnapshotDeleteResult,
+    SandboxImageDeleteResult,
     SandboxSnapshotListResponse,
     SandboxSnapshotSummary,
     SandboxSnapshotListParams,
@@ -610,6 +611,7 @@
     "SandboxImageSummary",
     "SandboxSnapshotStatus",
     "SandboxSnapshotDeleteResult",
+    "SandboxImageDeleteResult",
     "SandboxSnapshotListResponse",
     "SandboxSnapshotSummary",
     "SandboxSnapshotListParams",

hyperbrowser/models/sandbox.py

@@ -351,6 +351,13 @@ class SandboxSnapshotDeleteResult(SandboxBaseModel):
     deleted: bool
 
 
+class SandboxImageDeleteResult(SandboxBaseModel):
+    deleted: bool
+    id: Optional[str] = None
+    image_name: Optional[str] = Field(default=None, alias="imageName")
+    uploaded: Optional[bool] = None
+
+
 class SandboxMemorySnapshotParams(SandboxBaseModel):
     snapshot_name: Optional[str] = Field(
         default=None, serialization_alias="snapshotName"

tests/test_sandbox_wire_contract.py

@@ -443,6 +443,17 @@ def request(self, method, url, params=None, json=None):
             )
         elif "/images/builds/" in url:
             payload = IMAGE_BUILD_PAYLOAD
+        elif "/images/" in url:
+            payload = (
+                {
+                    "deleted": True,
+                    "id": "img_123",
+                    "imageName": "custom_node",
+                    "uploaded": True,
+                }
+                if method == "DELETE"
+                else IMAGE_LIST_PAYLOAD
+            )
         elif url.endswith("/images"):
             payload = IMAGE_LIST_PAYLOAD
         elif url.endswith("/snapshots"):
@@ -645,6 +656,17 @@ async def request(self, method, url, params=None, json=None):
             )
         elif "/images/builds/" in url:
             payload = IMAGE_BUILD_PAYLOAD
+        elif "/images/" in url:
+            payload = (
+                {
+                    "deleted": True,
+                    "id": "img_123",
+                    "imageName": "custom_node",
+                    "uploaded": True,
+                }
+                if method == "DELETE"
+                else IMAGE_LIST_PAYLOAD
+            )
         elif url.endswith("/images"):
             payload = IMAGE_LIST_PAYLOAD
         elif url.endswith("/snapshots"):
@@ -1004,8 +1026,9 @@ def test_sync_sandbox_snapshot_and_image_build_list_contract(use_legacy_model):
     builds = manager.list_image_builds(params)
     snapshot = manager.get_snapshot("snapshot-1")
     deleted = manager.delete_snapshot("snapshot-1")
+    deleted_image = manager.delete_image("custom_node")
 
-    list_call, get_call, delete_call = client.transport.client.calls
+    list_call, get_call, delete_call, delete_image_call = client.transport.client.calls
     assert list_call == {
         "method": "GET",
         "url": "https://api.example.com/images/builds",
@@ -1024,6 +1047,12 @@ def test_sync_sandbox_snapshot_and_image_build_list_contract(use_legacy_model):
     assert delete_call["method"] == "DELETE"
     assert delete_call["url"].endswith("/snapshots/snapshot-1")
     assert deleted.deleted is True
+    assert delete_image_call["method"] == "DELETE"
+    assert delete_image_call["url"].endswith("/images/custom_node")
+    assert deleted_image.deleted is True
+    assert deleted_image.id == "img_123"
+    assert deleted_image.image_name == "custom_node"
+    assert deleted_image.uploaded is True
 
 
 @pytest.mark.parametrize(
@@ -1637,8 +1666,9 @@ async def test_async_sandbox_snapshot_and_image_build_list_contract(
     builds = await manager.list_image_builds(params)
     snapshot = await manager.get_snapshot("snapshot-1")
     deleted = await manager.delete_snapshot("snapshot-1")
+    deleted_image = await manager.delete_image("custom_node")
 
-    list_call, get_call, delete_call = client.transport.client.calls
+    list_call, get_call, delete_call, delete_image_call = client.transport.client.calls
     assert list_call == {
         "method": "GET",
         "url": "https://api.example.com/images/builds",
@@ -1657,6 +1687,12 @@ async def test_async_sandbox_snapshot_and_image_build_list_contract(
     assert delete_call["method"] == "DELETE"
     assert delete_call["url"].endswith("/snapshots/snapshot-1")
     assert deleted.deleted is True
+    assert delete_image_call["method"] == "DELETE"
+    assert delete_image_call["url"].endswith("/images/custom_node")
+    assert deleted_image.deleted is True
+    assert deleted_image.id == "img_123"
+    assert deleted_image.image_name == "custom_node"
+    assert deleted_image.uploaded is True
 
 
 @pytest.mark.anyio