Struct ResourceLoader 

pub struct ResourceLoader { /* private fields */ }

Resource loader for all oxi resources

Loads skills, prompts, themes, context files, and system prompts from multiple directories (user-level, project-level, CLI-specified). Supports caching, deduplication, and hot-reload.

Implementations

impl ResourceLoader

pub fn new() -> Self

Create a new resource loader with defaults

pub fn with_options(options: ResourceLoaderOptions) -> Self

Create a resource loader with options

pub fn with_paths(base_dir: PathBuf, cwd: PathBuf) -> Self

Create with custom base and working directory

pub fn with_base_dir(&mut self, base_dir: PathBuf) -> &mut Self

Set base directory

pub fn with_cwd(&mut self, cwd: PathBuf) -> &mut Self

Set current working directory

pub fn add_extension(&mut self, path: PathBuf) -> &mut Self

Add an extension source

pub fn add_skill(&mut self, path: PathBuf) -> &mut Self

Add a skill source

pub fn add_theme(&mut self, path: PathBuf) -> &mut Self

Add a theme source

pub fn add_prompt(&mut self, path: PathBuf) -> &mut Self

Add a prompt source

pub fn extend_resources( &mut self, skill_paths: Vec<(PathBuf, PathMetadata)>, prompt_paths: Vec<(PathBuf, PathMetadata)>, theme_paths: Vec<(PathBuf, PathMetadata)>, )

Extend resources from extension paths

pub fn load_all(&self) -> Result<LoadedResources, Error>

Load all resources

pub fn try_load_all(&self) -> LoadedResources

Load all resources, returning default on error

pub fn reload(&self) -> Result<LoadedResources, Error>

Reload resources (clears cache first)

pub fn load_system_prompt(&self) -> Result<Option<String>, Error>

Load system prompt from SYSTEM.md files

pub fn load_append_system_prompt(&self) -> Result<Vec<String>, Error>

Load append system prompt from APPEND_SYSTEM.md files

pub fn load_project_context_files( &self, cwd: &Path, ) -> Result<Vec<ContextFile>, Error>

Load project context files (AGENTS.md, CLAUDE.md, etc.)

pub fn discover_context_files( &self, dir: &Path, ) -> Vec<(PathBuf, ContextFileType)>

Discover context files in project and ancestor directories

pub fn cached(&self) -> Option<LoadedResources>

Get cached resources if available

pub fn clear_cache(&self)

Clear the cache

pub fn is_cache_stale(&self) -> bool

Check if cache is stale (any source file was modified since last load)

pub fn load_if_stale(&self) -> Result<LoadedResources, Error>

Load if cache is stale, otherwise return cached

pub fn detect_resource_type(path: &Path) -> Option<ResourceType>

Detect the resource type from a path

pub fn is_valid_resource_path(path: &Path, resource_type: ResourceType) -> bool

Check if a path exists and is a valid resource

pub fn validate_resource_path(path: &Path) -> Result<ResourceType, String>

Validate that a resource path can be loaded

pub fn cwd(&self) -> &Path

Get the current working directory

pub fn agent_dir(&self) -> &Path

Get the agent directory

pub fn get_skills(&self) -> Vec<Skill>

Get loaded skills

pub fn get_themes(&self) -> Vec<Theme>

Get loaded themes

pub fn get_prompts(&self) -> Vec<Prompt>

Get loaded prompts

pub fn get_context_files(&self) -> Vec<ContextFile>

Get loaded context files

pub fn get_system_prompt(&self) -> Option<String>

Get system prompt

pub fn get_append_system_prompt(&self) -> Vec<String>

Get append system prompt

pub fn get_agents_files(&self) -> Vec<(PathBuf, String)>

Get agents files (alias for context files in agent format)

Trait Implementations

impl Default for ResourceLoader

fn default() -> Self

Returns the “default value” for a type.