car-browser 0.15.0

Browser automation and perception pipeline for Common Agent Runtime
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
74
75
76
77
78
79
80
81

//! UiMap formatting for LLM prompt consumption.
//!
//! Provides configurable formatters that serialize UiMap data into compact
//! text that fits within token budgets.

use super::ui_map::UiMap;

/// Configurable UiMap formatter.
pub struct UiMapFormatter {
    /// Maximum elements to include.
    pub max_elements: usize,
    /// Whether to include bounds coordinates.
    pub include_bounds: bool,
    /// Whether to include state flags.
    pub include_states: bool,
    /// Whether to only show interactive elements.
    pub interactive_only: bool,
    /// Maximum name length before truncation.
    pub max_name_length: usize,
}

impl UiMapFormatter {
    /// Default formatter.
    pub fn new() -> Self {
        Self {
            max_elements: 100,
            include_bounds: true,
            include_states: true,
            interactive_only: false,
            max_name_length: 50,
        }
    }

    /// Compact formatter for token-constrained contexts.
    pub fn compact() -> Self {
        Self {
            max_elements: 40,
            include_bounds: true,
            include_states: true,
            interactive_only: true,
            max_name_length: 30,
        }
    }

    /// Format a UiMap to text.
    pub fn format(&self, ui_map: &UiMap) -> String {
        // Delegate to UiMap's format_compact for now — more modes can be added
        // based on formatter configuration
        if self.interactive_only && ui_map.elements.len() > self.max_elements {
            let mut output = String::new();
            let elements = ui_map.interactive_elements();
            for element in elements.iter().take(self.max_elements) {
                use std::fmt::Write;
                let role_str = element.role.to_hash_string();
                let name_str = element
                    .name
                    .as_deref()
                    .map(|n| {
                        if n.len() > self.max_name_length {
                            let truncated: String =
                                n.chars().take(self.max_name_length - 3).collect();
                            format!(" \"{}...\"", truncated)
                        } else {
                            format!(" \"{}\"", n)
                        }
                    })
                    .unwrap_or_default();
                let _ = writeln!(output, "[{}] {}{}", element.id, role_str, name_str);
            }
            output
        } else {
            ui_map.format_compact()
        }
    }
}

impl Default for UiMapFormatter {
    fn default() -> Self {
        Self::new()
    }
}