Struct LoadSession 

pub struct LoadSession { /* private fields */ }

Kernel-backed loader session used by the command entry API.

Implementations

impl LoadSession

pub fn run_loaded_boot(&mut self, boot: &CliBoot) -> Result<i32, CliError>

Loads a boot session and runs the selected loaded CLI entrypoint.

pub fn run_loaded_handoff( &mut self, envelope: &CliEnvelope, ) -> Result<i32, CliError>

Runs the selected loaded CLI entrypoint for an already-loaded session.

impl LoadSession

pub fn run_loaded_introspection( &mut self, boot: &CliBoot, ) -> Result<String, CliError>

Loads a boot session and returns list/inspect output for loader metadata.

Listing or inspecting loaded libraries does not require a boot codec. When the codec is unavailable, fall back to loading just the explicit --load sources so they can still be introspected. (load_boot resolves the boot codec first and returns before loading --load sources when that codec is unavailable, so an empty receipt set means the codec was the failure.)

impl LoadSession

pub fn new() -> Self

Builds a loader session with an empty static host catalog.

pub fn add_loader(&mut self, loader: impl LibLoader + 'static)

Adds a kernel loader to the session.

pub fn add_catalog_source( &mut self, symbol: impl AsRef<str>, source: CatalogSource, )

Registers a catalog source for a library symbol.

pub fn with_catalog_source( self, symbol: impl AsRef<str>, source: CatalogSource, ) -> Self

Registers a catalog source, builder-style.

pub fn with_loader(self, loader: impl LibLoader + 'static) -> Self

Adds a kernel loader, builder-style.

pub fn add_host_factory( &mut self, name: impl Into<String>, factory: impl Fn() -> Box<dyn Lib> + Send + Sync + 'static, )

Adds a host library factory to the static host catalog.

pub fn with_host_factory( self, name: impl Into<String>, factory: impl Fn() -> Box<dyn Lib> + Send + Sync + 'static, ) -> Self

Adds a host library factory, builder-style.

pub fn with_crates_io_resolver(self, resolver: CratesIoResolver) -> Self

Replaces the crates.io resolver used for crates.io: sources.

pub fn with_context(self, configure: impl FnOnce(&mut Cx)) -> Self

Applies direct access to the session context, builder-style.

Hosts use this to install context-level runtime support while keeping concrete command behavior in loaded libraries.

pub fn with_capability(self, capability: CapabilityName) -> Self

Grants a capability to the session’s kernel context, builder-style.

Loaders that require a capability (for example the native dynamic-library loader requires native_dynamic_load_capability()) only succeed when the host has granted it. This lets a composed sim build authorize the loaders it registers.

pub fn add_default_verb_sources( &mut self, verb: impl Into<String>, sources: Vec<LibSourceSpec>, )

Registers sources used when verb is selected without explicit loads.

pub fn with_default_verb_sources( self, verb: impl Into<String>, sources: Vec<LibSourceSpec>, ) -> Self

Registers sources used when verb is selected without explicit loads, builder-style.

pub fn cx(&self) -> &Cx

Returns the active kernel context.

pub fn receipts(&self) -> &[LoadReceipt]

Returns load receipts in boot order.

pub fn load_boot(&mut self, boot: &CliBoot) -> Result<&[LoadReceipt], CliError>

Loads every requested library in the parsed boot controls.

pub fn load_source( &mut self, source: &LibSourceSpec, ) -> Result<LoadReceipt, CliError>

Loads one source through the kernel loader and records a receipt.

pub fn unload_receipt( &mut self, receipt: &LoadReceipt, ) -> Result<Vec<LibId>, CliError>

Unloads a receipt’s library through the kernel lifecycle path.

Trait Implementations

impl Default for LoadSession

fn default() -> Self

Returns the “default value” for a type.