Struct SqliteCache 

pub struct SqliteCache { /* private fields */ }

Persistent cache in a single SQLite file.

Implementations

impl SqliteCache

pub fn import_profile(source: &Path, id: &str) -> Result<CacheProfile>

Select a validated profile without opening the source as a writable cache.

pub fn import_from( source: &Path, destination: &Path, profile: &CacheProfile, mappings: &[CacheImportMapping], ) -> Result<CacheImportReport>

Seed an absent or completely empty v7 cache from verified local files. Schema v6 and v7 sources are supported; derived image codes are ignored. Errors roll back schema and data; verification failures drop individual resources and are reported as counts. PDF/audio preparation compatibility is also checked by the runtime on reuse.

impl SqliteCache

pub fn default_path() -> Result<PathBuf>

The default location: <platform cache dir>/seyk/cache.sqlite3.

macOS: ~/Library/Caches/seyk/, Linux: $XDG_CACHE_HOME/seyk/ (usually ~/.cache/seyk/).

pub fn open_default() -> Result<Self>

pub fn open(path: impl Into<PathBuf>) -> Result<Self>

Open or create a cache file. Embeddings can leak information about their source text, so owned directories and the cache file are private to the user.

pub fn path(&self) -> &Path

Trait Implementations

impl EmbeddingCache for SqliteCache

fn scrub(&mut self) -> Result<CacheCleanup>

Erase stale FTS postings and historical WAL frames. Busy readers leave work pending.

fn scrub_if_idle(&mut self, quiet: Duration) -> Result<Option<CacheCleanup>>

Attempt a background scrub after this long without writes. Busy work is retried at the same interval, rather than on every scheduler tick.

fn scrub_delay(&self, quiet: Duration) -> Duration

Scheduler delay until the next quiet-period/retry deadline. When idle, check at this interval to observe activity from other processes.

fn register_profile(&mut self, id: &str, profile: &CacheProfile) -> Result<()>

fn resource_index( &self, profile: &str, ) -> Result<HashMap<ResourceId, CachedResourceState>>

Every cached resource for a profile, keyed by identity. Segments are not loaded.

fn resource( &self, profile: &str, path: &ResourceId, ) -> Result<Option<CachedResource>>

fn put_resource( &mut self, profile: &str, path: &ResourceId, resource: &ResourceWrite<'_>, ) -> Result<()>

Replace a resource and its segments.

fn touch_resource( &mut self, profile: &str, path: &ResourceId, metadata: &ResourceMetadata, version: &ResourceVersion, ) -> Result<()>

Update metadata and version when content is unchanged.

fn remove_resources( &mut self, profile: &str, paths: &[ResourceId], ) -> Result<()>

fn known_inputs( &self, profile: &str, hashes: &[String], ) -> Result<HashSet<String>>

Which of hashes already have a vector.

fn put_embeddings( &mut self, profile: &str, items: &[(String, Vec<f32>)], ) -> Result<()>

fn supports_image_codes(&self) -> bool

Whether persistent Photo Anchor representations are supported.

fn sync_image_codes( &mut self, profile: &str, paths: &HashSet<ResourceId>, ) -> Result<()>

Derive missing image codes from retained f32 during an opted-in sync.

fn image_scan_rows( &self, profile: &str, paths: &HashSet<ResourceId>, ) -> Result<Vec<ScanVector>>

Read representations without writing or loading f32 for coded images.

fn selected_image_vectors( &self, profile: &str, hashes: &HashSet<String>, ) -> Result<HashMap<String, Vec<f32>>>

Fetch only selected f32 vectors, deduplicated by input hash.

fn vectors_for( &self, profile: &str, paths: &HashSet<ResourceId>, ) -> Result<Vec<StoredVector>>

All searchable vectors for the given paths.

fn lexical_search( &self, profile: &str, query: &LexicalQuery, paths: &HashSet<ResourceId>, limit: usize, ) -> Result<Vec<LexicalHit>>

Segments of paths matching query by keyword, best first, at most limit. Equal scores are ordered by path bytes, then segment ordinal.

fn lexical_matched_terms( &self, profile: &str, query: &LexicalQuery, keys: &[(ResourceId, usize)], ) -> Result<Vec<Vec<String>>>

Query tokens confirmed by the cached index for the requested segments. Called only for final hits ranked by the keyword leg, after fusion and eligibility checks. Return one term list per key, in the same order. Never recover source text; report only complete matching query groups.

fn prune_orphans(&mut self, profile: &str) -> Result<u64>

Drop vectors no segment refers to any more.

fn stats(&self) -> Result<CacheStats>

fn clear(&mut self) -> Result<()>