Struct AetherConfig 

pub struct AetherConfig {

    pub toon_enabled: bool,
    pub healing_enabled: bool,
    pub cache_enabled: bool,
    pub parallel: bool,
    pub inspector_enabled: bool,
    pub inspector_port: u16,
    pub max_retries: u32,
    pub auto_toon_threshold: Option<usize>,
    pub cache_threshold: f32,
    pub prompt_toon_header: String,
    pub prompt_toon_note: String,
    pub prompt_healing_feedback: String,
    pub prompt_tdd_notice: String,
    pub retry_backoff_ms: u64,
}

Global configuration for the Aether engine.

Example

use aether_core::AetherConfig;
 
// Load from environment
let config = AetherConfig::from_env();
 
// Or customize
let config = AetherConfig::default()
    .with_toon(true)
    .with_healing(true);

Fields

toon_enabled: bool

Enable TOON (Token-Oriented Object Notation) for context compression. Reduces token usage by 30-60% for structured data. Default: false, Env: AETHER_TOON=true

healing_enabled: bool

Enable Self-Healing mode (automatic validation and retry on errors). Default: false, Env: AETHER_HEALING=true

cache_enabled: bool

Enable Semantic Cache (reduces API costs for similar prompts). Default: false, Env: AETHER_CACHE=true

parallel: bool

Enable parallel slot generation. Default: true, Env: AETHER_PARALLEL=false

inspector_enabled: bool

Whether to enable the Aether Inspector UI. Default: false, Env: AETHER_INSPECT=true

inspector_port: u16

Port for the Aether Inspector UI. Default: 3000, Env: AETHER_INSPECT_PORT=8080

max_retries: u32

Maximum retries for failed generations. Default: 2, Env: AETHER_MAX_RETRIES=3

auto_toon_threshold: Option<usize>

Auto-enable TOON when context exceeds this character count. If None, TOON is only enabled manually. Default: Some(2000), Env: AETHER_TOON_THRESHOLD=2000

cache_threshold: f32

Cache similarity threshold (0.0 - 1.0). Higher values require more similar prompts to hit the cache. Default: 0.90, Env: AETHER_CACHE_THRESHOLD=0.90

prompt_toon_header: String

Prompt header for TOON context block.

prompt_toon_note: String

Instructional note for the AI about TOON protocol.

prompt_healing_feedback: String

Feedback prefix for self-healing retries.

prompt_tdd_notice: String

Notice added when TDD mode is active.

retry_backoff_ms: u64

Base delay for retry backoff in milliseconds.

Implementations

impl AetherConfig

pub fn from_env() -> Self

Create a new config from environment variables. Falls back to defaults for missing variables.

pub fn with_toon(self, enabled: bool) -> Self

Builder: Enable or disable TOON protocol.

pub fn with_healing(self, enabled: bool) -> Self

Builder: Enable or disable Self-Healing.

pub fn with_cache(self, enabled: bool) -> Self

Builder: Enable or disable Semantic Cache.

pub fn with_parallel(self, enabled: bool) -> Self

Builder: Enable or disable parallel generation.

pub fn with_inspector(self, enabled: bool) -> Self

Builder: Enable or disable Aether Inspector.

pub fn with_inspector_port(self, port: u16) -> Self

Builder: Set Aether Inspector port.

pub fn with_max_retries(self, retries: u32) -> Self

Builder: Set maximum retries.

pub fn with_auto_toon_threshold(self, threshold: Option<usize>) -> Self

Builder: Set auto TOON threshold.

pub fn should_use_toon(&self, context_length: usize) -> bool

Check if TOON should be used for a given context length.

pub fn default_cache(&self) -> Result<TieredCache>

Create a recommended default cache for the engine. Returns a TieredCache (Hybrid Exact + Semantic).

Trait Implementations

impl Clone for AetherConfig

fn clone(&self) -> AetherConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AetherConfig

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

Formats the value using the given formatter.

impl Default for AetherConfig

fn default() -> Self

Returns the “default value” for a type.