Core, data, and cryptography

Keras-style hook interface for OA iterator sessions. Attach one or more callbacks to a session via its add_callback method. All hooks receive a &dyn IteratorContext so callbacks stay decoupled from the concrete session type. Mapping from C++C++Rust onBegin(Iterator&)on_begin(&mut self, ctx) onStep(Iterator&)on_step(&mut self, ctx) onEnd(Iterator&)on_end(&mut self, ctx) C++ used virtual inheritance; Rust uses dynamic dispatch through Box<dyn Callback>. The C++ move-constructor convention maps to Rust’s normal ownership — place Box<dyn Callback> values in a Vec rather than raw pointers.

Ordered list of Callback objects attached to a session. Callbacks fire in insertion order. This mirrors oa::Iterator::addCallback but is an explicit value rather than a virtual base member so the concrete session type can own it directly.

Shared checkpoint-save configuration. Used as a building block in CLI configs and passed to crate::ml::training::CbCheckpoint.

Command-line configuration with YAML + argv precedence. Type parameter C is any config struct that implements Default. Defaults are the base layer; a YAML file loaded via -c/--config overrides them; explicit argv flags override those. YAML support YAML loading is the caller’s responsibility. Pass a loader closure to Cli::parse_args_with_yaml to apply YAML fields before argv parsing when a -c/--config path is present.

Four-component RGBA color used by UI, plotting, overlays, and ordinary normalized render colors.

UTC human-readable date/time. For log display and file naming only — never for consensus or deterministic math.

Single-source environment-variable reader for OA runtime knobs.

Error returned by fallible OA operations. Backend and dependency errors are retained as sources without exposing their concrete types through OA’s public API.

Stateless host-filesystem operations. All methods are free functions on &Path. There is no instance state. Matches the surface of oa::Filesystem in C++ and its Python bindings so that cross-language code reads identically: ⓘFilesystem::create_directories(output.parent().unwrap())?; let text = Filesystem::read_text(&config_path)?;

Object-safe view of an iterator’s current state, passed to every Callback hook. The concrete iterator (e.g. TrainingLoop) implements this privately; the callback only needs the interface.

Shared logging configuration. Used as a building block in CLI configs and passed to crate::runtime::LogOptions or crate::LogMetrics.

Structured JSONL scalar-metrics sink. Thread-safe: log_scalar and flush serialize through an internal mutex. The open flag is an atomic for cheap is_open checks on the hot path.

Read-only whole-file mapping with RAII lifetime. Port provenance: oa::MappedFile.

Device-visible numeric storage with explicit shape and dtype semantics. Arithmetic operators delegate to crate::matrix and return Result<Matrix>: use let sum = (&left + &right)?;. They preserve validation, allocation, and recording failures without panicking. Multiplication is elementwise; use crate::matrix::mat_mul_nt for matrix multiplication.

Ordered schema declaration for one operation attribute.

Logical value effects of an operation.

Stable semantic contract for one operation before backend lowering. Generated operation registries own these descriptors. The builder-style const methods are public so generated code remains ordinary inspectable Rust rather than a private binary table.

An owned OA path value. Wraps std::path::PathBuf and adds the canonical OA named-location resolvers as associated functions. All std::fs calls and crate::Filesystem methods accept &oa::Path directly through Deref. ⓘlet wav = oa::Path::asset_rel("audio/oaNarration.wav"); let out = oa::Path::var_rel("example/audio/out.wav"); let ckpt = oa::Path::temp().join("model.oam");

Rolling-window performance statistics. No GPU dependency; pure CPU value struct.

Result returned by fallible OA operations.

RAII scoped timer. Borrows a f64 and writes elapsed seconds on drop. ⓘlet mut elapsed = 0.0_f64; { let _t = oa::ScopedTimer::new(&mut elapsed); expensive_work(); } println!("took {elapsed:.3}s");

Accumulating stopwatch. ⓘlet mut sw = oa::Stopwatch::new(); sw.start(); // ... work ... sw.stop(); println!("{:.3}ms", sw.elapsed_ms());

Nanosecond-precision monotonic timestamp. Internally stores nanoseconds elapsed since an arbitrary monotonic origin. Two Timestamp values from the same process can be subtracted; the result is meaningful as a Duration. Do not compare values across processes.

Semantic local spatial transform value. Stores translation + unit-quaternion rotation + per-axis scale + optional dimensionless row-basis shear (XY, XZ, YZ). All constructed values are finite; operations that would produce a non-finite result leave the value unchanged and return an error. Donor: oa::Transform.

Global validation controller. Port provenance: oa::Validation.

Keras-style hook interface for OA iterator sessions. Attach one or more callbacks to a session via its add_callback method. All hooks receive a &dyn IteratorContext so callbacks stay decoupled from the concrete session type. Mapping from C++C++Rust onBegin(Iterator&)on_begin(&mut self, ctx) onStep(Iterator&)on_step(&mut self, ctx) onEnd(Iterator&)on_end(&mut self, ctx) C++ used virtual inheritance; Rust uses dynamic dispatch through Box<dyn Callback>. The C++ move-constructor convention maps to Rust’s normal ownership — place Box<dyn Callback> values in a Vec rather than raw pointers.

Ordered list of Callback objects attached to a session. Callbacks fire in insertion order. This mirrors oa::Iterator::addCallback but is an explicit value rather than a virtual base member so the concrete session type can own it directly.

Shared checkpoint-save configuration. Used as a building block in CLI configs and passed to crate::ml::training::CbCheckpoint.

Command-line configuration with YAML + argv precedence. Type parameter C is any config struct that implements Default. Defaults are the base layer; a YAML file loaded via -c/--config overrides them; explicit argv flags override those. YAML support YAML loading is the caller’s responsibility. Pass a loader closure to Cli::parse_args_with_yaml to apply YAML fields before argv parsing when a -c/--config path is present.

Four-component RGBA color used by UI, plotting, overlays, and ordinary normalized render colors.