Trait Index

Source

pub trait Index:
    Named
    + Clone
    + Send
    + Sync
    + 'static {
    // Required methods
    fn source(&self) -> &ContentSource;
    fn source_type(&self) -> SourceType;
    fn to_summary_line(&self) -> String;

    // Provided methods
    fn priority(&self) -> i32 { ... }
    fn load_content<'life0, 'async_trait>(
        &'life0 self,
    ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait { ... }
    fn description(&self) -> &str { ... }
}

Expand description

Core trait for index entries in the progressive disclosure pattern.

Index entries contain minimal metadata (name, description) that is always available in the system prompt, while full content is loaded on-demand.

§Token Efficiency

By keeping only metadata in context:

50 skills × ~20 tokens each = ~1,000 tokens (always loaded)
vs 50 skills × ~500 tokens each = ~25,000 tokens (if fully loaded)

§Example Implementation

pub struct SkillIndex {
    name: String,
    description: String,
    source: ContentSource,
    source_type: SourceType,
}

impl Index for SkillIndex {
    fn source(&self) -> &ContentSource { &self.source }
    fn source_type(&self) -> SourceType { self.source_type }
    fn to_summary_line(&self) -> String {
        format!("- {}: {}", self.name, self.description)
    }
}