Struct EngineHandle 

pub struct EngineHandle { /* private fields */ }

Shared, hot-swappable reference to the active OxiosEngine.

Wraps RwLock<Arc<OxiosEngine>> so that:

• Writers (EngineApi) can atomically replace the engine on config change
• Readers (AgentRuntime) always get the current engine at execution time

Cost

Rebuilding OxiosEngine is cheap: OxiBuilder::new().with_builtins().build() populates registries from static model_db data (~1μs, no I/O, no network).

Concurrency

• parking_lot::RwLock is not async-aware, but engine swap only occurs on explicit user action (Web UI / CLI config change) — never in a hot path.
• Agent execution reads the engine once at the start of execute() and uses the same Arc<OxiosEngine> for the entire run (consistent within one execution).

Implementations

impl EngineHandle

pub fn new(engine: Arc<OxiosEngine>) -> Self

Create a new handle wrapping the given engine.

pub fn get(&self) -> Arc<OxiosEngine>

Get a snapshot of the current engine.

The returned Arc is stable — it won’t change even if another thread calls swap() concurrently.

pub fn swap(&self, new_engine: OxiosEngine)

Atomically replace the engine with a new one.

Callers should rebuild OxiosEngine with updated credentials/model before calling this.

Trait Implementations

impl Debug for EngineHandle

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

Formats the value using the given formatter.