Struct AmbientOrchestrationManager 

pub struct AmbientOrchestrationManager { /* private fields */ }

Ambient Orchestration Manager

Implementations

impl AmbientOrchestrationManager

pub fn new() -> Self

Create new ambient orchestration manager

pub fn register_device( &mut self, device: AmbientDevice, ) -> Result<(), AmbientError>

Register ambient device

pub fn discover_devices(&mut self) -> Result<Vec<String>, AmbientError>

Discover ambient devices using sysinfo to enumerate real local hardware.

pub fn discover_devices_into( &mut self, out: &mut [AmbientDeviceHandle], ) -> Result<usize, AmbientError>

Zero-heap device discovery snapshots for hot-path schedulers.

pub fn submit_task(&mut self, task: Task) -> Result<String, AmbientError>

Submit task for execution

pub fn execute_neural_inference( &mut self, device_id: &str, model_data: &[u8], input_data: &[u8], ) -> Result<Vec<u8>, AmbientError>

Execute neural inference task

pub fn execute_neural_inference_into( &mut self, device_id: &str, model_data: &[u8], input_data: &[u8], out: &mut [u8], ) -> Result<usize, AmbientError>

Zero-heap neural inference API using caller-owned output storage.

pub fn execute_sub_threshold_computation( &mut self, device_id: &str, computation: SubThresholdComputation, ) -> Result<ComputationResult, AmbientError>

Execute sub-threshold computation

pub fn get_device_status(&self, device_id: &str) -> Option<DeviceStatus>

Get device status

pub fn get_performance_stats(&self) -> AmbientGlobalMetrics

Get performance statistics

pub fn set_orchestration_state(&mut self, state: AmbientOrchestrationState)

Set the ambient orchestration state used for power estimation.

Callers (e.g. the TaskOrchestrator state machine in orchestrator.rs) should push ModelLifecycle transitions here so the power manager can track real power draw.

pub fn set_active_model_count(&mut self, count: usize)

Set the number of models currently active on the managed device.

pub fn get_power_metrics(&self) -> PowerMetrics

Get the aggregated power/thermal/battery snapshot.

pub fn estimate_battery_life_remaining( &self, current_battery_pct: f64, battery_capacity_wh: f64, ) -> f64

Estimate battery life remaining (hours) for the given charge and battery capacity.

pub fn should_throttle_inference(&self) -> bool

Whether inference should be throttled due to thermal or battery pressure.

pub fn list_devices(&self) -> Vec<String>

List all devices

pub fn list_devices_into( &self, out: &mut [AmbientDeviceHandle], ) -> Result<usize, AmbientError>

pub fn get_pending_tasks(&self) -> Vec<Task>

Get pending tasks

pub fn get_pending_tasks_into( &self, out: &mut [TaskHandle], ) -> Result<usize, AmbientError>

pub fn optimize_orchestration(&mut self) -> Result<(), AmbientError>

Optimize orchestration policy