Struct PageCache 

pub struct PageCache { /* private fields */ }

Redis-backed cache for paginated lists.

Implementations

impl PageCache

pub fn offline() -> Self

In-memory placeholder (no Redis) for offline adapters/tests: every operation is a no-op. Real adapters should use connect().

pub async fn connect(config: &BotConfig) -> Result<Self>

Connect to Redis (same URL as FicHub).

pub async fn store( &self, title: &str, entries: Vec<PageEntry>, ) -> Result<String>

Store a new list, returning its session id.

pub async fn store_for_user( &self, user_id: u64, title: &str, entries: Vec<PageEntry>, ) -> Result<String>

Store a new list for a user, remembering it as their “latest” session (so !next/!prev/!page X know which list to paginate).

pub async fn latest_for_user(&self, user_id: u64) -> Result<Option<String>>

The user’s most recent list session id, if any.

pub async fn current_page(&self, session_id: &str) -> Result<Option<usize>>

Current page for a session (defaults to 1 when unset).

pub async fn set_current_page( &self, session_id: &str, page: usize, ) -> Result<()>

Record the current page for a session.

pub async fn fetch(&self, session_id: &str) -> Result<Option<PageList>>

Fetch a stored list by session id.

pub async fn delete(&self, session_id: &str) -> Result<()>

Delete a stored list (call after a session ends).

pub async fn log_search(&self, entry: &SearchLogEntry)

Append a search-log entry to today’s Redis list, trimming to the last SEARCH_LOG_CAP entries and giving the key a 7-day TTL.

Logging is best-effort: a Redis failure must never break the search command, so the caller ignores the error. Keys look like archivist:searchlog:2026-08-15.

pub async fn cached_response(&self, kind: &str, query: &str) -> Option<Value>

Look up a cached response value by kind + raw query.

kind selects the key prefix + TTL: "ask" (archivist:askcache:<h>) or "search" (archivist:searchcache:<h>). Only the raw JSON bytes are cached; the caller deserializes into the typed response so this method stays generic. Returns Ok(None) on miss or Redis failure (best-effort — a broken cache must never break the command).

pub async fn cache_response(&self, kind: &str, query: &str, value: &Value)

Store a response value in the cache (best-effort, like log_search).

kind selects the TTL: ask entries live longer (LLM cost is the dominant expense); search entries get a short TTL so results do not go stale as the archive grows.

pub async fn cached_raw(&self, key: &str) -> Option<Value>

Look up a raw cached value by an EXPLICIT key (e.g. the intent cache, which uses its own TTL). Returns Ok(None) on miss or Redis failure.

pub async fn cache_raw(&self, key: &str, ttl_secs: u64, value: &Value)

Store a raw JSON value under an EXPLICIT key + TTL (best-effort).

Trait Implementations

impl Clone for PageCache

fn clone(&self) -> PageCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.