feat: add api and mcp

backend/src/api/routers/media.py

@@ -0,0 +1,38 @@
+import asyncpg
+from dishka.integrations.fastapi import DishkaRoute, FromDishka
+from fastapi import APIRouter, HTTPException
+from fastapi.responses import FileResponse
+
+from utils.read.media import get_media
+from utils.read.models import MediaView
+from utils.storage import ContentAddressedStorage
+
+router = APIRouter(prefix="/api/media", tags=["media"], route_class=DishkaRoute)
+
+
+@router.get("/{media_id}/meta")
+async def media_meta(pool: FromDishka[asyncpg.Pool], media_id: int) -> MediaView:
+    media = await get_media(pool, media_id)
+    if media is None:
+        raise HTTPException(status_code=404, detail="media not found")
+    return media
+
+
+@router.get("/{media_id}")
+async def serve_media(
+    pool: FromDishka[asyncpg.Pool],
+    storage: FromDishka[ContentAddressedStorage],
+    media_id: int,
+) -> FileResponse:
+    media = await get_media(pool, media_id)
+    if media is None:
+        raise HTTPException(status_code=404, detail="media not found")
+    if not media.downloaded or media.storage_key is None:
+        raise HTTPException(
+            status_code=409,
+            detail="media not downloaded; enqueue fetch via POST /api/media/fetch",
+        )
+    return FileResponse(
+        storage.url(media.storage_key),
+        media_type=media.mime or "application/octet-stream",
+    )