AccuralAI Cache Base

Shared cache abstractions and helpers.

class accuralai_cache.base.CacheConfig(*args: Any, **kwargs: Any)

Bases: BaseModel

Base configuration shared across cache implementations.

copy_on_get: bool = True

stats_enabled: bool = False

class accuralai_cache.base.CacheEntry(response: GenerateResponse, expires_at: float | None = None)

Bases: object

Internal representation of a cached response.

response: GenerateResponse

expires_at: float | None

__init__(response: GenerateResponse, expires_at: float | None = None) → None

class accuralai_cache.base.BaseCache(*, options: CacheConfig | None = None)

Bases: Cache

Helper base class that offers TTL resolution and cloning behaviour.

__init__(*, options: CacheConfig | None = None) → None

property stats: dict[str, int]

Return cache hit/miss counters.

async invalidate_prefix(prefix: str) → None

Optional hook for derived caches; default routes to individual invalidation.

accuralai_cache.base.extract_options(*, config: Any, options_model: type[CacheConfig]) → tuple[CacheConfig, int | None]

Normalize configuration payloads from core settings or dicts.