Enum OuterObjectiveErrorSource 

pub enum OuterObjectiveErrorSource {
    Estimation(Box<EstimationError>),
    Objective(ObjectiveEvalError),
}

The exact error thrown across a fatal outer-objective boundary.

Outer orchestration receives failures through two APIs. Direct evaluators return EstimationError, while optimizer-facing evaluators return opt::ObjectiveEvalError, which owns both the producer’s recoverable/fatal verdict and (when available) its typed source. Flattening the latter through into_message() and minting a fresh RemlOptimizationFailed destroys that source precisely where terminal classification and FFI dispatch need it.

This enum is the single owner of that distinction. The recursive EstimationError arm is boxed for a finite representation; the optimizer arm is retained whole, including its source chain and producer verdict.

Variants

Estimation(Box<EstimationError>)

Objective(ObjectiveEvalError)

Implementations

impl OuterObjectiveErrorSource

pub fn estimation_error(&self) -> Option<&EstimationError>

Recover an engine error without inspecting rendered prose.

ObjectiveEvalError sources created by gam’s objective bridge carry the originating EstimationError directly. A source owned by another optimizer client remains typed as that client’s error and correctly returns None.

pub fn objective_error(&self) -> Option<&ObjectiveEvalError>

The optimizer-facing error, when this boundary was crossed through opt.

Trait Implementations

impl Debug for OuterObjectiveErrorSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for OuterObjectiveErrorSource

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for OuterObjectiveErrorSource

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.