Struct EngineState 

pub struct EngineState<S: WorkflowStore> {
    pub workflow: Arc<WorkflowCtx<S>>,
    pub dashboard: Arc<DashboardCtx>,
    pub auth: Option<AuthCtx>,
    pub vault: Option<VaultCtx>,
    pub admin_api_keys: Arc<Vec<String>>,
    pub modules: Arc<Vec<String>>,
    pub instance_id: Uuid,
    pub engine_version: &'static str,
    pub started_at: f64,
    pub engine_config: Arc<EngineConfig>,
}

Fields

workflow: Arc<WorkflowCtx<S>>

dashboard: Arc<DashboardCtx>

auth: Option<AuthCtx>

Composed auth context — present iff the runtime engine.modules.auth.enabled row is TRUE. axum::FromRef extracts it for the auth router’s handlers.

vault: Option<VaultCtx>

Composed vault context — present iff the vault Cargo feature is on AND the runtime engine.modules.vault.enabled row is TRUE. Plan 17’s v0.3.0 module — KV / transit / collections / share / sealing / dynamic creds / BW-compat all hang off this.

admin_api_keys: Arc<Vec<String>>

Admin API keys for the /admin/* HTTP surface — checked by auth handlers via axum::extract::FromRef<EngineState<S>> so the same value flows from engine.toml through to per-request auth gating without a global static. Empty when no admin surface is configured.

modules: Arc<Vec<String>>

Names of modules attached/loaded during boot — surfaced through /healthz for ops visibility (which functional modules this engine instance has wired up).

instance_id: Uuid

This instance’s row in engine.instances. Lets /healthz and future visibility endpoints identify which engine process is answering.

engine_version: &'static str

assay-engine crate version. Returned in /api/v1/engine/core/health so external monitors can correlate health checks with deployments.

started_at: f64

Wall-clock seconds since the UNIX epoch when this engine process finished booting. Surfaced through /api/v1/engine/core/info so the engine console can display “uptime” without an extra DB lookup per request — matches the value the engine wrote to its engine.instances row at boot.

engine_config: Arc<EngineConfig>

Parsed engine.toml snapshot — admin endpoints serialise this (with secrets redacted) so the engine console’s “Config” pane shows the operator exactly what the running engine is using. Arc so cloning state per-request stays cheap.

Trait Implementations

impl<S: Clone + WorkflowStore> Clone for EngineState<S>

fn clone(&self) -> EngineState<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: WorkflowStore> FromRef<EngineState<S>> for AuthCtx

fn from_ref(s: &EngineState<S>) -> Self

FromRef impl so auth handlers can extract the resolved AuthCtx via State<AuthCtx>. Panics when the engine binary mounted the auth router without composing an AuthCtx — a misconfiguration the engine boot path is responsible for preventing (the auth router is only mounted when state.auth.is_some()).

impl<S: WorkflowStore> FromRef<EngineState<S>> for AdminApiKeys

fn from_ref(s: &EngineState<S>) -> Self

Converts to this type from a reference to the input type.

impl<S: WorkflowStore> FromRef<EngineState<S>> for VaultCtx

Available on crate feature vault only.

fn from_ref(s: &EngineState<S>) -> Self

FromRef impl so vault handlers (added Phase 1+) can extract the resolved VaultCtx via State<VaultCtx>. Panics when the vault router is mounted without composing a VaultCtx — same engine- boot-bug surface AuthCtx uses.