xybrid-core 0.1.0

Core runtime for hybrid cloud-edge AI inference: model execution, pipeline orchestration, and routing primitives.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! Device module - Hardware capability detection and device-specific functionality.
//!
//! This module provides unified hardware capability detection across platforms,
//! including GPU acceleration, neural network APIs, battery level, and thermal state.
//!
//! ## Module Organization
//!
//! The device module is organized into focused submodules:
//!
//! | Module | Purpose |
//! |--------|---------|
//! | [`types`] | Data types (HardwareCapabilities, enums) |
//! | [`common`] | Cross-platform detection (memory, CPU) |
//! | [`apple`] | Apple platform detection (Metal, CoreML, Neural Engine) |
//! | [`android`] | Android platform detection (NNAPI, API level) |
//! | [`capabilities`] | Main detection logic and re-exports |
//!
//! ## Usage
//!
//! ```no_run
//! use xybrid_core::device::{detect_capabilities, HardwareCapabilities};
//!
//! let capabilities = detect_capabilities();
//! println!("GPU available: {}", capabilities.has_gpu());
//! println!("Memory: {} MB", capabilities.memory_total_mb());
//! ```

// Core types
pub mod types;

// Cross-platform detection (memory, CPU)
pub mod common;

// Platform-specific detection
pub mod android;
pub mod apple;

#[cfg(target_os = "windows")]
pub mod windows;

// Main detection logic
pub mod capabilities;

// Telemetry-facing device profile (chip, RAM, OS, for wire events)
pub mod profile;

// Per-inference resource monitor + sampler.
// See `docs/sdk/resource-telemetry.md` for the public contract.
pub mod resource;

// Platform-bridged signals (battery, thermal) — consumed by `resource`.
pub mod platform_state;

// Platform tests
#[cfg(test)]
mod tests;

// Re-exports for convenience
pub use capabilities::detect_capabilities;
pub use platform_state::{
    clear_battery_level, clear_thermal_state, current_platform_state,
    refresh_native_platform_state, set_battery_level, set_platform_state, set_thermal_state,
    PlatformState,
};
pub use profile::DeviceProfile;
pub use resource::{
    MemoryPressure, ResourceMonitor, ResourceSnapshot, ResourceSnapshotProvider,
    ResourceTelemetryMode, ResourceUsageSummary, RunGuard,
};
pub use types::{
    DetectionConfidence, DetectionSource, GpuType, HardwareCapabilities, NpuType, Platform,
    ThermalState,
};