"""Persistent per-conversation search context.""" from __future__ import annotations import json import os import tempfile import time from pathlib import Path from typing import Any, Callable class SessionContextStore: """Store recent media/resource results without mixing conversations.""" def __init__( self, path: str | Path, *, ttl: int = 600, clock: Callable[[], float] = time.time, ) -> None: self.path = Path(path) self.ttl = max(int(ttl), 1) self._clock = clock self._sessions: dict[str, dict[str, Any]] = {} self._load() def _load(self) -> None: if not self.path.exists(): return try: payload = json.loads(self.path.read_text(encoding="utf-8")) except (OSError, ValueError): return if isinstance(payload, dict): self._sessions = { str(key): value for key, value in payload.items() if isinstance(value, dict) } self._purge_expired(save=False) def _save(self) -> None: self.path.parent.mkdir(parents=True, exist_ok=True) fd, temp_name = tempfile.mkstemp( prefix=f"{self.path.name}.", suffix=".tmp", dir=self.path.parent ) try: with os.fdopen(fd, "w", encoding="utf-8") as output: json.dump(self._sessions, output, ensure_ascii=False, indent=2) output.write("\n") os.replace(temp_name, self.path) finally: if os.path.exists(temp_name): os.remove(temp_name) def _purge_expired(self, *, save: bool = True) -> None: now = self._clock() expired = [ origin for origin, session in self._sessions.items() if float(session.get("updated_at", 0)) + self.ttl <= now ] for origin in expired: self._sessions.pop(origin, None) if expired and save: self._save() def _session(self, origin: str) -> dict[str, Any]: self._purge_expired() return self._sessions.setdefault(origin, {}) def _touch(self, origin: str) -> dict[str, Any]: session = self._session(origin) session["updated_at"] = self._clock() return session def set_media_results(self, origin: str, results: list[dict[str, Any]]) -> None: session = self._touch(origin) session["media_results"] = results session.pop("resource_results", None) self._save() def get_media_results(self, origin: str) -> list[dict[str, Any]]: results = self._session(origin).get("media_results", []) return results if isinstance(results, list) else [] def get_media_result(self, origin: str, index: int) -> dict[str, Any] | None: results = self.get_media_results(origin) if index < 1 or index > len(results): return None item = results[index - 1] return item if isinstance(item, dict) else None def set_resource_results( self, origin: str, media: dict[str, Any], results: list[dict[str, Any]] ) -> None: session = self._touch(origin) session["resource_media"] = media session["resource_results"] = results self._save() def get_resource_results(self, origin: str) -> list[dict[str, Any]]: results = self._session(origin).get("resource_results", []) return results if isinstance(results, list) else [] def get_resource_result(self, origin: str, index: int) -> dict[str, Any] | None: results = self.get_resource_results(origin) if index < 1 or index > len(results): return None item = results[index - 1] return item if isinstance(item, dict) else None def get_resource_media(self, origin: str) -> dict[str, Any] | None: media = self._session(origin).get("resource_media") return media if isinstance(media, dict) else None def clear(self, origin: str) -> None: if origin in self._sessions: self._sessions.pop(origin, None) self._save()