Struct SourceCache 

pub struct SourceCache { /* private fields */ }

Manages a local cache directory for externally-sourced definitions.

Cache layout:

~/.ta/cache/{kind}/
  {name}.yaml          — the cached YAML content
  {name}.meta.json     — sidecar with CachedItem metadata

Implementations

impl SourceCache

pub fn new(kind: &str) -> Self

Create a new cache rooted at ~/.ta/cache/{kind}/.

kind is typically "workflows" or "agents".

pub fn with_dir(dir: PathBuf) -> Self

Create a cache rooted at a custom directory (useful for tests).

pub fn cache_dir(&self) -> &Path

Return the cache root directory.

pub fn get(&self, name: &str) -> Option<CachedItem>

Return a cached item by name, or None if it is not cached.

pub fn store( &self, name: &str, content: &str, source: &ExternalSource, version: &str, ) -> Result<CachedItem, SourceError>

Store content in the cache. Returns the resulting CachedItem.

pub fn remove(&self, name: &str) -> Result<bool, SourceError>

Remove a cached item. Returns true if it existed.

pub fn list(&self) -> Vec<CachedItem>

List all cached items.