feat: add cleanup example image folders functionality and UI integration

py/routes/example_images_route_registrar.py

@@ -27,6 +27,7 @@ ROUTE_DEFINITIONS: tuple[RouteDefinition, ...] = (
     RouteDefinition("GET", "/api/lm/has-example-images", "has_example_images"),
     RouteDefinition("POST", "/api/lm/delete-example-image", "delete_example_image"),
     RouteDefinition("POST", "/api/lm/force-download-example-images", "force_download_example_images"),
+    RouteDefinition("POST", "/api/lm/cleanup-example-image-folders", "cleanup_example_image_folders"),
 )
 
 

py/routes/example_images_routes.py

@@ -22,6 +22,7 @@ from ..utils.example_images_download_manager import (
 )
 from ..utils.example_images_file_manager import ExampleImagesFileManager
 from ..utils.example_images_processor import ExampleImagesProcessor
+from ..services.example_images_cleanup_service import ExampleImagesCleanupService
 
 logger = logging.getLogger(__name__)
 
@@ -36,12 +37,14 @@ class ExampleImagesRoutes:
         download_manager: DownloadManager | None = None,
         processor=ExampleImagesProcessor,
         file_manager=ExampleImagesFileManager,
+        cleanup_service: ExampleImagesCleanupService | None = None,
     ) -> None:
         if ws_manager is None:
             raise ValueError("ws_manager is required")
         self._download_manager = download_manager or get_default_download_manager(ws_manager)
         self._processor = processor
         self._file_manager = file_manager
+        self._cleanup_service = cleanup_service or ExampleImagesCleanupService()
         self._handler_set: ExampleImagesHandlerSet | None = None
         self._handler_mapping: Mapping[str, Callable[[web.Request], web.StreamResponse]] | None = None
 
@@ -72,7 +75,11 @@ class ExampleImagesRoutes:
         download_use_case = DownloadExampleImagesUseCase(download_manager=self._download_manager)
         download_handler = ExampleImagesDownloadHandler(download_use_case, self._download_manager)
         import_use_case = ImportExampleImagesUseCase(processor=self._processor)
-        management_handler = ExampleImagesManagementHandler(import_use_case, self._processor)
+        management_handler = ExampleImagesManagementHandler(
+            import_use_case,
+            self._processor,
+            self._cleanup_service,
+        )
         file_handler = ExampleImagesFileHandler(self._file_manager)
         return ExampleImagesHandlerSet(
             download=download_handler,

py/routes/handlers/example_images_handlers.py

@@ -89,9 +89,10 @@ class ExampleImagesDownloadHandler:
 class ExampleImagesManagementHandler:
     """HTTP adapters for import/delete endpoints."""
 
-    def __init__(self, import_use_case: ImportExampleImagesUseCase, processor) -> None:
+    def __init__(self, import_use_case: ImportExampleImagesUseCase, processor, cleanup_service) -> None:
         self._import_use_case = import_use_case
         self._processor = processor
+        self._cleanup_service = cleanup_service
 
     async def import_example_images(self, request: web.Request) -> web.StreamResponse:
         try:
@@ -105,6 +106,16 @@ class ExampleImagesManagementHandler:
     async def delete_example_image(self, request: web.Request) -> web.StreamResponse:
         return await self._processor.delete_custom_image(request)
 
+    async def cleanup_example_image_folders(self, request: web.Request) -> web.StreamResponse:
+        result = await self._cleanup_service.cleanup_example_image_folders()
+
+        if result.get('success') or result.get('partial_success'):
+            return web.json_response(result, status=200)
+
+        error_code = result.get('error_code')
+        status = 400 if error_code in {'path_not_configured', 'path_not_found'} else 500
+        return web.json_response(result, status=status)
+
 
 class ExampleImagesFileHandler:
     """HTTP adapters for filesystem-centric endpoints."""
@@ -141,6 +152,7 @@ class ExampleImagesHandlerSet:
             "force_download_example_images": self.download.force_download_example_images,
             "import_example_images": self.management.import_example_images,
             "delete_example_image": self.management.delete_example_image,
+            "cleanup_example_image_folders": self.management.cleanup_example_image_folders,
             "open_example_images_folder": self.files.open_example_images_folder,
             "get_example_image_files": self.files.get_example_image_files,
             "has_example_images": self.files.has_example_images,