tooluniverse.cache.sqlite_backend module

SQLite-backed persistent cache for ToolUniverse.

The cache stores serialized tool results with TTL and version metadata. Designed to be a drop-in persistent layer behind the in-memory cache.

class tooluniverse.cache.sqlite_backend.CacheEntry

Bases: object

CacheEntry(key: ‘str’, value: ‘Any’, namespace: ‘str’, version: ‘str’, ttl: ‘Optional[int]’, created_at: ‘float’, last_accessed: ‘float’, hit_count: ‘int’)

key: str

value: Any

namespace: str

version: str

ttl: int | None

created_at: float

last_accessed: float

hit_count: int

__init__(key, value, namespace, version, ttl, created_at, last_accessed, hit_count)

class tooluniverse.cache.sqlite_backend.PersistentCache

Bases: object

SQLite-backed cache layer with TTL support.

__init__(path, *, enable=True)

close()

cleanup_expired()

get(cache_key)

set(cache_key, value, *, namespace, version, ttl)

delete(cache_key)

clear(namespace=None)

iter_entries(namespace=None)

stats()