agnes-the-ai-analyst/app/api/v2_cache.py
ZdenekSrotyr 2e1dfb7553
feat(v2): claude-driven fetch primitives + 0.14.0 (#102)
Replaces the BigQuery wrap-view pattern with a discovery + scoped-fetch toolkit driven by the analyst's Claude session. Adds /api/v2/{catalog,schema,sample,scan,scan/estimate}, da catalog/schema/describe/fetch/snapshot/disk-info CLI commands, sqlglot-backed WHERE validator, process-local quota tracker, agent rails skill (cli/skills/agnes-data-querying.md). BREAKING: BQ wrap views off by default — set data_source.bigquery.legacy_wrap_views=true for one cycle. Backward-compat field_validator on primary_key. Catalog cache now matches documented 300s TTL with RBAC fresh per request. Cuts release v0.14.0.
2026-04-29 01:07:19 +02:00

48 lines
1.4 KiB
Python

"""Simple thread-safe LRU + TTL cache for v2 endpoints (spec §3.6)."""
from __future__ import annotations
import threading
import time
from collections import OrderedDict
from typing import Any
def _now() -> float: # patched in tests
return time.monotonic()
class TTLCache:
def __init__(self, *, maxsize: int, ttl_seconds: float):
self._max = maxsize
self._ttl = ttl_seconds
self._lock = threading.Lock()
self._data: "OrderedDict[str, tuple[float, Any]]" = OrderedDict()
def get(self, key: str, default: Any = None) -> Any:
with self._lock:
entry = self._data.get(key)
if entry is None:
return default
expiry, value = entry
if _now() > expiry:
del self._data[key]
return default
self._data.move_to_end(key) # mark as recently used
return value
def set(self, key: str, value: Any) -> None:
with self._lock:
expiry = _now() + self._ttl
if key in self._data:
self._data.move_to_end(key)
self._data[key] = (expiry, value)
while len(self._data) > self._max:
self._data.popitem(last=False)
def invalidate(self, key: str) -> None:
with self._lock:
self._data.pop(key, None)
def clear(self) -> None:
with self._lock:
self._data.clear()