chore: add pydantic model for VisualValidationMetadata

Author: philipph-askui

src/askui/models/shared/settings.py

@@ -179,6 +179,12 @@ class CacheFailure(BaseModel):
     failure_count_at_step: int
 
 
+class VisualValidationMetadata(BaseModel):
+    enabled: bool
+    method: CACHING_VISUAL_VERIFICATION_METHOD
+    region_size: int
+
+
 class CacheMetadata(BaseModel):
     """Metadata for a cache file including execution history and validation state.
 
@@ -204,7 +210,7 @@ class CacheMetadata(BaseModel):
     failures: list[CacheFailure] = Field(default_factory=list)
     is_valid: bool = True
     invalidation_reason: str | None = None
-    visual_validation: dict[str, Any] | None = None
+    visual_validation: VisualValidationMetadata | None = None
 
 
 class CacheFile(BaseModel):

src/askui/speaker/cache_executor.py

@@ -431,14 +431,10 @@ def _activate_from_context(
         if self._skip_visual_validation:
             self._visual_validation_enabled = False
             logger.info("Visual validation disabled by execution settings")
-        elif visual_validation_config and visual_validation_config.get("enabled"):
+        elif visual_validation_config and visual_validation_config.enabled:
             self._visual_validation_enabled = True
-            self._visual_validation_method = visual_validation_config.get(
-                "method", "phash"
-            )
-            self._visual_validation_region_size = visual_validation_config.get(
-                "region_size", 100
-            )
+            self._visual_validation_method = visual_validation_config.method
+            self._visual_validation_region_size = visual_validation_config.region_size
             logger.info(
                 "Visual validation enabled (method=%s, threshold=%d)",
                 self._visual_validation_method,

src/askui/utils/caching/cache_manager.py

@@ -18,6 +18,7 @@
     CacheFile,
     CacheMetadata,
     CacheWritingSettings,
+    VisualValidationMetadata,
 )
 from askui.models.shared.tools import ToolCollection
 from askui.utils.caching.cache_parameter_handler import CacheParameterHandler
@@ -634,15 +635,13 @@ def _generate_cache_file(
             cache_file_path: Path to write cache file
         """
         # Prepare visual validation metadata
-        visual_validation_metadata: dict[str, Any] | None = None
+        visual_validation_metadata: VisualValidationMetadata | None = None
         if self._cache_writer_settings.visual_verification_method != "none":
-            visual_validation_metadata = {
-                "enabled": True,
-                "method": self._cache_writer_settings.visual_verification_method,
-                "region_size": (
-                    self._cache_writer_settings.visual_validation_region_size
-                ),
-            }
+            visual_validation_metadata = VisualValidationMetadata(
+                enabled=True,
+                method=self._cache_writer_settings.visual_verification_method,
+                region_size=self._cache_writer_settings.visual_validation_region_size,
+            )
 
         cache_file = CacheFile(
             metadata=CacheMetadata(