Struct ImageAuditLogger 

pub struct ImageAuditLogger { /* private fields */ }

Image analysis audit logger.

This logger tracks:

• Image analysis requests (provider, model, image count, size)
• Analysis responses (success/failure, tokens used)
• Cache operations (hits, misses, evictions)
• Security events (path traversal attempts, invalid formats)

Implementations

impl ImageAuditLogger

pub fn new(log_path: PathBuf) -> Self

Create a new image audit logger.

Arguments

• log_path - Path to the audit log file

pub fn log_analysis_request( &self, provider: &str, model: &str, image_count: usize, total_size: u64, image_hashes: Vec<String>, ) -> Result<(), Box<dyn Error>>

Log an image analysis request.

Arguments

• provider - Provider name (openai, anthropic, etc.)
• model - Model identifier
• image_count - Number of images being analyzed
• total_size - Total size of all images in bytes
• image_hashes - SHA256 hashes of images (for deduplication tracking)

pub fn log_analysis_success( &self, provider: &str, model: &str, image_count: usize, tokens_used: u32, image_hashes: Vec<String>, ) -> Result<(), Box<dyn Error>>

Log a successful image analysis response.

Arguments

• provider - Provider name
• model - Model identifier
• image_count - Number of images analyzed
• tokens_used - Tokens used for the analysis
• image_hashes - SHA256 hashes of analyzed images

pub fn log_analysis_failure( &self, provider: &str, model: &str, image_count: usize, error: &str, image_hashes: Vec<String>, ) -> Result<(), Box<dyn Error>>

Log a failed image analysis response.

Arguments

• provider - Provider name
• model - Model identifier
• image_count - Number of images that failed
• error - Error message
• image_hashes - SHA256 hashes of images that failed

pub fn log_cache_hit( &self, image_hash: &str, provider: &str, age_seconds: u64, ) -> Result<(), Box<dyn Error>>

Log a cache hit.

Arguments

• image_hash - SHA256 hash of the image
• provider - Provider that originally analyzed the image
• age_seconds - Age of the cached result in seconds

pub fn log_cache_miss(&self, image_hash: &str) -> Result<(), Box<dyn Error>>

Log a cache miss.

Arguments

• image_hash - SHA256 hash of the image

pub fn log_cache_eviction( &self, image_hash: &str, reason: &str, ) -> Result<(), Box<dyn Error>>

Log a cache eviction.

Arguments

• image_hash - SHA256 hash of the evicted image
• reason - Reason for eviction (e.g., “LRU”, “TTL_expired”)

pub fn log_invalid_format( &self, file_path: &str, format: &str, ) -> Result<(), Box<dyn Error>>

Log an invalid image format attempt.

Arguments

• file_path - Path to the file
• format - Format that was attempted

pub fn log_file_size_violation( &self, file_path: &str, size_bytes: u64, max_size_bytes: u64, ) -> Result<(), Box<dyn Error>>

Log a file size violation.

Arguments

• file_path - Path to the file
• size_bytes - Size of the file in bytes
• max_size_bytes - Maximum allowed size in bytes

pub fn log_path_traversal_attempt( &self, attempted_path: &str, ) -> Result<(), Box<dyn Error>>

Log a path traversal attempt.

Arguments

• attempted_path - The path that was attempted

pub fn log_analysis_timeout( &self, provider: &str, model: &str, timeout_seconds: u64, image_hashes: Vec<String>, ) -> Result<(), Box<dyn Error>>

Log an image analysis timeout.

Arguments

• provider - Provider name
• model - Model identifier
• timeout_seconds - Timeout duration in seconds
• image_hashes - SHA256 hashes of images that timed out

pub fn audit_logger(&self) -> &AuditLogger

Get the underlying audit logger.