Struct ApiState 

pub struct ApiState {

    pub network_connection_info_provider: Option<Arc<dyn NetworkConnectionInfoProvider>>,
    pub agent_service: Option<Arc<dyn AgentService + Send + Sync>>,
    pub analytics_service: Arc<dyn AnalyticsService + Send + Sync>,
    pub connectome_service: Arc<dyn ConnectomeService + Send + Sync>,
    pub genome_service: Arc<dyn GenomeService + Send + Sync>,
    pub neuron_service: Arc<dyn NeuronService + Send + Sync>,
    pub runtime_service: Arc<dyn RuntimeService + Send + Sync>,
    pub system_service: Arc<dyn SystemService + Send + Sync>,
    pub snapshot_service: Option<Arc<dyn SnapshotService + Send + Sync>>,
    pub feagi_session_timestamp: i64,
    pub filesystem_data_root: PathBuf,
    pub memory_stats_cache: Option<MemoryStatsCache>,
    pub amalgamation_state: SharedAmalgamationState,
    pub genome_transition_lock: Arc<Mutex<()>>,
    pub genome_transition_in_progress: Arc<AtomicBool>,
    pub agent_handler: Option<Arc<Mutex<FeagiAgentHandler>>>,
}

Application state shared across all HTTP handlers

Fields

network_connection_info_provider: Option<Arc<dyn NetworkConnectionInfoProvider>>

Optional provider for GET /v1/network/connection_info (None in tests/WASM)

agent_service: Option<Arc<dyn AgentService + Send + Sync>>

analytics_service: Arc<dyn AnalyticsService + Send + Sync>

connectome_service: Arc<dyn ConnectomeService + Send + Sync>

genome_service: Arc<dyn GenomeService + Send + Sync>

neuron_service: Arc<dyn NeuronService + Send + Sync>

runtime_service: Arc<dyn RuntimeService + Send + Sync>

system_service: Arc<dyn SystemService + Send + Sync>

snapshot_service: Option<Arc<dyn SnapshotService + Send + Sync>>

feagi_session_timestamp: i64

FEAGI session timestamp in milliseconds (Unix timestamp when FEAGI started) This is a unique identifier for each FEAGI instance/session

filesystem_data_root: PathBuf

Base directory for default API filesystem writes when the client omits a path (e.g. POST /v1/genome/save without file_path). Default genome files go under {filesystem_data_root}/cache/.genome/ (aligned with feagi-python-sdk ~/.feagi/cache). Set from [system].data_dir / FEAGI_DATA_DIR at startup; when unset, resolves to {user_home}/.feagi (native) so writes do not use cwd or OS temp (see ApiState::filesystem_data_root_from_config).

memory_stats_cache: Option<MemoryStatsCache>

Memory area stats cache (updated by plasticity service, read by health check)

amalgamation_state: SharedAmalgamationState

In-memory amalgamation state (pending request + history), surfaced via health_check.

genome_transition_lock: Arc<Mutex<()>>

Exclusive lock for genome transition operations (load/upload/reload).

genome_transition_in_progress: Arc<AtomicBool>

Indicates whether a prioritized genome transition is currently in progress.

agent_handler: Option<Arc<Mutex<FeagiAgentHandler>>>

Agent handler for device registrations and transport management

Implementations

impl ApiState

pub fn init_agent_registration_handler() -> Arc<Mutex<FeagiAgentHandler>>

Initialize the agent handler (deprecated - use external initialization).

pub fn init_amalgamation_state() -> SharedAmalgamationState

Initialize amalgamation_state field (empty state).

pub fn init_genome_transition_controls() -> (Arc<Mutex<()>>, Arc<AtomicBool>)

Initialize synchronization primitives for strict genome transitions.

pub fn filesystem_data_root_from_config(data_dir: &Path) -> PathBuf

Resolve the base directory for default on-disk API writes (e.g. genome save without file_path).

• If [system].data_dir is set (including via FEAGI_DATA_DIR), returns that path as-is.
• Otherwise returns {user_home}/.feagi, matching feagi-python-sdk FeagiPaths and feagi-desktop runtime layout. If the home directory cannot be resolved, falls back to std::env::temp_dir().join("feagi").
• wasm32: /tmp/feagi (no portable home in browser WASM).

Callers append subpaths such as cache/.genome for default genome JSON files.

Trait Implementations

impl Clone for ApiState

fn clone(&self) -> ApiState

Returns a duplicate of the value.

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

Performs copy-assignment from source.