Struct ContextElement 

pub struct ContextElement {

    pub id: String,
    pub label: Option<String>,
    pub description: Option<String>,
    pub element_type: String,
    pub value: Option<String>,
    pub bounds: Option<Bounds>,
    pub state: ElementState,
    pub parent_id: Option<String>,
    pub actions: Vec<String>,
    pub confidence: f64,
    pub source: ContextSource,
    pub content_role: ContentRole,
    pub properties: HashMap<String, String>,
}

A single UI element in the unified context model.

Fields

id: String

Unique identifier for this element.

label: Option<String>

Human-readable label.

description: Option<String>

Accessibility description (tooltip / secondary label).

element_type: String

Element type (button, input, text, etc.).

value: Option<String>

Current value (for inputs, dropdowns, etc.).

bounds: Option<Bounds>

Screen-space bounding rectangle.

state: ElementState

Current state flags (from accessibility tree). Defaults to all-false for sources that don’t provide state (e.g., vision).

parent_id: Option<String>

ID of the parent element (None for root elements).

actions: Vec<String>

Available actions (from AT-SPI2 Action interface): “click”, “press”, “activate”, etc.

confidence: f64

Confidence score (0.0 - 1.0).

source: ContextSource

Which context source provided this element.

content_role: ContentRole

Content role for prompt injection defense. Classifies elements as Interactive (safe to act on), Content (untrusted text), Decorative (deprioritize), or System (chrome UI).

properties: HashMap<String, String>

Extended properties from the accessibility or native API. Keys: “placeholder”, “url”, “required”, “invalid”, “role_desc”, “selected_text”, “dom_id”, “document”, “filename”, “min_value”, “max_value”, “has_popup”, “column_count”, “row_count”, “loading_progress”

Implementations

impl ContextElement

pub fn to_reference( &self, screen_width: u32, screen_height: u32, ) -> ContextReference

Build a resilient reference from this element’s current data. screen_width and screen_height are used to compute normalized coordinates.

pub fn to_reference_in_context( &self, screen_width: u32, screen_height: u32, all_elements: &[ContextElement], ) -> ContextReference

Build a resilient reference with ancestor path context. all_elements is the flattened element list from the ContextSnapshot.

Trait Implementations

impl Clone for ContextElement

fn clone(&self) -> ContextElement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextElement

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextElement

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ContextElement

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

where __S: Serializer,

Serialize this value into the given Serde serializer.