Volumes page: on-demand volume sizes (0.18.0)

Docker's volume list has no size, so add a "Compute sizes" button that runs
`docker system df` (via client.df()) and shows per-volume size in a new Size
column. The df walk is expensive (seconds), so results are cached ~60s and
loaded on demand instead of on every poll.

- volume_service.volume_sizes(force) with a 60s TTL cache; GET /api/volumes/sizes
  + agent /agent/volumes/sizes + proxy /api/agents/{id}/volumes/sizes.
- Frontend: volumesApi.sizes(force, agentId); Volumes page gained a Size column
  and a Compute sizes button (per host) that triggers the lookup.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

backend/agent_app.py

@@ -60,7 +60,7 @@ def _map_docker(exc: DockerError):
         raise HTTPException(status_code=code, detail=exc.detail or exc.error)
     raise exc  # falls through to the global 502 DockerError handler
 
-AGENT_VERSION = "0.17.0"
+AGENT_VERSION = "0.18.0"
 
 
 # --------------------------------------------------------------------------- #
@@ -447,6 +447,11 @@ def list_volumes() -> list[dict]:
     return volume_service.list_volumes()
 
 
+@app.get("/agent/volumes/sizes", dependencies=[Depends(verify_token)])
+def volume_sizes(force: bool = Query(False)) -> dict:
+    return volume_service.volume_sizes(force=force)
+
+
 @app.delete("/agent/volumes/{name}", dependencies=[Depends(verify_token)])
 def delete_volume(name: str, force: bool = Query(False)) -> dict:
     vols = {v["name"]: v for v in volume_service.list_volumes()}

backend/main.py

@@ -55,7 +55,7 @@ async def lifespan(app: FastAPI):
     schedule_task.cancel()
 
 
-app = FastAPI(title="StackPilot", version="0.17.0", lifespan=lifespan)
+app = FastAPI(title="StackPilot", version="0.18.0", lifespan=lifespan)
 
 app.add_middleware(
     CORSMiddleware,

backend/routers/agents.py

@@ -660,6 +660,19 @@ async def agent_volumes(
     return await _proxy(session, agent, "GET", "/agent/volumes") or []
 
 
+@router.get("/{agent_id}/volumes/sizes")
+async def agent_volume_sizes(
+    agent_id: int,
+    force: bool = Query(False),
+    session: Session = Depends(get_session),
+    _user: User = Depends(get_current_user),
+) -> dict:
+    agent = _get_or_404(session, agent_id)
+    return await _proxy(
+        session, agent, "GET", "/agent/volumes/sizes", params={"force": force}
+    )
+
+
 @router.post("/{agent_id}/volumes/prune")
 async def agent_volumes_prune(
     agent_id: int,

backend/routers/volumes.py

@@ -31,6 +31,15 @@ def orphaned(_user: User = Depends(get_current_user)) -> list[dict]:
     return volume_service.orphaned_volumes()
 
 
+@router.get("/api/volumes/sizes")
+def volume_sizes(
+    force: bool = Query(False),
+    _user: User = Depends(get_current_user),
+) -> dict:
+    """Volume sizes in bytes ({name: size|null}). Expensive; cached ~60s."""
+    return volume_service.volume_sizes(force=force)
+
+
 @router.delete("/api/volumes/{name}")
 def delete_volume(
     name: str,

backend/services/volume_service.py

@@ -1,6 +1,8 @@
 """Docker volume management + Compose volume YAML generation."""
 from __future__ import annotations
 
+import threading
+import time
 from typing import Literal, Optional
 
 import yaml
@@ -9,6 +11,33 @@ from docker_client import get_client, safe_call
 
 COMPOSE_PROJECT_LABEL = "com.docker.compose.project"
 
+# `docker system df -v` walks every volume's contents, so it can take many
+# seconds. Cache the result so the (polled) UI and repeated requests reuse it.
+_SIZE_TTL = 60.0
+_size_cache: dict = {"at": 0.0, "data": {}}
+_size_lock = threading.Lock()
+
+
+def volume_sizes(force: bool = False) -> dict:
+    """Return {volume_name: size_bytes|None}. Cached (~60s) since it's expensive."""
+    now = time.time()
+    with _size_lock:
+        if not force and _size_cache["data"] and now - _size_cache["at"] < _SIZE_TTL:
+            return _size_cache["data"]
+
+    client = get_client()
+    df = safe_call(client.df)
+    sizes: dict[str, Optional[int]] = {}
+    for v in df.get("Volumes") or []:
+        ud = v.get("UsageData") or {}
+        size = ud.get("Size")
+        sizes[v.get("Name")] = size if isinstance(size, int) and size >= 0 else None
+
+    with _size_lock:
+        _size_cache["at"] = time.time()
+        _size_cache["data"] = sizes
+    return sizes
+
 
 # --------------------------------------------------------------------------- #
 # Listing / pruning