Struct RuntimeController 

pub struct RuntimeController { /* private fields */ }

Coordinates lifecycle, idempotency, command dispatch, events and audit.

Implementations

impl RuntimeController

pub fn new(instance: RuntimeInstance) -> Self

Creates a controller with process-local idempotency.

pub fn with_idempotency_store( instance: RuntimeInstance, idempotency: Box<dyn IdempotencyStore + Send + Sync>, ) -> Self

Creates a controller with an explicit idempotency store.

pub fn instance(&self) -> &RuntimeInstance

Returns the hosted immutable Runtime instance.

pub fn instance_arc(&self) -> Arc<RuntimeInstance>

Returns a shared reference-counted Runtime instance.

pub fn lifecycle(&self) -> &RuntimeLifecycle

Returns the process lifecycle.

pub fn idempotency_len(&self) -> usize

Returns the number of active idempotency records.

pub fn idempotency_contains(&self, key: &str) -> RuntimeResult<bool>

Reports whether an idempotency key has an active record.

pub fn apply_lifecycle_event( &self, event: RuntimeLifecycleEvent, ) -> RuntimeResult<RuntimeLifecycleState>

Applies one process lifecycle event.

pub fn dispatch_command( &self, command: &CommandEnvelope, context: &dyn RuntimeContext, ) -> RuntimeResult<CommandResult>

Runs the complete command dispatch transaction.

pub fn inflight_commands(&self) -> usize

Returns the number of commands currently executing or finalizing.

pub fn wait_for_inflight(&self, timeout: Duration) -> bool

Waits up to timeout for every admitted command to finish.

Callers must request the shutdown lifecycle transition first so new commands cannot enter while the drain is in progress.

pub fn pre_dispatch( &self, command: &CommandEnvelope, ) -> RuntimeResult<Option<RuntimeResult<CommandResult>>>

Performs lifecycle and idempotency checks before handler execution.

pub fn post_dispatch( &self, command: &CommandEnvelope, dispatch_result: &RuntimeResult<CommandResult>, ) -> RuntimeResult<()>

Persists command outcome and emits accepted events after handler execution.

Trait Implementations

impl Clone for RuntimeController

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.