Struct ResolveConfig 

pub struct ResolveConfig {
    pub base: PathBuf,
    pub in_bp_includes: Vec<PathBuf>,
    pub env_includes: Vec<PathBuf>,
    pub cli_includes: Vec<PathBuf>,
    pub config_includes: Vec<PathBuf>,
    pub bundled_default: Option<PathBuf>,
}

Resolution config for $agent_md / $file refs. Ordered list of directories the linker walks first-hit-wins across 6 tiers.

Tier order (highest priority first):

1. base — bp.lua parent directory (always tier 1).
2. in_bp_includes — in-bp declared blueprint_ref_includes (relative to base).
3. env_includes — env MSE_BLUEPRINT_INCLUDES (:- or ;- separated absolute paths).
4. cli_includes — CLI --include <path> repeatable.
5. config_includes — server / config-file blueprint_ref_includes.
6. bundled_default — bundled fallback (typically crates/mlua-swarm-cli/src/mcp/resources/samples/agents/).

Callers construct the config via ResolveConfig::new and layer additional tiers through the builder methods, then pass the config to expand_file_refs_with_config.

Fields

base: PathBuf

bp.lua parent directory (always tier 1, always first).

in_bp_includes: Vec<PathBuf>

In-bp declared includes (tier 2, relative to base).

env_includes: Vec<PathBuf>

Env MSE_BLUEPRINT_INCLUDES (tier 3).

cli_includes: Vec<PathBuf>

CLI --include <path> repeatable (tier 4).

config_includes: Vec<PathBuf>

Server / config-file blueprint_ref_includes (tier 5).

bundled_default: Option<PathBuf>

Bundled default (tier 6). None = no bundled fallback (typical for server-side use, where the server never ships authoring files).

Implementations

impl ResolveConfig

pub fn new(base: impl Into<PathBuf>) -> Self

Build a config with only the base tier set. Callers layer the remaining tiers via builder methods.

pub fn with_in_bp_includes(self, v: Vec<PathBuf>) -> Self

Set the in-bp include list (tier 2). Paths are resolved relative to base at search time.

pub fn with_env_includes(self, v: Vec<PathBuf>) -> Self

Set the env include list (tier 3).

pub fn with_cli_includes(self, v: Vec<PathBuf>) -> Self

Set the CLI include list (tier 4).

pub fn with_config_includes(self, v: Vec<PathBuf>) -> Self

Set the config-file include list (tier 5).

pub fn with_bundled_default(self, p: Option<PathBuf>) -> Self

Set the bundled-default fallback (tier 6). Pass None to disable the fallback (server-side default).

pub fn search_paths(&self) -> impl Iterator<Item = PathBuf> + '_

Iterate every configured directory in cascade order (tier 1 → 6). in_bp_includes entries are joined onto base at iteration time so callers can pass in relative paths as declared in the bp.lua source.

Trait Implementations

impl Clone for ResolveConfig

fn clone(&self) -> ResolveConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolveConfig

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

Formats the value using the given formatter.

impl Default for ResolveConfig

fn default() -> ResolveConfig

Returns the “default value” for a type.