Struct FewShotStore 

pub struct FewShotStore { /* private fields */ }

Library of few-shot examples discovered from disk.

Construct via FewShotStore::load to read from both the workspace .vtcode/prompts/examples/ and the canonical user config prompts directory directories. The constructor is fail-soft: unreadable files or bad frontmatter are skipped with a warning, not a panic.

Implementations

impl FewShotStore

pub fn load(workspace_root: Option<&Path>, home_dir: Option<&Path>) -> Self

Load all examples from the workspace + home directories. The workspace directory takes precedence on id collision (the home copy is skipped with a warning).

Pass workspace_root = Some("/path") and home_dir = None to load only the workspace; pass home_dir = Some("/home/user") to also pull user-global examples.

pub async fn load_async( workspace_root: Option<&Path>, home_dir: Option<&Path>, ) -> Self

Load examples without performing cache-key or cache-miss filesystem work on a Tokio worker. Warm loads still use the blocking pool because canonicalizing a new source path may touch the filesystem.

pub fn from_examples(examples: Vec<FewShotExample>) -> Self

Construct a store from an in-memory list. Useful for tests and for loading examples that come from somewhere other than disk.

pub fn len(&self) -> usize

Number of loaded examples.

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> impl Iterator<Item = &FewShotExample>

Iterate over all loaded examples in deterministic id order.

pub fn select(&self, query: &str, budget_tokens: usize) -> Vec<&FewShotExample>

Select examples whose tags overlap with the query, capped at budget_tokens. Returns examples in score-descending order (ties broken by id ascending).

Scoring rule:

• +1.0 for each exact match between a tag and a query word
• +0.5 for each tag that appears as a substring of the query

budget_tokens of 0 (or any value smaller than the smallest example) returns an empty selection. Examples whose token_count alone exceeds the budget are skipped.

Trait Implementations

impl Clone for FewShotStore

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FewShotStore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FewShotStore

fn default() -> Self

Returns the “default value” for a type.