Struct UncertaintyReport 

pub struct UncertaintyReport {
    pub level: String,
    pub score: f64,
    pub reasons: Vec<UncertaintyReason>,
    pub recommended_action: String,
    pub recovery_suggestions: Vec<RecoverySuggestion>,
    pub exact_symbol_match: bool,
    pub sources: UncertaintySourceBreakdown,
}

Machine-readable uncertainty rollup.

Always emitted — even when level is “low”, so dashboards can rely on structural consistency without null-checking.

Fields

level: String

Aggregated uncertainty level: “low” | “medium” | “high” | “critical”.

score: f64

Normalised uncertainty score [0.0, 1.0] (0 = certain, 1 = completely uncertain).

reasons: Vec<UncertaintyReason>

Structured reasons, sorted by weight descending.

recommended_action: String

Single most-actionable recommendation for the agent. Values: “none” | “narrow_query” | “add_domain_term” | “check_index_coverage” | “broaden_query”

recovery_suggestions: Vec<RecoverySuggestion>

Recovery quality metrics: one entry per scoped suggestion.

exact_symbol_match: bool

True when the query is an exact match for a known indexed symbol name.

When true, the level is capped at “medium” regardless of ambiguity signals — because the agent typed the exact name they want and ASD knows that symbol.

sources: UncertaintySourceBreakdown

Per-source uncertainty breakdown: query / db_state / result_set.

Lets agents target the right fix (refine query, annotate more, broaden scope) instead of responding generically to a high uncertainty level.

Implementations

impl UncertaintyReport

pub fn to_json(&self) -> Value

Trait Implementations

impl Clone for UncertaintyReport

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UncertaintyReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UncertaintyReport

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UncertaintyReport

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.