CachedTool: Event Handling

[realdavidvega]

Background

The CachedTool is designed to cache results to improve system performance by avoiding redundant computations. It supports different expiration policies to manage cache life cycles efficiently. However, monitoring and handling cache events are crucial to maintain transparency of cache operations.

This PR

• Introduces Event Handling: Adds new classes within the CachedToolEvent sealed interface to handle different cache operation events:

  • Created is fired when a new cache entry is added.
  • Updated is triggered when an existing cache entry is updated.
  • Evicted occurs when an expired cache entry is removed.
  • ExpiredPurged is sent when all expired entries are purged from the cache.

• Implements Event Callback:

  • Introduces an overridable onCacheEvent method that can be customized to handle events whenever cache mutations occur.