Struct BrowserTab 

pub struct BrowserTab {
    pub current_url: Option<String>,
    /* private fields */
}

Fields

current_url: Option<String>

Implementations

impl BrowserTab

pub fn new() -> Result<Self>

pub fn builder() -> BrowserBuilder

pub fn with_profile(profile: DeviceProfile) -> Result<Self>

Examples found in repository

examples/screenshot_demo.rs (line 10)

async fn main() -> Result<()> {
    println!(">>> Testing Pure-Rust Vector SVG & Wireframe Screenshot Rendering...");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    tab.navigate("https://news.ycombinator.com/").await?;

    let shot = tab.screenshot().expect("Expected screenshot");
    println!("  * Dimensions: {}x{}", shot.width, shot.height);
    println!("  * Elements Rendered: {}", shot.element_count);
    println!("  * SVG Payload Size: {} bytes", shot.svg.len());

    // Save SVG file
    fs::write("screenshot.svg", &shot.svg)?;
    println!("  * Saved screenshot to 'screenshot.svg'");

    // Print text wireframe preview
    println!("\n>>> ASCII WIREFRAME PREVIEW (FOR AGENT VISION TOKENS):");
    let preview: String = shot
        .layout_wireframe
        .lines()
        .take(18)
        .collect::<Vec<_>>()
        .join("\n");
    println!("{}", preview);

    Ok(())
}

examples/scrape_to_markdown.rs (line 8)

async fn main() -> Result<()> {
    println!(">>> Launching Headless Engine Tab with Windows Chrome profile...");
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    let url = "https://en.wikipedia.org/wiki/Rust_(programming_language)";
    println!(">>> Navigating to: {}", url);
    let report = tab.navigate(url).await?;

    println!(">>> Page Title: {}", report.page_title);
    println!(">>> Raw HTML Size: {} bytes", report.html_bytes);

    let markdown = tab.extract_markdown(None).unwrap_or_default();
    println!(
        ">>> Markdown Size: {} bytes (~{:.1}% compression)",
        markdown.len(),
        (1.0 - (markdown.len() as f64 / report.html_bytes as f64)) * 100.0
    );

    println!("\n--- MARKDOWN PREVIEW (First 600 chars) ---\n");
    let preview: String = markdown.chars().take(600).collect();
    println!("{}", preview);
    println!("\n-------------------------------------------");

    Ok(())
}

examples/test_search_modes.rs (line 7)

async fn main() -> Result<()> {
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    let urls = [
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents&gbv=1",
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents&udm=14",
        "https://www.google.com/search?q=Rust+programming+language&udm=14",
        "https://html.duckduckgo.com/html/?q=headless+browser+rust+engine+for+ai+agents",
    ];

    for url in urls {
        println!("\n========================================");
        println!("Testing URL: {}", url);
        let nav = tab.navigate(url).await?;
        println!("Status: {}", nav.status);
        println!("Title:  {}", nav.page_title);
        println!("Bytes:  {}", nav.html_bytes);
        let md = tab.extract_markdown(None).unwrap_or_default();
        println!("MD Len: {} bytes", md.len());
        println!("Preview:\n{}", md.chars().take(300).collect::<String>());
    }

    Ok(())
}

examples/test_google_markdown_fix.rs (line 16)

async fn main() -> Result<()> {
    println!(">>> Testing Google Search Distilled Markdown Extraction...");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let url = "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!("  -> Navigating to: {}", url);
    let nav = tab.navigate(url).await?;

    println!("  -> Status:       {}", nav.status);
    println!("  -> Final URL:    {}", nav.final_url);
    println!("  -> Page Title:   {}", nav.page_title);
    println!("  -> HTML Payload: {} bytes", nav.html_bytes);

    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Extracted Markdown Size: {} bytes", md.len());

    fs::write(evidence_dir.join("google_normal_search_distilled.md"), &md)?;
    fs::write(artifact_dir.join("google_normal_search_distilled.md"), &md)?;

    println!("\n>>> DISTILLED GOOGLE SEARCH MARKDOWN:\n");
    println!("{}", md);

    Ok(())
}

examples/test_all_31_google_capabilities.rs (line 13)

async fn main() -> anyhow::Result<()> {
    println!("Testing all 31 Google/YouTube Capabilities...");
    let evidence_dir = Path::new("evidence");
    if !evidence_dir.exists() {
        fs::create_dir_all(evidence_dir)?;
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Test a subset so it doesn't take forever, or just do the 5 most important ones to verify parsing
    println!("1. Testing google_search...");
    let res = tab
        .google_search("headless browser pure rust engine")
        .await?;
    fs::write(
        evidence_dir.join("test_google_search.md"),
        res.to_markdown(),
    )?;

    println!("2. Testing youtube_search...");
    let res = tab.youtube_search("rust programming").await?;
    fs::write(
        evidence_dir.join("test_youtube_search.md"),
        res.to_markdown(),
    )?;

    println!("3. Testing google_ai_mode...");
    let res = tab.google_ai_mode("explain quantum computing").await?;
    fs::write(
        evidence_dir.join("test_google_ai_mode.md"),
        res.to_markdown(),
    )?;

    println!("4. Testing google_autocomplete...");
    let res = tab.google_autocomplete("rust").await?;
    fs::write(
        evidence_dir.join("test_google_autocomplete.md"),
        res.to_markdown(),
    )?;

    println!("Capabilities listed:");
    for cap in tab.google_capabilities() {
        println!(" - {}", cap);
    }

    println!("All tests completed. Output saved to evidence/");
    Ok(())
}

examples/test_html_css_rendering.rs (line 12)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TESTING REAL HTML/CSS LAYOUT & PAINT ENGINE (PURE RUST, ZERO CHROMIUM)");
    println!("================================================================================\n");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // 1. Test Wikipedia
    let url = "https://en.wikipedia.org/wiki/Rust_(programming_language)";
    println!("[1] Navigating to: {}", url);
    let report = tab.navigate(url).await?;
    println!("  * Title: {}", report.page_title);
    println!("  * HTML Size: {} bytes", report.html_bytes);

    println!("[2] Performing Real HTML/CSS Layout Pass & Rasterizing to PNG...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  * Resolution: {}x{}", shot.width, shot.height);
    println!("  * Real PNG Size: {} bytes", shot.png_bytes.len());
    println!("  * Base64 Data URL Prefix: {}...", &shot.png_base64[..50]);

    fs::write("wikipedia_screenshot.png", &shot.png_bytes)?;
    println!("  -> Successfully wrote real binary image: 'wikipedia_screenshot.png'");

    println!("\n================================================================================");
    println!(">>> REAL HTML/CSS LAYOUT & PAINT PASSED WITH ZERO CHROMIUM (<30MB RAM)!");
    println!("================================================================================");

    Ok(())
}

Additional examples can be found in:

• examples/test_youtube_screenshot.rs
• examples/autonomous_agent_loop.rs
• examples/test_default_google_search.rs
• examples/capture_perfect_screenshots.rs
• examples/test_real_thumbnail_screenshot.rs
• examples/agentic_chatgpt_prompt_execution.rs
• examples/demonstrate_all_features.rs
• examples/test_chatgpt_and_google.rs

pub fn from_network(network: NetworkClient) -> Result<Self>

pub fn profile(&self) -> DeviceProfile

pub fn set_profile(&mut self, profile: DeviceProfile) -> Result<()>

pub async fn navigate(&mut self, url: &str) -> Result<NavigationReport>

Examples found in repository

examples/screenshot_demo.rs (line 11)

async fn main() -> Result<()> {
    println!(">>> Testing Pure-Rust Vector SVG & Wireframe Screenshot Rendering...");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    tab.navigate("https://news.ycombinator.com/").await?;

    let shot = tab.screenshot().expect("Expected screenshot");
    println!("  * Dimensions: {}x{}", shot.width, shot.height);
    println!("  * Elements Rendered: {}", shot.element_count);
    println!("  * SVG Payload Size: {} bytes", shot.svg.len());

    // Save SVG file
    fs::write("screenshot.svg", &shot.svg)?;
    println!("  * Saved screenshot to 'screenshot.svg'");

    // Print text wireframe preview
    println!("\n>>> ASCII WIREFRAME PREVIEW (FOR AGENT VISION TOKENS):");
    let preview: String = shot
        .layout_wireframe
        .lines()
        .take(18)
        .collect::<Vec<_>>()
        .join("\n");
    println!("{}", preview);

    Ok(())
}

examples/scrape_to_markdown.rs (line 12)

async fn main() -> Result<()> {
    println!(">>> Launching Headless Engine Tab with Windows Chrome profile...");
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    let url = "https://en.wikipedia.org/wiki/Rust_(programming_language)";
    println!(">>> Navigating to: {}", url);
    let report = tab.navigate(url).await?;

    println!(">>> Page Title: {}", report.page_title);
    println!(">>> Raw HTML Size: {} bytes", report.html_bytes);

    let markdown = tab.extract_markdown(None).unwrap_or_default();
    println!(
        ">>> Markdown Size: {} bytes (~{:.1}% compression)",
        markdown.len(),
        (1.0 - (markdown.len() as f64 / report.html_bytes as f64)) * 100.0
    );

    println!("\n--- MARKDOWN PREVIEW (First 600 chars) ---\n");
    let preview: String = markdown.chars().take(600).collect();
    println!("{}", preview);
    println!("\n-------------------------------------------");

    Ok(())
}

examples/test_search_modes.rs (line 19)

async fn main() -> Result<()> {
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    let urls = [
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents&gbv=1",
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents&udm=14",
        "https://www.google.com/search?q=Rust+programming+language&udm=14",
        "https://html.duckduckgo.com/html/?q=headless+browser+rust+engine+for+ai+agents",
    ];

    for url in urls {
        println!("\n========================================");
        println!("Testing URL: {}", url);
        let nav = tab.navigate(url).await?;
        println!("Status: {}", nav.status);
        println!("Title:  {}", nav.page_title);
        println!("Bytes:  {}", nav.html_bytes);
        let md = tab.extract_markdown(None).unwrap_or_default();
        println!("MD Len: {} bytes", md.len());
        println!("Preview:\n{}", md.chars().take(300).collect::<String>());
    }

    Ok(())
}

examples/test_google_markdown_fix.rs (line 19)

async fn main() -> Result<()> {
    println!(">>> Testing Google Search Distilled Markdown Extraction...");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let url = "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!("  -> Navigating to: {}", url);
    let nav = tab.navigate(url).await?;

    println!("  -> Status:       {}", nav.status);
    println!("  -> Final URL:    {}", nav.final_url);
    println!("  -> Page Title:   {}", nav.page_title);
    println!("  -> HTML Payload: {} bytes", nav.html_bytes);

    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Extracted Markdown Size: {} bytes", md.len());

    fs::write(evidence_dir.join("google_normal_search_distilled.md"), &md)?;
    fs::write(artifact_dir.join("google_normal_search_distilled.md"), &md)?;

    println!("\n>>> DISTILLED GOOGLE SEARCH MARKDOWN:\n");
    println!("{}", md);

    Ok(())
}

examples/test_html_css_rendering.rs (line 17)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TESTING REAL HTML/CSS LAYOUT & PAINT ENGINE (PURE RUST, ZERO CHROMIUM)");
    println!("================================================================================\n");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // 1. Test Wikipedia
    let url = "https://en.wikipedia.org/wiki/Rust_(programming_language)";
    println!("[1] Navigating to: {}", url);
    let report = tab.navigate(url).await?;
    println!("  * Title: {}", report.page_title);
    println!("  * HTML Size: {} bytes", report.html_bytes);

    println!("[2] Performing Real HTML/CSS Layout Pass & Rasterizing to PNG...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  * Resolution: {}x{}", shot.width, shot.height);
    println!("  * Real PNG Size: {} bytes", shot.png_bytes.len());
    println!("  * Base64 Data URL Prefix: {}...", &shot.png_base64[..50]);

    fs::write("wikipedia_screenshot.png", &shot.png_bytes)?;
    println!("  -> Successfully wrote real binary image: 'wikipedia_screenshot.png'");

    println!("\n================================================================================");
    println!(">>> REAL HTML/CSS LAYOUT & PAINT PASSED WITH ZERO CHROMIUM (<30MB RAM)!");
    println!("================================================================================");

    Ok(())
}

examples/multitab_concurrent.rs (line 24)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> MULTI-TAB CONCURRENT ENGINE DEMO (<50MB RAM)");
    println!("================================================================================\n");

    let mut engine = BrowserEngine::new()?;

    // Create 3 isolated tabs with different device profiles
    let tab1_id = engine.create_tab(Some(DeviceProfile::ChromeWindows))?;
    let tab2_id = engine.create_tab(Some(DeviceProfile::SafariMac))?;
    let tab3_id = engine.create_tab(Some(DeviceProfile::SafariIos))?;

    println!("Created tabs: {}, {}, {}", tab1_id, tab2_id, tab3_id);

    println!("[Tab 1: Chrome Windows] Navigating to Wikipedia...");
    let r1 = engine
        .get_tab_mut(&tab1_id)
        .unwrap()
        .navigate("https://en.wikipedia.org/wiki/Artificial_intelligence")
        .await?;
    println!("  -> Tab 1 Title: {}", r1.page_title);

    println!("[Tab 2: Safari Mac] Navigating to Hacker News...");
    let r2 = engine
        .get_tab_mut(&tab2_id)
        .unwrap()
        .navigate("https://news.ycombinator.com/")
        .await?;
    println!("  -> Tab 2 Title: {}", r2.page_title);

    println!("[Tab 3: iPhone iOS] Navigating to GitHub Explore...");
    let r3 = engine
        .get_tab_mut(&tab3_id)
        .unwrap()
        .navigate("https://github.com/trending")
        .await?;
    println!("  -> Tab 3 Title: {}", r3.page_title);

    println!("\n>>> Active Tabs List:");
    for tab_info in engine.list_tabs() {
        println!(
            "  - ID: {:<8} Profile: {:<15} URL: {:?}",
            tab_info.id,
            format!("{:?}", tab_info.profile),
            tab_info.url
        );
    }

    println!("\n>>> Closing Tab 2...");
    engine.close_tab(&tab2_id);
    println!("Remaining tabs count: {}", engine.list_tabs().len());

    Ok(())
}

Additional examples can be found in:

• examples/test_youtube_screenshot.rs
• examples/autonomous_agent_loop.rs
• examples/capture_perfect_screenshots.rs
• examples/test_real_thumbnail_screenshot.rs
• examples/agentic_chatgpt_prompt_execution.rs
• examples/demonstrate_all_features.rs
• examples/test_chatgpt_and_google.rs

pub async fn search(&mut self, query: &str) -> Result<NavigationReport>

Default Google Search with automated query encoding and mode routing

Examples found in repository

examples/test_default_google_search.rs (line 26)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TESTING GOOGLE AS DEFAULT SEARCH ENGINE (PURE RUST)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // 1. Default Google Search
    let query = "headless browser pure rust engine for AI agents";
    println!(
        "[1/2] Executing default search: tab.search(\"{}\")...",
        query
    );
    let nav = tab.search(query).await?;
    println!("  -> Final URL:     {}", nav.final_url);
    println!("  -> Page Title:    {}", nav.page_title);
    println!("  -> Status:        {}", nav.status);
    println!("  -> HTML Payload:  {} bytes", nav.html_bytes);

    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());

    fs::write(evidence_dir.join("google_normal_search_distilled.md"), &md)?;
    fs::write(artifact_dir.join("google_normal_search_distilled.md"), &md)?;

    println!("\n>>> DISTILLED GOOGLE SEARCH MARKDOWN:\n--------------------------------------------------------------------------------");
    println!("{}", md);
    println!("--------------------------------------------------------------------------------");

    // 2. Google AI Mode Search
    let ai_query = "Rust programming language concurrency patterns";
    println!(
        "\n[2/2] Executing Google AI Mode search: tab.search_google(\"{}\", Some(\"ai\"))...",
        ai_query
    );
    let ai_nav = tab.search_google(ai_query, Some("ai")).await?;
    println!("  -> Final URL:     {}", ai_nav.final_url);
    println!("  -> Page Title:    {}", ai_nav.page_title);
    println!("  -> HTML Payload:  {} bytes", ai_nav.html_bytes);

    let ai_md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", ai_md.len());

    fs::write(evidence_dir.join("google_aimode_distilled.md"), &ai_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &ai_md)?;

    println!("\n>>> DISTILLED GOOGLE AI MODE MARKDOWN:\n--------------------------------------------------------------------------------");
    println!("{}", ai_md);
    println!("--------------------------------------------------------------------------------");

    println!("\n================================================================================");
    println!(">>> GOOGLE DEFAULT SEARCH ENGINE VERIFICATION COMPLETE!");
    println!("================================================================================");

    Ok(())
}

pub async fn search_google( &mut self, query: &str, mode: Option<&str>, ) -> Result<NavigationReport>

Search Google with specific query modes (e.g. “ai” for udm=50, “web” for udm=14, “images” for udm=2, “news”)

Examples found in repository

examples/test_default_google_search.rs (line 48)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TESTING GOOGLE AS DEFAULT SEARCH ENGINE (PURE RUST)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // 1. Default Google Search
    let query = "headless browser pure rust engine for AI agents";
    println!(
        "[1/2] Executing default search: tab.search(\"{}\")...",
        query
    );
    let nav = tab.search(query).await?;
    println!("  -> Final URL:     {}", nav.final_url);
    println!("  -> Page Title:    {}", nav.page_title);
    println!("  -> Status:        {}", nav.status);
    println!("  -> HTML Payload:  {} bytes", nav.html_bytes);

    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());

    fs::write(evidence_dir.join("google_normal_search_distilled.md"), &md)?;
    fs::write(artifact_dir.join("google_normal_search_distilled.md"), &md)?;

    println!("\n>>> DISTILLED GOOGLE SEARCH MARKDOWN:\n--------------------------------------------------------------------------------");
    println!("{}", md);
    println!("--------------------------------------------------------------------------------");

    // 2. Google AI Mode Search
    let ai_query = "Rust programming language concurrency patterns";
    println!(
        "\n[2/2] Executing Google AI Mode search: tab.search_google(\"{}\", Some(\"ai\"))...",
        ai_query
    );
    let ai_nav = tab.search_google(ai_query, Some("ai")).await?;
    println!("  -> Final URL:     {}", ai_nav.final_url);
    println!("  -> Page Title:    {}", ai_nav.page_title);
    println!("  -> HTML Payload:  {} bytes", ai_nav.html_bytes);

    let ai_md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", ai_md.len());

    fs::write(evidence_dir.join("google_aimode_distilled.md"), &ai_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &ai_md)?;

    println!("\n>>> DISTILLED GOOGLE AI MODE MARKDOWN:\n--------------------------------------------------------------------------------");
    println!("{}", ai_md);
    println!("--------------------------------------------------------------------------------");

    println!("\n================================================================================");
    println!(">>> GOOGLE DEFAULT SEARCH ENGINE VERIFICATION COMPLETE!");
    println!("================================================================================");

    Ok(())
}

pub async fn google_search(&mut self, query: &str) -> Result<GoogleSearchResult>

Examples found in repository

examples/test_all_31_google_capabilities.rs (line 18)

async fn main() -> anyhow::Result<()> {
    println!("Testing all 31 Google/YouTube Capabilities...");
    let evidence_dir = Path::new("evidence");
    if !evidence_dir.exists() {
        fs::create_dir_all(evidence_dir)?;
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Test a subset so it doesn't take forever, or just do the 5 most important ones to verify parsing
    println!("1. Testing google_search...");
    let res = tab
        .google_search("headless browser pure rust engine")
        .await?;
    fs::write(
        evidence_dir.join("test_google_search.md"),
        res.to_markdown(),
    )?;

    println!("2. Testing youtube_search...");
    let res = tab.youtube_search("rust programming").await?;
    fs::write(
        evidence_dir.join("test_youtube_search.md"),
        res.to_markdown(),
    )?;

    println!("3. Testing google_ai_mode...");
    let res = tab.google_ai_mode("explain quantum computing").await?;
    fs::write(
        evidence_dir.join("test_google_ai_mode.md"),
        res.to_markdown(),
    )?;

    println!("4. Testing google_autocomplete...");
    let res = tab.google_autocomplete("rust").await?;
    fs::write(
        evidence_dir.join("test_google_autocomplete.md"),
        res.to_markdown(),
    )?;

    println!("Capabilities listed:");
    for cap in tab.google_capabilities() {
        println!(" - {}", cap);
    }

    println!("All tests completed. Output saved to evidence/");
    Ok(())
}

pub async fn google_web_search( &mut self, query: &str, ) -> Result<GoogleSearchResult>

pub async fn google_image_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_video_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_short_video_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_news_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_forum_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_shopping_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_product_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_books_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_autocomplete( &mut self, query: &str, ) -> Result<GoogleAutocompleteResult>

Examples found in repository

examples/test_all_31_google_capabilities.rs (line 40)

async fn main() -> anyhow::Result<()> {
    println!("Testing all 31 Google/YouTube Capabilities...");
    let evidence_dir = Path::new("evidence");
    if !evidence_dir.exists() {
        fs::create_dir_all(evidence_dir)?;
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Test a subset so it doesn't take forever, or just do the 5 most important ones to verify parsing
    println!("1. Testing google_search...");
    let res = tab
        .google_search("headless browser pure rust engine")
        .await?;
    fs::write(
        evidence_dir.join("test_google_search.md"),
        res.to_markdown(),
    )?;

    println!("2. Testing youtube_search...");
    let res = tab.youtube_search("rust programming").await?;
    fs::write(
        evidence_dir.join("test_youtube_search.md"),
        res.to_markdown(),
    )?;

    println!("3. Testing google_ai_mode...");
    let res = tab.google_ai_mode("explain quantum computing").await?;
    fs::write(
        evidence_dir.join("test_google_ai_mode.md"),
        res.to_markdown(),
    )?;

    println!("4. Testing google_autocomplete...");
    let res = tab.google_autocomplete("rust").await?;
    fs::write(
        evidence_dir.join("test_google_autocomplete.md"),
        res.to_markdown(),
    )?;

    println!("Capabilities listed:");
    for cap in tab.google_capabilities() {
        println!(" - {}", cap);
    }

    println!("All tests completed. Output saved to evidence/");
    Ok(())
}

pub async fn google_ai_overview( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_ai_mode( &mut self, query: &str, ) -> Result<GenericGoogleResult>

Examples found in repository

examples/test_all_31_google_capabilities.rs (line 33)

async fn main() -> anyhow::Result<()> {
    println!("Testing all 31 Google/YouTube Capabilities...");
    let evidence_dir = Path::new("evidence");
    if !evidence_dir.exists() {
        fs::create_dir_all(evidence_dir)?;
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Test a subset so it doesn't take forever, or just do the 5 most important ones to verify parsing
    println!("1. Testing google_search...");
    let res = tab
        .google_search("headless browser pure rust engine")
        .await?;
    fs::write(
        evidence_dir.join("test_google_search.md"),
        res.to_markdown(),
    )?;

    println!("2. Testing youtube_search...");
    let res = tab.youtube_search("rust programming").await?;
    fs::write(
        evidence_dir.join("test_youtube_search.md"),
        res.to_markdown(),
    )?;

    println!("3. Testing google_ai_mode...");
    let res = tab.google_ai_mode("explain quantum computing").await?;
    fs::write(
        evidence_dir.join("test_google_ai_mode.md"),
        res.to_markdown(),
    )?;

    println!("4. Testing google_autocomplete...");
    let res = tab.google_autocomplete("rust").await?;
    fs::write(
        evidence_dir.join("test_google_autocomplete.md"),
        res.to_markdown(),
    )?;

    println!("Capabilities listed:");
    for cap in tab.google_capabilities() {
        println!(" - {}", cap);
    }

    println!("All tests completed. Output saved to evidence/");
    Ok(())
}

pub async fn google_scholar_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_patents_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_maps_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_finance_quote( &mut self, ticker: &str, ) -> Result<GenericGoogleResult>

pub async fn google_trends_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn google_flights_search( &mut self, origin: &str, dest: &str, ) -> Result<GenericGoogleResult>

pub async fn google_hotels_search( &mut self, location: &str, ) -> Result<GenericGoogleResult>

pub async fn google_travel_explore( &mut self, destination: &str, ) -> Result<GenericGoogleResult>

pub async fn youtube_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

Examples found in repository

examples/test_all_31_google_capabilities.rs (line 26)

async fn main() -> anyhow::Result<()> {
    println!("Testing all 31 Google/YouTube Capabilities...");
    let evidence_dir = Path::new("evidence");
    if !evidence_dir.exists() {
        fs::create_dir_all(evidence_dir)?;
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Test a subset so it doesn't take forever, or just do the 5 most important ones to verify parsing
    println!("1. Testing google_search...");
    let res = tab
        .google_search("headless browser pure rust engine")
        .await?;
    fs::write(
        evidence_dir.join("test_google_search.md"),
        res.to_markdown(),
    )?;

    println!("2. Testing youtube_search...");
    let res = tab.youtube_search("rust programming").await?;
    fs::write(
        evidence_dir.join("test_youtube_search.md"),
        res.to_markdown(),
    )?;

    println!("3. Testing google_ai_mode...");
    let res = tab.google_ai_mode("explain quantum computing").await?;
    fs::write(
        evidence_dir.join("test_google_ai_mode.md"),
        res.to_markdown(),
    )?;

    println!("4. Testing google_autocomplete...");
    let res = tab.google_autocomplete("rust").await?;
    fs::write(
        evidence_dir.join("test_google_autocomplete.md"),
        res.to_markdown(),
    )?;

    println!("Capabilities listed:");
    for cap in tab.google_capabilities() {
        println!(" - {}", cap);
    }

    println!("All tests completed. Output saved to evidence/");
    Ok(())
}

pub async fn youtube_shorts_search( &mut self, query: &str, ) -> Result<GenericGoogleResult>

pub async fn youtube_video( &mut self, video_id: &str, ) -> Result<GenericGoogleResult>

pub async fn youtube_channel( &mut self, channel: &str, ) -> Result<GenericGoogleResult>

pub async fn youtube_playlist( &mut self, playlist_id: &str, ) -> Result<GenericGoogleResult>

pub async fn google_lens_visual_matches( &mut self, image_url: &str, ) -> Result<GenericGoogleResult>

pub async fn google_lens_exact_matches( &mut self, image_url: &str, ) -> Result<GenericGoogleResult>

pub async fn google_lens_products( &mut self, image_url: &str, ) -> Result<GenericGoogleResult>

pub async fn google_lens_about_image( &mut self, image_url: &str, ) -> Result<GenericGoogleResult>

pub fn google_capabilities(&self) -> Vec<&'static str>

Examples found in repository

examples/test_all_31_google_capabilities.rs (line 47)

async fn main() -> anyhow::Result<()> {
    println!("Testing all 31 Google/YouTube Capabilities...");
    let evidence_dir = Path::new("evidence");
    if !evidence_dir.exists() {
        fs::create_dir_all(evidence_dir)?;
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Test a subset so it doesn't take forever, or just do the 5 most important ones to verify parsing
    println!("1. Testing google_search...");
    let res = tab
        .google_search("headless browser pure rust engine")
        .await?;
    fs::write(
        evidence_dir.join("test_google_search.md"),
        res.to_markdown(),
    )?;

    println!("2. Testing youtube_search...");
    let res = tab.youtube_search("rust programming").await?;
    fs::write(
        evidence_dir.join("test_youtube_search.md"),
        res.to_markdown(),
    )?;

    println!("3. Testing google_ai_mode...");
    let res = tab.google_ai_mode("explain quantum computing").await?;
    fs::write(
        evidence_dir.join("test_google_ai_mode.md"),
        res.to_markdown(),
    )?;

    println!("4. Testing google_autocomplete...");
    let res = tab.google_autocomplete("rust").await?;
    fs::write(
        evidence_dir.join("test_google_autocomplete.md"),
        res.to_markdown(),
    )?;

    println!("Capabilities listed:");
    for cap in tab.google_capabilities() {
        println!(" - {}", cap);
    }

    println!("All tests completed. Output saved to evidence/");
    Ok(())
}

pub fn set_content( &mut self, html: &str, url: Option<&str>, ) -> Result<NavigationReport>

pub fn observe(&self) -> Option<PageObservation>

Examples found in repository

examples/autonomous_agent_loop.rs (line 20)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> AI AGENTIC AUTONOMOUS BROWSING LOOP (PURE RUST)");
    println!("================================================================================\n");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation
    println!("[Step 1: Navigate] Agent navigating to Wikipedia Main Page...");
    tab.navigate("https://en.wikipedia.org/wiki/Main_Page")
        .await?;

    // Step 2: Observe
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for Agent LLM...");
    let obs = tab.observe().expect("Expected observation");
    println!("  * Page Title: {}", obs.title);
    println!(
        "  * Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample First 10 Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(10) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Action
    // Agent chooses to click the search input or a featured article
    if let Some(target_link) = obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "a" && e.text.contains("article"))
    {
        println!(
            "\n[Step 3: Act] Agent decides to click element [{}] (Text: \"{}\")...",
            target_link.index, target_link.text
        );
        let action_res = tab.act_click(&target_link.index.to_string()).await?;

        if let Some(report) = action_res {
            println!("  -> Navigated to: {}", report.final_url);
            println!("  -> New Page Title: {}", report.page_title);
        }
    }

    // Step 4: Extract LLM Knowledge
    println!("\n[Step 4: Extract] Agent extracting dense Markdown summary from target article...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  * Extracted Markdown Length: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT KNOWLEDGE PREVIEW:\n{}", preview);

    println!("\n================================================================================");
    println!(">>> AUTONOMOUS AGENT LOOP COMPLETED SEAMLESSLY!");
    println!("================================================================================");

    Ok(())
}

examples/agentic_chatgpt_prompt_execution.rs (line 39)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS-ENGINE: AGENTIC CHATGPT PROMPT & RESPONSE EXECUTION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation to ChatGPT
    let target_url = "https://chatgpt.com/";
    println!(
        "[Step 1: Navigate] Agent navigating with stealth fingerprint to {}...",
        target_url
    );
    let nav_report = tab.navigate(target_url).await?;
    println!("  -> HTTP Status:      {}", nav_report.status);
    println!("  -> Page Title:       {}", nav_report.page_title);
    println!("  -> CAPTCHA Detected: {}", nav_report.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", nav_report.html_bytes);

    // Step 2: Observe Action Tree
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for LLM Reasoning...");
    let obs = tab.observe().expect("Expected ChatGPT page observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(15) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Prompt Action
    // Agent chooses to trigger an AI prompt (either via prompt button like "What can you do?" or typing)
    let prompt_btn = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.text.contains("What can you do")
                || e.text.contains("Deep research")
                || e.text.contains("New chat")
        })
        .cloned();

    let (chosen_action, action_type) = if let Some(btn) = &prompt_btn {
        println!("\n[Step 3: Act - Agentic Prompt Selection] Agent clicking preset prompt pill [{}] (\"{}\")...", btn.index, btn.text);
        let click_res = tab.act_click(&btn.index.to_string()).await?;
        let status_desc = if let Some(rep) = click_res {
            format!("Navigated to {}", rep.final_url)
        } else {
            "Triggered prompt action via element click".to_string()
        };
        (status_desc, btn.text.clone())
    } else {
        println!("\n[Step 3: Act - Agentic Prompting] Dispatching prompt to ChatGPT input...");
        let type_status = tab
            .act_type("26", "Explain quantum computing in 2 simple sentences")
            .await?;
        (
            format!("Typed prompt into element [26]: {}", type_status),
            "Typed Prompt".to_string(),
        )
    };

    println!("  -> Action Execution Result: {}", chosen_action);

    // Step 4: Extract Conversation Response / Markdown
    println!("\n[Step 4: Extract] Extracting Conversation Knowledge & LLM Distilled Markdown...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT CONVERSATION MARKDOWN:\n{}", preview);

    // Step 5: Visual Screenshot Capture of the Conversation
    println!("\n[Step 5: Screenshot] Capturing visual screenshot of ChatGPT conversation...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!(
        "  -> Screenshot Resolution: {}x{} px",
        shot.width, shot.height
    );
    println!("  -> PNG Payload:          {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let png_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let md_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_conversation.md");
    let md_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_conversation.md");
    let json_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_trace.json");
    let json_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_trace.json");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
    }
    fs::write(&md_dest_evidence, &md)?;
    fs::write(&md_dest_artifact, &md)?;

    let trace_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "task": "Agentic ChatGPT Prompting & Response Extraction",
        "initial_url": target_url,
        "page_title": nav_report.page_title,
        "status": nav_report.status,
        "interactive_elements_indexed": obs.interactive_elements.len(),
        "prompt_action": {
            "type": action_type,
            "result": chosen_action
        },
        "extracted_markdown_bytes": md.len(),
        "screenshot_png_bytes": shot.png_bytes.len(),
        "status": "PASS"
    });

    fs::write(
        &json_dest_evidence,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;
    fs::write(
        &json_dest_artifact,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> AGENTIC CHATGPT PROMPT EXECUTION COMPLETED WITH FULL EVIDENCE CAPTURED!");
    println!("================================================================================");

    Ok(())
}

examples/demonstrate_all_features.rs (line 37)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS ENGINE: VERIFYING SCREENSHOT, MARKDOWN & AGENTIC NAVIGATION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // Initialize browser with stealth fingerprint
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // =========================================================================
    // 1. AGENTIC NAVIGATION FEATURE
    // =========================================================================
    println!("[1. AGENTIC NAVIGATION] Initial navigation to Wikipedia Portal...");
    let initial_url = "https://en.wikipedia.org/wiki/Portal:Current_events";
    let init_report = tab.navigate(initial_url).await?;
    println!("  -> Landed on: {}", init_report.requested_url);
    println!("  -> Page Title: {}", init_report.page_title);
    println!("  -> Status: {}", init_report.status);

    // Extract Agent Action Map / Observation Tree
    let obs = tab.observe().expect("Expected observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    // Agent decision: find an informative article link to click
    let selected_target = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.tag == "a"
                && e.text.len() > 15
                && !e.href.is_empty()
                && !e.href.contains("#")
                && !e.href.contains("Portal:")
        })
        .or_else(|| {
            obs.interactive_elements
                .iter()
                .find(|e| e.tag == "a" && e.text.contains("article"))
        })
        .or_else(|| obs.interactive_elements.first())
        .expect("No interactive link found");

    let clicked_index = selected_target.index;
    let clicked_text = selected_target.text.clone();
    let clicked_href = selected_target.href.clone();
    let clicked_selector = selected_target.selector.clone();

    println!("\n  [Agent Decision & Act]");
    println!("  -> Selected Element ID: [{}]", clicked_index);
    println!("  -> Element Selector:    {}", clicked_selector);
    println!("  -> Element Anchor Text: \"{}\"", clicked_text);
    println!("  -> Target URL:          {}", clicked_href);

    // Execute Autonomous Action Click via element index
    let nav_report = tab
        .act_click(&clicked_index.to_string())
        .await?
        .expect("Expected navigation report after click");

    println!("\n  [Agent Navigation Result]");
    println!("  -> Successfully Navigated to: {}", nav_report.final_url);
    println!("  -> New Page Title:            {}", nav_report.page_title);
    println!("  -> HTTP Status:               {}", nav_report.status);
    println!(
        "  -> HTML Payload Size:         {} bytes",
        nav_report.html_bytes
    );

    // Save Agent Action Map
    let sample_elements: Vec<_> = obs.interactive_elements.iter().take(20).cloned().collect();
    let agent_map_json = json!({
        "initial_page": {
            "url": initial_url,
            "title": init_report.page_title,
            "interactive_elements_count": obs.interactive_elements.len()
        },
        "agent_action": {
            "clicked_element_index": clicked_index,
            "anchor_text": clicked_text,
            "target_href": clicked_href,
            "selector": clicked_selector
        },
        "target_page": {
            "final_url": nav_report.final_url,
            "page_title": nav_report.page_title,
            "status": nav_report.status,
            "html_bytes": nav_report.html_bytes
        },
        "sample_indexed_elements": sample_elements
    });
    fs::write(
        evidence_dir.join("agentic_navigation_trace.json"),
        serde_json::to_string_pretty(&agent_map_json)?,
    )?;
    fs::write(
        artifact_dir.join("agentic_navigation_trace.json"),
        serde_json::to_string_pretty(&agent_map_json)?,
    )?;

    // =========================================================================
    // 2. SCREENSHOT FEATURE
    // =========================================================================
    println!(
        "\n[2. SCREENSHOT FEATURE] Capturing high-resolution visual screenshot & vector SVG..."
    );
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  -> Dimensions:        {}x{} px", shot.width, shot.height);
    println!("  -> Elements Rendered: {}", shot.element_count);
    println!("  -> SVG Size:          {} bytes", shot.svg.len());
    println!("  -> PNG Bytes:         {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("demonstration_screenshot.png");
    let png_dest_artifact = artifact_dir.join("demonstration_screenshot.png");
    let svg_dest_evidence = evidence_dir.join("demonstration_screenshot.svg");
    let svg_dest_artifact = artifact_dir.join("demonstration_screenshot.svg");
    let wireframe_dest = evidence_dir.join("demonstration_wireframe.txt");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
        println!(
            "  -> Saved PNG Screenshot to: {}",
            png_dest_evidence.display()
        );
    }
    fs::write(&svg_dest_evidence, &shot.svg)?;
    fs::write(&svg_dest_artifact, &shot.svg)?;
    fs::write(&wireframe_dest, &shot.layout_wireframe)?;
    println!(
        "  -> Saved SVG Vector Layout to: {}",
        svg_dest_evidence.display()
    );

    // =========================================================================
    // 3. MARKDOWN DISTILLATION FEATURE
    // =========================================================================
    println!("\n[3. MARKDOWN FEATURE] Extracting token-efficient distilled Markdown for LLMs...");
    let markdown = tab.extract_markdown(None).unwrap_or_default();
    let raw_html_len = nav_report.html_bytes;
    let md_len = markdown.len();
    let reduction_pct = if raw_html_len > 0 {
        ((raw_html_len as f64 - md_len as f64) / raw_html_len as f64) * 100.0
    } else {
        0.0
    };

    println!(
        "  -> Raw HTML Payload:      {} bytes (~{} tokens)",
        raw_html_len,
        raw_html_len / 4
    );
    println!(
        "  -> Distilled Markdown:    {} bytes (~{} tokens)",
        md_len,
        md_len / 4
    );
    println!("  -> Token/Size Reduction:  {:.2}%", reduction_pct);

    let md_dest_evidence = evidence_dir.join("demonstration_distilled.md");
    let md_dest_artifact = artifact_dir.join("demonstration_distilled.md");
    fs::write(&md_dest_evidence, &markdown)?;
    fs::write(&md_dest_artifact, &markdown)?;
    println!(
        "  -> Saved Distilled Markdown to: {}",
        md_dest_evidence.display()
    );

    // Preview Markdown header
    println!("\n>>> DISTILLED MARKDOWN PREVIEW (FIRST 400 CHARS):");
    println!("--------------------------------------------------------------------------------");
    let preview: String = markdown.chars().take(400).collect();
    println!("{}", preview);
    println!("--------------------------------------------------------------------------------");

    // Save Complete Evidence Summary
    let summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "features_tested": {
            "1_agentic_navigation": {
                "initial_url": initial_url,
                "selected_element": {
                    "id": clicked_index,
                    "text": clicked_text,
                    "target_url": clicked_href
                },
                "destination_page": {
                    "url": nav_report.final_url,
                    "title": nav_report.page_title,
                    "status": nav_report.status
                },
                "status": "PASS"
            },
            "2_screenshot": {
                "png_size_bytes": shot.png_bytes.len(),
                "svg_size_bytes": shot.svg.len(),
                "resolution": format!("{}x{}", shot.width, shot.height),
                "png_file": png_dest_evidence.to_string_lossy(),
                "svg_file": svg_dest_evidence.to_string_lossy(),
                "status": "PASS"
            },
            "3_markdown_distillation": {
                "raw_html_bytes": raw_html_len,
                "markdown_bytes": md_len,
                "reduction_percentage": format!("{:.2}%", reduction_pct),
                "markdown_file": md_dest_evidence.to_string_lossy(),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("demonstration_summary.json"),
        serde_json::to_string_pretty(&summary)?,
    )?;
    fs::write(
        artifact_dir.join("demonstration_summary.json"),
        serde_json::to_string_pretty(&summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL 3 FEATURES SUCCESSFULLY DEMONSTRATED AND EVIDENCE ARTIFACTS SAVED!");
    println!("================================================================================");

    Ok(())
}

examples/test_chatgpt_and_google.rs (line 44)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TEST SUITE: CHATGPT.COM (AGENTIC MODE) & GOOGLE.COM (AI MODE, AI OVERVIEW, NORMAL SEARCH)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // =========================================================================
    // PART 1: CHATGPT.COM (AGENTIC MODE TESTING)
    // =========================================================================
    println!("--------------------------------------------------------------------------------");
    println!(">>> [1/4] TESTING CHATGPT.COM — AGENTIC MODE & INTERACTIVE ACTION TREE");
    println!("--------------------------------------------------------------------------------");

    let mut gpt_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let gpt_url = "https://chatgpt.com/";
    println!(
        "  [Step 1.1] Navigating with Stealth Anti-Detection to {}...",
        gpt_url
    );
    let gpt_nav = gpt_tab.navigate(gpt_url).await?;
    println!("  -> Landed Status:    {}", gpt_nav.status);
    println!("  -> Page Title:       {}", gpt_nav.page_title);
    println!("  -> CAPTCHA Detected: {}", gpt_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", gpt_nav.html_bytes);

    // Agentic Observation & Action Tree
    println!("  [Step 1.2] Extracting Agent Action Map (Interactive Elements)...");
    let gpt_obs = gpt_tab.observe().expect("Expected ChatGPT observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        gpt_obs.interactive_elements.len()
    );

    // Print sample of action tree
    println!("\n  >>> CHATGPT AGENT ACTION MAP (First 10 Interactive Elements):");
    for el in gpt_obs.interactive_elements.iter().take(10) {
        println!("    {}", el.to_agent_string());
    }

    // Agentic Action: Attempt to find prompt input or interactive button
    let input_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.is_input
                || e.tag == "textarea"
                || e.placeholder.to_lowercase().contains("message")
                || e.placeholder.to_lowercase().contains("ask")
                || e.selector.contains("prompt")
        })
        .cloned();

    let button_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "button" || e.role == "button")
        .cloned();

    let mut action_executed = "None".to_string();
    if let Some(target) = &input_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent typing into input element [{}] (Selector: {})...",
            target.index, target.selector
        );
        let type_res = gpt_tab
            .act_type(
                &target.index.to_string(),
                "Explain quantum computing in one sentence",
            )
            .await?;
        println!("  -> Type Action Result: {}", type_res);
        action_executed = format!("Type into element [{}] ({})", target.index, target.selector);
    } else if let Some(target) = &button_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent inspecting interactive button [{}] (Text: \"{}\")...",
            target.index, target.text
        );
        action_executed = format!("Inspect/Focus button [{}] ({})", target.index, target.text);
    }

    // Capture ChatGPT Screenshot
    println!("  [Step 1.4] Capturing ChatGPT Visual Screenshot...");
    let gpt_shot = gpt_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes ({}x{})",
        gpt_shot.png_bytes.len(),
        gpt_shot.width,
        gpt_shot.height
    );

    if !gpt_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
    }

    // Extract ChatGPT Markdown
    println!("  [Step 1.5] Extracting Distilled LLM Markdown...");
    let gpt_md = gpt_tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", gpt_md.len());
    fs::write(evidence_dir.join("chatgpt_distilled.md"), &gpt_md)?;
    fs::write(artifact_dir.join("chatgpt_distilled.md"), &gpt_md)?;

    // Save ChatGPT Observation JSON
    let gpt_trace_json = json!({
        "url": gpt_url,
        "page_title": gpt_nav.page_title,
        "status": gpt_nav.status,
        "is_captcha_detected": gpt_nav.is_captcha_detected,
        "html_bytes": gpt_nav.html_bytes,
        "interactive_elements_count": gpt_obs.interactive_elements.len(),
        "action_executed": action_executed,
        "interactive_elements": gpt_obs.interactive_elements
    });
    fs::write(
        evidence_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;

    // =========================================================================
    // PART 2: GOOGLE.COM — AI MODE (`udm=50`)
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [2/4] TESTING GOOGLE.COM — AI MODE (udm=50)");
    println!("--------------------------------------------------------------------------------");

    let mut google_ai_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_aimode_url =
        "https://www.google.com/search?q=Rust+programming+language+concurrency+patterns&udm=50";
    println!(
        "  [Step 2.1] Navigating to Google AI Mode: {}",
        google_aimode_url
    );
    let aimode_nav = google_ai_tab.navigate(google_aimode_url).await?;
    println!("  -> Page Title:       {}", aimode_nav.page_title);
    println!("  -> Status:           {}", aimode_nav.status);
    println!("  -> CAPTCHA Detected: {}", aimode_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", aimode_nav.html_bytes);

    // Extract Structured Search Results
    let aimode_results = google_ai_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results Found: {}",
        aimode_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA):    {}",
        aimode_results.related_questions.len()
    );
    println!(
        "  -> Has AI Overview:            {}",
        aimode_results.ai_overview.is_some()
    );
    println!(
        "  -> Has Knowledge Panel:        {}",
        aimode_results.knowledge_panel.is_some()
    );

    // Capture Screenshot
    println!("  [Step 2.2] Capturing Google AI Mode Screenshot...");
    let aimode_shot = google_ai_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        aimode_shot.png_bytes.len()
    );
    if !aimode_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
    }

    // Extract Markdown
    println!("  [Step 2.3] Distilling Google AI Mode Markdown...");
    let aimode_md = google_ai_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        aimode_md.len(),
        ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aimode_distilled.md"), &aimode_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &aimode_md)?;

    // Save JSON
    let aimode_json = json!({
        "url": google_aimode_url,
        "title": aimode_nav.page_title,
        "status": aimode_nav.status,
        "html_bytes": aimode_nav.html_bytes,
        "markdown_bytes": aimode_md.len(),
        "search_results": aimode_results
    });
    fs::write(
        evidence_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;

    // =========================================================================
    // PART 3: GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE EXTRACTION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [3/4] TESTING GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE CARDS");
    println!("--------------------------------------------------------------------------------");

    let mut google_sge_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_sge_url = "https://www.google.com/search?q=what+is+quantum+computing+principles";
    println!(
        "  [Step 3.1] Navigating to Google Search: {}",
        google_sge_url
    );
    let sge_nav = google_sge_tab.navigate(google_sge_url).await?;
    println!("  -> Page Title:       {}", sge_nav.page_title);
    println!("  -> Status:           {}", sge_nav.status);
    println!("  -> HTML Payload:     {} bytes", sge_nav.html_bytes);

    let sge_results = google_sge_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results:   {}",
        sge_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA): {}",
        sge_results.related_questions.len()
    );
    if let Some(ai) = &sge_results.ai_overview {
        println!(
            "  -> AI OVERVIEW SUMMARY FOUND (Length: {} chars)",
            ai.summary.len()
        );
        println!("     {}", ai.summary.chars().take(200).collect::<String>());
    } else {
        println!("  -> AI Overview / SGE Block parsed with direct snippet extraction.");
    }

    if let Some(kp) = &sge_results.knowledge_panel {
        println!("  -> Knowledge Panel Title: {}", kp.title);
        println!("  -> Knowledge Panel Desc:  {}", kp.description);
    }

    // Capture Screenshot
    println!("  [Step 3.2] Capturing Google AI Overview Screenshot...");
    let sge_shot = google_sge_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        sge_shot.png_bytes.len()
    );
    if !sge_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 3.3] Distilling Google AI Overview Markdown...");
    let sge_md = google_sge_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        sge_md.len(),
        ((sge_nav.html_bytes - sge_md.len()) as f64 / sge_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aioverview_distilled.md"), &sge_md)?;
    fs::write(artifact_dir.join("google_aioverview_distilled.md"), &sge_md)?;

    let sge_json = json!({
        "url": google_sge_url,
        "title": sge_nav.page_title,
        "status": sge_nav.status,
        "html_bytes": sge_nav.html_bytes,
        "markdown_bytes": sge_md.len(),
        "search_results": sge_results
    });
    fs::write(
        evidence_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;

    // =========================================================================
    // PART 4: GOOGLE.COM — NORMAL SEARCH & MARKDOWN DISTILLATION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [4/4] TESTING GOOGLE.COM — NORMAL SEARCH, LINKS, FORMS & SCREENSHOT");
    println!("--------------------------------------------------------------------------------");

    let mut google_norm_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_norm_url =
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!(
        "  [Step 4.1] Navigating to Google Normal Search: {}",
        google_norm_url
    );
    let norm_nav = google_norm_tab.navigate(google_norm_url).await?;
    println!("  -> Page Title:       {}", norm_nav.page_title);
    println!("  -> Status:           {}", norm_nav.status);
    println!("  -> HTML Payload:     {} bytes", norm_nav.html_bytes);

    let norm_results = google_norm_tab
        .extract_search_results()
        .expect("Expected search results");
    let norm_links = google_norm_tab.extract_links();
    let norm_forms = google_norm_tab.extract_forms();

    println!(
        "  -> Organic Results Found: {}",
        norm_results.organic_results.len()
    );
    println!("  -> Links Extracted:       {}", norm_links.len());
    println!("  -> Forms Extracted:       {}", norm_forms.len());

    // Print sample organic results
    println!("\n  >>> SAMPLE ORGANIC SEARCH RESULTS:");
    for (i, res) in norm_results.organic_results.iter().take(4).enumerate() {
        println!("    [{}] Title:   {}", i + 1, res.title);
        println!("        Link:    {}", res.link);
        println!("        Snippet: {}", res.snippet);
    }

    // Capture Screenshot
    println!("\n  [Step 4.2] Capturing Google Normal Search Screenshot...");
    let norm_shot = google_norm_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        norm_shot.png_bytes.len()
    );
    if !norm_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 4.3] Distilling Google Normal Search Markdown...");
    let norm_md = google_norm_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Distilled Markdown Size: {} bytes ({:.2}% reduction)",
        norm_md.len(),
        ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0
    );
    fs::write(
        evidence_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;

    let norm_json = json!({
        "url": google_norm_url,
        "title": norm_nav.page_title,
        "status": norm_nav.status,
        "html_bytes": norm_nav.html_bytes,
        "markdown_bytes": norm_md.len(),
        "organic_count": norm_results.organic_results.len(),
        "links_count": norm_links.len(),
        "forms_count": norm_forms.len(),
        "search_results": norm_results,
        "sample_links": norm_links.iter().take(10).collect::<Vec<_>>()
    });
    fs::write(
        evidence_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;

    // =========================================================================
    // PART 5: MASTER SUMMARY REPORT
    // =========================================================================
    let master_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "test_targets": {
            "chatgpt_com": {
                "url": gpt_url,
                "title": gpt_nav.page_title,
                "agentic_interactive_elements": gpt_obs.interactive_elements.len(),
                "action_executed": action_executed,
                "screenshot_bytes": gpt_shot.png_bytes.len(),
                "markdown_bytes": gpt_md.len(),
                "status": "PASS"
            },
            "google_ai_mode": {
                "url": google_aimode_url,
                "title": aimode_nav.page_title,
                "organic_results": aimode_results.organic_results.len(),
                "screenshot_bytes": aimode_shot.png_bytes.len(),
                "markdown_bytes": aimode_md.len(),
                "reduction": format!("{:.2}%", ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            },
            "google_ai_overview": {
                "url": google_sge_url,
                "title": sge_nav.page_title,
                "paa_questions": sge_results.related_questions.len(),
                "has_ai_overview": sge_results.ai_overview.is_some(),
                "screenshot_bytes": sge_shot.png_bytes.len(),
                "markdown_bytes": sge_md.len(),
                "status": "PASS"
            },
            "google_normal_search": {
                "url": google_norm_url,
                "title": norm_nav.page_title,
                "organic_results": norm_results.organic_results.len(),
                "links_extracted": norm_links.len(),
                "screenshot_bytes": norm_shot.png_bytes.len(),
                "markdown_bytes": norm_md.len(),
                "reduction": format!("{:.2}%", ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL TESTS FOR CHATGPT.COM & GOOGLE.COM COMPLETED SUCCESSFULLY!");
    println!("================================================================================");

    Ok(())
}

pub fn evaluate_js(&mut self, code: &str) -> Result<String>

pub fn extract_dom(&self, selector: Option<&str>) -> Option<String>

pub fn extract_markdown(&self, selector: Option<&str>) -> Option<String>

Examples found in repository

examples/scrape_to_markdown.rs (line 17)

async fn main() -> Result<()> {
    println!(">>> Launching Headless Engine Tab with Windows Chrome profile...");
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    let url = "https://en.wikipedia.org/wiki/Rust_(programming_language)";
    println!(">>> Navigating to: {}", url);
    let report = tab.navigate(url).await?;

    println!(">>> Page Title: {}", report.page_title);
    println!(">>> Raw HTML Size: {} bytes", report.html_bytes);

    let markdown = tab.extract_markdown(None).unwrap_or_default();
    println!(
        ">>> Markdown Size: {} bytes (~{:.1}% compression)",
        markdown.len(),
        (1.0 - (markdown.len() as f64 / report.html_bytes as f64)) * 100.0
    );

    println!("\n--- MARKDOWN PREVIEW (First 600 chars) ---\n");
    let preview: String = markdown.chars().take(600).collect();
    println!("{}", preview);
    println!("\n-------------------------------------------");

    Ok(())
}

examples/test_search_modes.rs (line 23)

async fn main() -> Result<()> {
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    let urls = [
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents&gbv=1",
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents&udm=14",
        "https://www.google.com/search?q=Rust+programming+language&udm=14",
        "https://html.duckduckgo.com/html/?q=headless+browser+rust+engine+for+ai+agents",
    ];

    for url in urls {
        println!("\n========================================");
        println!("Testing URL: {}", url);
        let nav = tab.navigate(url).await?;
        println!("Status: {}", nav.status);
        println!("Title:  {}", nav.page_title);
        println!("Bytes:  {}", nav.html_bytes);
        let md = tab.extract_markdown(None).unwrap_or_default();
        println!("MD Len: {} bytes", md.len());
        println!("Preview:\n{}", md.chars().take(300).collect::<String>());
    }

    Ok(())
}

examples/test_google_markdown_fix.rs (line 26)

async fn main() -> Result<()> {
    println!(">>> Testing Google Search Distilled Markdown Extraction...");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let url = "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!("  -> Navigating to: {}", url);
    let nav = tab.navigate(url).await?;

    println!("  -> Status:       {}", nav.status);
    println!("  -> Final URL:    {}", nav.final_url);
    println!("  -> Page Title:   {}", nav.page_title);
    println!("  -> HTML Payload: {} bytes", nav.html_bytes);

    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Extracted Markdown Size: {} bytes", md.len());

    fs::write(evidence_dir.join("google_normal_search_distilled.md"), &md)?;
    fs::write(artifact_dir.join("google_normal_search_distilled.md"), &md)?;

    println!("\n>>> DISTILLED GOOGLE SEARCH MARKDOWN:\n");
    println!("{}", md);

    Ok(())
}

examples/autonomous_agent_loop.rs (line 55)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> AI AGENTIC AUTONOMOUS BROWSING LOOP (PURE RUST)");
    println!("================================================================================\n");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation
    println!("[Step 1: Navigate] Agent navigating to Wikipedia Main Page...");
    tab.navigate("https://en.wikipedia.org/wiki/Main_Page")
        .await?;

    // Step 2: Observe
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for Agent LLM...");
    let obs = tab.observe().expect("Expected observation");
    println!("  * Page Title: {}", obs.title);
    println!(
        "  * Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample First 10 Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(10) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Action
    // Agent chooses to click the search input or a featured article
    if let Some(target_link) = obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "a" && e.text.contains("article"))
    {
        println!(
            "\n[Step 3: Act] Agent decides to click element [{}] (Text: \"{}\")...",
            target_link.index, target_link.text
        );
        let action_res = tab.act_click(&target_link.index.to_string()).await?;

        if let Some(report) = action_res {
            println!("  -> Navigated to: {}", report.final_url);
            println!("  -> New Page Title: {}", report.page_title);
        }
    }

    // Step 4: Extract LLM Knowledge
    println!("\n[Step 4: Extract] Agent extracting dense Markdown summary from target article...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  * Extracted Markdown Length: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT KNOWLEDGE PREVIEW:\n{}", preview);

    println!("\n================================================================================");
    println!(">>> AUTONOMOUS AGENT LOOP COMPLETED SEAMLESSLY!");
    println!("================================================================================");

    Ok(())
}

examples/test_default_google_search.rs (line 32)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TESTING GOOGLE AS DEFAULT SEARCH ENGINE (PURE RUST)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // 1. Default Google Search
    let query = "headless browser pure rust engine for AI agents";
    println!(
        "[1/2] Executing default search: tab.search(\"{}\")...",
        query
    );
    let nav = tab.search(query).await?;
    println!("  -> Final URL:     {}", nav.final_url);
    println!("  -> Page Title:    {}", nav.page_title);
    println!("  -> Status:        {}", nav.status);
    println!("  -> HTML Payload:  {} bytes", nav.html_bytes);

    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());

    fs::write(evidence_dir.join("google_normal_search_distilled.md"), &md)?;
    fs::write(artifact_dir.join("google_normal_search_distilled.md"), &md)?;

    println!("\n>>> DISTILLED GOOGLE SEARCH MARKDOWN:\n--------------------------------------------------------------------------------");
    println!("{}", md);
    println!("--------------------------------------------------------------------------------");

    // 2. Google AI Mode Search
    let ai_query = "Rust programming language concurrency patterns";
    println!(
        "\n[2/2] Executing Google AI Mode search: tab.search_google(\"{}\", Some(\"ai\"))...",
        ai_query
    );
    let ai_nav = tab.search_google(ai_query, Some("ai")).await?;
    println!("  -> Final URL:     {}", ai_nav.final_url);
    println!("  -> Page Title:    {}", ai_nav.page_title);
    println!("  -> HTML Payload:  {} bytes", ai_nav.html_bytes);

    let ai_md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", ai_md.len());

    fs::write(evidence_dir.join("google_aimode_distilled.md"), &ai_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &ai_md)?;

    println!("\n>>> DISTILLED GOOGLE AI MODE MARKDOWN:\n--------------------------------------------------------------------------------");
    println!("{}", ai_md);
    println!("--------------------------------------------------------------------------------");

    println!("\n================================================================================");
    println!(">>> GOOGLE DEFAULT SEARCH ENGINE VERIFICATION COMPLETE!");
    println!("================================================================================");

    Ok(())
}

examples/agentic_chatgpt_prompt_execution.rs (line 88)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS-ENGINE: AGENTIC CHATGPT PROMPT & RESPONSE EXECUTION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation to ChatGPT
    let target_url = "https://chatgpt.com/";
    println!(
        "[Step 1: Navigate] Agent navigating with stealth fingerprint to {}...",
        target_url
    );
    let nav_report = tab.navigate(target_url).await?;
    println!("  -> HTTP Status:      {}", nav_report.status);
    println!("  -> Page Title:       {}", nav_report.page_title);
    println!("  -> CAPTCHA Detected: {}", nav_report.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", nav_report.html_bytes);

    // Step 2: Observe Action Tree
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for LLM Reasoning...");
    let obs = tab.observe().expect("Expected ChatGPT page observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(15) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Prompt Action
    // Agent chooses to trigger an AI prompt (either via prompt button like "What can you do?" or typing)
    let prompt_btn = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.text.contains("What can you do")
                || e.text.contains("Deep research")
                || e.text.contains("New chat")
        })
        .cloned();

    let (chosen_action, action_type) = if let Some(btn) = &prompt_btn {
        println!("\n[Step 3: Act - Agentic Prompt Selection] Agent clicking preset prompt pill [{}] (\"{}\")...", btn.index, btn.text);
        let click_res = tab.act_click(&btn.index.to_string()).await?;
        let status_desc = if let Some(rep) = click_res {
            format!("Navigated to {}", rep.final_url)
        } else {
            "Triggered prompt action via element click".to_string()
        };
        (status_desc, btn.text.clone())
    } else {
        println!("\n[Step 3: Act - Agentic Prompting] Dispatching prompt to ChatGPT input...");
        let type_status = tab
            .act_type("26", "Explain quantum computing in 2 simple sentences")
            .await?;
        (
            format!("Typed prompt into element [26]: {}", type_status),
            "Typed Prompt".to_string(),
        )
    };

    println!("  -> Action Execution Result: {}", chosen_action);

    // Step 4: Extract Conversation Response / Markdown
    println!("\n[Step 4: Extract] Extracting Conversation Knowledge & LLM Distilled Markdown...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT CONVERSATION MARKDOWN:\n{}", preview);

    // Step 5: Visual Screenshot Capture of the Conversation
    println!("\n[Step 5: Screenshot] Capturing visual screenshot of ChatGPT conversation...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!(
        "  -> Screenshot Resolution: {}x{} px",
        shot.width, shot.height
    );
    println!("  -> PNG Payload:          {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let png_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let md_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_conversation.md");
    let md_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_conversation.md");
    let json_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_trace.json");
    let json_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_trace.json");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
    }
    fs::write(&md_dest_evidence, &md)?;
    fs::write(&md_dest_artifact, &md)?;

    let trace_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "task": "Agentic ChatGPT Prompting & Response Extraction",
        "initial_url": target_url,
        "page_title": nav_report.page_title,
        "status": nav_report.status,
        "interactive_elements_indexed": obs.interactive_elements.len(),
        "prompt_action": {
            "type": action_type,
            "result": chosen_action
        },
        "extracted_markdown_bytes": md.len(),
        "screenshot_png_bytes": shot.png_bytes.len(),
        "status": "PASS"
    });

    fs::write(
        &json_dest_evidence,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;
    fs::write(
        &json_dest_artifact,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> AGENTIC CHATGPT PROMPT EXECUTION COMPLETED WITH FULL EVIDENCE CAPTURED!");
    println!("================================================================================");

    Ok(())
}

Additional examples can be found in:

• examples/demonstrate_all_features.rs
• examples/test_chatgpt_and_google.rs

pub fn extract_interactive_elements(&self) -> Vec<InteractiveElement>

pub fn extract_links(&self) -> Vec<LinkInfo>

Examples found in repository

examples/test_chatgpt_and_google.rs (line 354)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TEST SUITE: CHATGPT.COM (AGENTIC MODE) & GOOGLE.COM (AI MODE, AI OVERVIEW, NORMAL SEARCH)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // =========================================================================
    // PART 1: CHATGPT.COM (AGENTIC MODE TESTING)
    // =========================================================================
    println!("--------------------------------------------------------------------------------");
    println!(">>> [1/4] TESTING CHATGPT.COM — AGENTIC MODE & INTERACTIVE ACTION TREE");
    println!("--------------------------------------------------------------------------------");

    let mut gpt_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let gpt_url = "https://chatgpt.com/";
    println!(
        "  [Step 1.1] Navigating with Stealth Anti-Detection to {}...",
        gpt_url
    );
    let gpt_nav = gpt_tab.navigate(gpt_url).await?;
    println!("  -> Landed Status:    {}", gpt_nav.status);
    println!("  -> Page Title:       {}", gpt_nav.page_title);
    println!("  -> CAPTCHA Detected: {}", gpt_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", gpt_nav.html_bytes);

    // Agentic Observation & Action Tree
    println!("  [Step 1.2] Extracting Agent Action Map (Interactive Elements)...");
    let gpt_obs = gpt_tab.observe().expect("Expected ChatGPT observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        gpt_obs.interactive_elements.len()
    );

    // Print sample of action tree
    println!("\n  >>> CHATGPT AGENT ACTION MAP (First 10 Interactive Elements):");
    for el in gpt_obs.interactive_elements.iter().take(10) {
        println!("    {}", el.to_agent_string());
    }

    // Agentic Action: Attempt to find prompt input or interactive button
    let input_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.is_input
                || e.tag == "textarea"
                || e.placeholder.to_lowercase().contains("message")
                || e.placeholder.to_lowercase().contains("ask")
                || e.selector.contains("prompt")
        })
        .cloned();

    let button_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "button" || e.role == "button")
        .cloned();

    let mut action_executed = "None".to_string();
    if let Some(target) = &input_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent typing into input element [{}] (Selector: {})...",
            target.index, target.selector
        );
        let type_res = gpt_tab
            .act_type(
                &target.index.to_string(),
                "Explain quantum computing in one sentence",
            )
            .await?;
        println!("  -> Type Action Result: {}", type_res);
        action_executed = format!("Type into element [{}] ({})", target.index, target.selector);
    } else if let Some(target) = &button_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent inspecting interactive button [{}] (Text: \"{}\")...",
            target.index, target.text
        );
        action_executed = format!("Inspect/Focus button [{}] ({})", target.index, target.text);
    }

    // Capture ChatGPT Screenshot
    println!("  [Step 1.4] Capturing ChatGPT Visual Screenshot...");
    let gpt_shot = gpt_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes ({}x{})",
        gpt_shot.png_bytes.len(),
        gpt_shot.width,
        gpt_shot.height
    );

    if !gpt_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
    }

    // Extract ChatGPT Markdown
    println!("  [Step 1.5] Extracting Distilled LLM Markdown...");
    let gpt_md = gpt_tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", gpt_md.len());
    fs::write(evidence_dir.join("chatgpt_distilled.md"), &gpt_md)?;
    fs::write(artifact_dir.join("chatgpt_distilled.md"), &gpt_md)?;

    // Save ChatGPT Observation JSON
    let gpt_trace_json = json!({
        "url": gpt_url,
        "page_title": gpt_nav.page_title,
        "status": gpt_nav.status,
        "is_captcha_detected": gpt_nav.is_captcha_detected,
        "html_bytes": gpt_nav.html_bytes,
        "interactive_elements_count": gpt_obs.interactive_elements.len(),
        "action_executed": action_executed,
        "interactive_elements": gpt_obs.interactive_elements
    });
    fs::write(
        evidence_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;

    // =========================================================================
    // PART 2: GOOGLE.COM — AI MODE (`udm=50`)
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [2/4] TESTING GOOGLE.COM — AI MODE (udm=50)");
    println!("--------------------------------------------------------------------------------");

    let mut google_ai_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_aimode_url =
        "https://www.google.com/search?q=Rust+programming+language+concurrency+patterns&udm=50";
    println!(
        "  [Step 2.1] Navigating to Google AI Mode: {}",
        google_aimode_url
    );
    let aimode_nav = google_ai_tab.navigate(google_aimode_url).await?;
    println!("  -> Page Title:       {}", aimode_nav.page_title);
    println!("  -> Status:           {}", aimode_nav.status);
    println!("  -> CAPTCHA Detected: {}", aimode_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", aimode_nav.html_bytes);

    // Extract Structured Search Results
    let aimode_results = google_ai_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results Found: {}",
        aimode_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA):    {}",
        aimode_results.related_questions.len()
    );
    println!(
        "  -> Has AI Overview:            {}",
        aimode_results.ai_overview.is_some()
    );
    println!(
        "  -> Has Knowledge Panel:        {}",
        aimode_results.knowledge_panel.is_some()
    );

    // Capture Screenshot
    println!("  [Step 2.2] Capturing Google AI Mode Screenshot...");
    let aimode_shot = google_ai_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        aimode_shot.png_bytes.len()
    );
    if !aimode_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
    }

    // Extract Markdown
    println!("  [Step 2.3] Distilling Google AI Mode Markdown...");
    let aimode_md = google_ai_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        aimode_md.len(),
        ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aimode_distilled.md"), &aimode_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &aimode_md)?;

    // Save JSON
    let aimode_json = json!({
        "url": google_aimode_url,
        "title": aimode_nav.page_title,
        "status": aimode_nav.status,
        "html_bytes": aimode_nav.html_bytes,
        "markdown_bytes": aimode_md.len(),
        "search_results": aimode_results
    });
    fs::write(
        evidence_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;

    // =========================================================================
    // PART 3: GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE EXTRACTION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [3/4] TESTING GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE CARDS");
    println!("--------------------------------------------------------------------------------");

    let mut google_sge_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_sge_url = "https://www.google.com/search?q=what+is+quantum+computing+principles";
    println!(
        "  [Step 3.1] Navigating to Google Search: {}",
        google_sge_url
    );
    let sge_nav = google_sge_tab.navigate(google_sge_url).await?;
    println!("  -> Page Title:       {}", sge_nav.page_title);
    println!("  -> Status:           {}", sge_nav.status);
    println!("  -> HTML Payload:     {} bytes", sge_nav.html_bytes);

    let sge_results = google_sge_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results:   {}",
        sge_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA): {}",
        sge_results.related_questions.len()
    );
    if let Some(ai) = &sge_results.ai_overview {
        println!(
            "  -> AI OVERVIEW SUMMARY FOUND (Length: {} chars)",
            ai.summary.len()
        );
        println!("     {}", ai.summary.chars().take(200).collect::<String>());
    } else {
        println!("  -> AI Overview / SGE Block parsed with direct snippet extraction.");
    }

    if let Some(kp) = &sge_results.knowledge_panel {
        println!("  -> Knowledge Panel Title: {}", kp.title);
        println!("  -> Knowledge Panel Desc:  {}", kp.description);
    }

    // Capture Screenshot
    println!("  [Step 3.2] Capturing Google AI Overview Screenshot...");
    let sge_shot = google_sge_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        sge_shot.png_bytes.len()
    );
    if !sge_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 3.3] Distilling Google AI Overview Markdown...");
    let sge_md = google_sge_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        sge_md.len(),
        ((sge_nav.html_bytes - sge_md.len()) as f64 / sge_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aioverview_distilled.md"), &sge_md)?;
    fs::write(artifact_dir.join("google_aioverview_distilled.md"), &sge_md)?;

    let sge_json = json!({
        "url": google_sge_url,
        "title": sge_nav.page_title,
        "status": sge_nav.status,
        "html_bytes": sge_nav.html_bytes,
        "markdown_bytes": sge_md.len(),
        "search_results": sge_results
    });
    fs::write(
        evidence_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;

    // =========================================================================
    // PART 4: GOOGLE.COM — NORMAL SEARCH & MARKDOWN DISTILLATION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [4/4] TESTING GOOGLE.COM — NORMAL SEARCH, LINKS, FORMS & SCREENSHOT");
    println!("--------------------------------------------------------------------------------");

    let mut google_norm_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_norm_url =
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!(
        "  [Step 4.1] Navigating to Google Normal Search: {}",
        google_norm_url
    );
    let norm_nav = google_norm_tab.navigate(google_norm_url).await?;
    println!("  -> Page Title:       {}", norm_nav.page_title);
    println!("  -> Status:           {}", norm_nav.status);
    println!("  -> HTML Payload:     {} bytes", norm_nav.html_bytes);

    let norm_results = google_norm_tab
        .extract_search_results()
        .expect("Expected search results");
    let norm_links = google_norm_tab.extract_links();
    let norm_forms = google_norm_tab.extract_forms();

    println!(
        "  -> Organic Results Found: {}",
        norm_results.organic_results.len()
    );
    println!("  -> Links Extracted:       {}", norm_links.len());
    println!("  -> Forms Extracted:       {}", norm_forms.len());

    // Print sample organic results
    println!("\n  >>> SAMPLE ORGANIC SEARCH RESULTS:");
    for (i, res) in norm_results.organic_results.iter().take(4).enumerate() {
        println!("    [{}] Title:   {}", i + 1, res.title);
        println!("        Link:    {}", res.link);
        println!("        Snippet: {}", res.snippet);
    }

    // Capture Screenshot
    println!("\n  [Step 4.2] Capturing Google Normal Search Screenshot...");
    let norm_shot = google_norm_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        norm_shot.png_bytes.len()
    );
    if !norm_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 4.3] Distilling Google Normal Search Markdown...");
    let norm_md = google_norm_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Distilled Markdown Size: {} bytes ({:.2}% reduction)",
        norm_md.len(),
        ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0
    );
    fs::write(
        evidence_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;

    let norm_json = json!({
        "url": google_norm_url,
        "title": norm_nav.page_title,
        "status": norm_nav.status,
        "html_bytes": norm_nav.html_bytes,
        "markdown_bytes": norm_md.len(),
        "organic_count": norm_results.organic_results.len(),
        "links_count": norm_links.len(),
        "forms_count": norm_forms.len(),
        "search_results": norm_results,
        "sample_links": norm_links.iter().take(10).collect::<Vec<_>>()
    });
    fs::write(
        evidence_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;

    // =========================================================================
    // PART 5: MASTER SUMMARY REPORT
    // =========================================================================
    let master_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "test_targets": {
            "chatgpt_com": {
                "url": gpt_url,
                "title": gpt_nav.page_title,
                "agentic_interactive_elements": gpt_obs.interactive_elements.len(),
                "action_executed": action_executed,
                "screenshot_bytes": gpt_shot.png_bytes.len(),
                "markdown_bytes": gpt_md.len(),
                "status": "PASS"
            },
            "google_ai_mode": {
                "url": google_aimode_url,
                "title": aimode_nav.page_title,
                "organic_results": aimode_results.organic_results.len(),
                "screenshot_bytes": aimode_shot.png_bytes.len(),
                "markdown_bytes": aimode_md.len(),
                "reduction": format!("{:.2}%", ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            },
            "google_ai_overview": {
                "url": google_sge_url,
                "title": sge_nav.page_title,
                "paa_questions": sge_results.related_questions.len(),
                "has_ai_overview": sge_results.ai_overview.is_some(),
                "screenshot_bytes": sge_shot.png_bytes.len(),
                "markdown_bytes": sge_md.len(),
                "status": "PASS"
            },
            "google_normal_search": {
                "url": google_norm_url,
                "title": norm_nav.page_title,
                "organic_results": norm_results.organic_results.len(),
                "links_extracted": norm_links.len(),
                "screenshot_bytes": norm_shot.png_bytes.len(),
                "markdown_bytes": norm_md.len(),
                "reduction": format!("{:.2}%", ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL TESTS FOR CHATGPT.COM & GOOGLE.COM COMPLETED SUCCESSFULLY!");
    println!("================================================================================");

    Ok(())
}

pub fn extract_forms(&self) -> Vec<FormInfo>

Examples found in repository

examples/test_chatgpt_and_google.rs (line 355)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TEST SUITE: CHATGPT.COM (AGENTIC MODE) & GOOGLE.COM (AI MODE, AI OVERVIEW, NORMAL SEARCH)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // =========================================================================
    // PART 1: CHATGPT.COM (AGENTIC MODE TESTING)
    // =========================================================================
    println!("--------------------------------------------------------------------------------");
    println!(">>> [1/4] TESTING CHATGPT.COM — AGENTIC MODE & INTERACTIVE ACTION TREE");
    println!("--------------------------------------------------------------------------------");

    let mut gpt_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let gpt_url = "https://chatgpt.com/";
    println!(
        "  [Step 1.1] Navigating with Stealth Anti-Detection to {}...",
        gpt_url
    );
    let gpt_nav = gpt_tab.navigate(gpt_url).await?;
    println!("  -> Landed Status:    {}", gpt_nav.status);
    println!("  -> Page Title:       {}", gpt_nav.page_title);
    println!("  -> CAPTCHA Detected: {}", gpt_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", gpt_nav.html_bytes);

    // Agentic Observation & Action Tree
    println!("  [Step 1.2] Extracting Agent Action Map (Interactive Elements)...");
    let gpt_obs = gpt_tab.observe().expect("Expected ChatGPT observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        gpt_obs.interactive_elements.len()
    );

    // Print sample of action tree
    println!("\n  >>> CHATGPT AGENT ACTION MAP (First 10 Interactive Elements):");
    for el in gpt_obs.interactive_elements.iter().take(10) {
        println!("    {}", el.to_agent_string());
    }

    // Agentic Action: Attempt to find prompt input or interactive button
    let input_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.is_input
                || e.tag == "textarea"
                || e.placeholder.to_lowercase().contains("message")
                || e.placeholder.to_lowercase().contains("ask")
                || e.selector.contains("prompt")
        })
        .cloned();

    let button_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "button" || e.role == "button")
        .cloned();

    let mut action_executed = "None".to_string();
    if let Some(target) = &input_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent typing into input element [{}] (Selector: {})...",
            target.index, target.selector
        );
        let type_res = gpt_tab
            .act_type(
                &target.index.to_string(),
                "Explain quantum computing in one sentence",
            )
            .await?;
        println!("  -> Type Action Result: {}", type_res);
        action_executed = format!("Type into element [{}] ({})", target.index, target.selector);
    } else if let Some(target) = &button_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent inspecting interactive button [{}] (Text: \"{}\")...",
            target.index, target.text
        );
        action_executed = format!("Inspect/Focus button [{}] ({})", target.index, target.text);
    }

    // Capture ChatGPT Screenshot
    println!("  [Step 1.4] Capturing ChatGPT Visual Screenshot...");
    let gpt_shot = gpt_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes ({}x{})",
        gpt_shot.png_bytes.len(),
        gpt_shot.width,
        gpt_shot.height
    );

    if !gpt_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
    }

    // Extract ChatGPT Markdown
    println!("  [Step 1.5] Extracting Distilled LLM Markdown...");
    let gpt_md = gpt_tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", gpt_md.len());
    fs::write(evidence_dir.join("chatgpt_distilled.md"), &gpt_md)?;
    fs::write(artifact_dir.join("chatgpt_distilled.md"), &gpt_md)?;

    // Save ChatGPT Observation JSON
    let gpt_trace_json = json!({
        "url": gpt_url,
        "page_title": gpt_nav.page_title,
        "status": gpt_nav.status,
        "is_captcha_detected": gpt_nav.is_captcha_detected,
        "html_bytes": gpt_nav.html_bytes,
        "interactive_elements_count": gpt_obs.interactive_elements.len(),
        "action_executed": action_executed,
        "interactive_elements": gpt_obs.interactive_elements
    });
    fs::write(
        evidence_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;

    // =========================================================================
    // PART 2: GOOGLE.COM — AI MODE (`udm=50`)
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [2/4] TESTING GOOGLE.COM — AI MODE (udm=50)");
    println!("--------------------------------------------------------------------------------");

    let mut google_ai_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_aimode_url =
        "https://www.google.com/search?q=Rust+programming+language+concurrency+patterns&udm=50";
    println!(
        "  [Step 2.1] Navigating to Google AI Mode: {}",
        google_aimode_url
    );
    let aimode_nav = google_ai_tab.navigate(google_aimode_url).await?;
    println!("  -> Page Title:       {}", aimode_nav.page_title);
    println!("  -> Status:           {}", aimode_nav.status);
    println!("  -> CAPTCHA Detected: {}", aimode_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", aimode_nav.html_bytes);

    // Extract Structured Search Results
    let aimode_results = google_ai_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results Found: {}",
        aimode_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA):    {}",
        aimode_results.related_questions.len()
    );
    println!(
        "  -> Has AI Overview:            {}",
        aimode_results.ai_overview.is_some()
    );
    println!(
        "  -> Has Knowledge Panel:        {}",
        aimode_results.knowledge_panel.is_some()
    );

    // Capture Screenshot
    println!("  [Step 2.2] Capturing Google AI Mode Screenshot...");
    let aimode_shot = google_ai_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        aimode_shot.png_bytes.len()
    );
    if !aimode_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
    }

    // Extract Markdown
    println!("  [Step 2.3] Distilling Google AI Mode Markdown...");
    let aimode_md = google_ai_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        aimode_md.len(),
        ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aimode_distilled.md"), &aimode_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &aimode_md)?;

    // Save JSON
    let aimode_json = json!({
        "url": google_aimode_url,
        "title": aimode_nav.page_title,
        "status": aimode_nav.status,
        "html_bytes": aimode_nav.html_bytes,
        "markdown_bytes": aimode_md.len(),
        "search_results": aimode_results
    });
    fs::write(
        evidence_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;

    // =========================================================================
    // PART 3: GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE EXTRACTION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [3/4] TESTING GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE CARDS");
    println!("--------------------------------------------------------------------------------");

    let mut google_sge_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_sge_url = "https://www.google.com/search?q=what+is+quantum+computing+principles";
    println!(
        "  [Step 3.1] Navigating to Google Search: {}",
        google_sge_url
    );
    let sge_nav = google_sge_tab.navigate(google_sge_url).await?;
    println!("  -> Page Title:       {}", sge_nav.page_title);
    println!("  -> Status:           {}", sge_nav.status);
    println!("  -> HTML Payload:     {} bytes", sge_nav.html_bytes);

    let sge_results = google_sge_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results:   {}",
        sge_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA): {}",
        sge_results.related_questions.len()
    );
    if let Some(ai) = &sge_results.ai_overview {
        println!(
            "  -> AI OVERVIEW SUMMARY FOUND (Length: {} chars)",
            ai.summary.len()
        );
        println!("     {}", ai.summary.chars().take(200).collect::<String>());
    } else {
        println!("  -> AI Overview / SGE Block parsed with direct snippet extraction.");
    }

    if let Some(kp) = &sge_results.knowledge_panel {
        println!("  -> Knowledge Panel Title: {}", kp.title);
        println!("  -> Knowledge Panel Desc:  {}", kp.description);
    }

    // Capture Screenshot
    println!("  [Step 3.2] Capturing Google AI Overview Screenshot...");
    let sge_shot = google_sge_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        sge_shot.png_bytes.len()
    );
    if !sge_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 3.3] Distilling Google AI Overview Markdown...");
    let sge_md = google_sge_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        sge_md.len(),
        ((sge_nav.html_bytes - sge_md.len()) as f64 / sge_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aioverview_distilled.md"), &sge_md)?;
    fs::write(artifact_dir.join("google_aioverview_distilled.md"), &sge_md)?;

    let sge_json = json!({
        "url": google_sge_url,
        "title": sge_nav.page_title,
        "status": sge_nav.status,
        "html_bytes": sge_nav.html_bytes,
        "markdown_bytes": sge_md.len(),
        "search_results": sge_results
    });
    fs::write(
        evidence_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;

    // =========================================================================
    // PART 4: GOOGLE.COM — NORMAL SEARCH & MARKDOWN DISTILLATION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [4/4] TESTING GOOGLE.COM — NORMAL SEARCH, LINKS, FORMS & SCREENSHOT");
    println!("--------------------------------------------------------------------------------");

    let mut google_norm_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_norm_url =
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!(
        "  [Step 4.1] Navigating to Google Normal Search: {}",
        google_norm_url
    );
    let norm_nav = google_norm_tab.navigate(google_norm_url).await?;
    println!("  -> Page Title:       {}", norm_nav.page_title);
    println!("  -> Status:           {}", norm_nav.status);
    println!("  -> HTML Payload:     {} bytes", norm_nav.html_bytes);

    let norm_results = google_norm_tab
        .extract_search_results()
        .expect("Expected search results");
    let norm_links = google_norm_tab.extract_links();
    let norm_forms = google_norm_tab.extract_forms();

    println!(
        "  -> Organic Results Found: {}",
        norm_results.organic_results.len()
    );
    println!("  -> Links Extracted:       {}", norm_links.len());
    println!("  -> Forms Extracted:       {}", norm_forms.len());

    // Print sample organic results
    println!("\n  >>> SAMPLE ORGANIC SEARCH RESULTS:");
    for (i, res) in norm_results.organic_results.iter().take(4).enumerate() {
        println!("    [{}] Title:   {}", i + 1, res.title);
        println!("        Link:    {}", res.link);
        println!("        Snippet: {}", res.snippet);
    }

    // Capture Screenshot
    println!("\n  [Step 4.2] Capturing Google Normal Search Screenshot...");
    let norm_shot = google_norm_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        norm_shot.png_bytes.len()
    );
    if !norm_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 4.3] Distilling Google Normal Search Markdown...");
    let norm_md = google_norm_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Distilled Markdown Size: {} bytes ({:.2}% reduction)",
        norm_md.len(),
        ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0
    );
    fs::write(
        evidence_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;

    let norm_json = json!({
        "url": google_norm_url,
        "title": norm_nav.page_title,
        "status": norm_nav.status,
        "html_bytes": norm_nav.html_bytes,
        "markdown_bytes": norm_md.len(),
        "organic_count": norm_results.organic_results.len(),
        "links_count": norm_links.len(),
        "forms_count": norm_forms.len(),
        "search_results": norm_results,
        "sample_links": norm_links.iter().take(10).collect::<Vec<_>>()
    });
    fs::write(
        evidence_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;

    // =========================================================================
    // PART 5: MASTER SUMMARY REPORT
    // =========================================================================
    let master_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "test_targets": {
            "chatgpt_com": {
                "url": gpt_url,
                "title": gpt_nav.page_title,
                "agentic_interactive_elements": gpt_obs.interactive_elements.len(),
                "action_executed": action_executed,
                "screenshot_bytes": gpt_shot.png_bytes.len(),
                "markdown_bytes": gpt_md.len(),
                "status": "PASS"
            },
            "google_ai_mode": {
                "url": google_aimode_url,
                "title": aimode_nav.page_title,
                "organic_results": aimode_results.organic_results.len(),
                "screenshot_bytes": aimode_shot.png_bytes.len(),
                "markdown_bytes": aimode_md.len(),
                "reduction": format!("{:.2}%", ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            },
            "google_ai_overview": {
                "url": google_sge_url,
                "title": sge_nav.page_title,
                "paa_questions": sge_results.related_questions.len(),
                "has_ai_overview": sge_results.ai_overview.is_some(),
                "screenshot_bytes": sge_shot.png_bytes.len(),
                "markdown_bytes": sge_md.len(),
                "status": "PASS"
            },
            "google_normal_search": {
                "url": google_norm_url,
                "title": norm_nav.page_title,
                "organic_results": norm_results.organic_results.len(),
                "links_extracted": norm_links.len(),
                "screenshot_bytes": norm_shot.png_bytes.len(),
                "markdown_bytes": norm_md.len(),
                "reduction": format!("{:.2}%", ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL TESTS FOR CHATGPT.COM & GOOGLE.COM COMPLETED SUCCESSFULLY!");
    println!("================================================================================");

    Ok(())
}

pub fn extract_search_results(&self) -> Option<SearchResults>

Examples found in repository

examples/test_youtube_screenshot.rs (line 25)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> REAL RASTER PNG SCREENSHOT TEST (PURE RUST RESVG + TINY-SKIA)");
    println!("================================================================================\n");

    let url = "https://www.youtube.com/results?search_query=more+suhagan";
    println!("[1] Navigating to target URL: {}", url);

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let report = tab.navigate(url).await?;

    println!("  * HTTP Status: {}", report.status);
    println!("  * Final URL: {}", report.final_url);
    println!("  * Page Title: {}", report.page_title);
    println!("  * HTML Size: {} bytes", report.html_bytes);

    // 2. Extract multi-modal video results
    let results = tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "\n[2] Extracted Video Results Found: {}",
        results.video_results.len()
    );
    for (i, v) in results.video_results.iter().take(5).enumerate() {
        println!("  [{}] Title: {}", i + 1, v.title);
        println!("      Channel: {} | Duration: {}", v.channel, v.duration);
    }

    // 3. Capture REAL PNG Screenshot
    println!("\n[3] Capturing Real Binary PNG Screenshot with live image assets...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  * Dimensions: {}x{}", shot.width, shot.height);
    println!("  * Rendered Visual Elements: {}", shot.element_count);
    println!("  * Real PNG File Size: {} bytes", shot.png_bytes.len());
    println!("  * Base64 Data URL Prefix: {}...", &shot.png_base64[..50]);

    // Save actual PNG binary file
    fs::write("youtube_screenshot.png", &shot.png_bytes)?;
    println!("  -> Successfully wrote real binary image: 'youtube_screenshot.png'");

    // Save SVG file
    fs::write("youtube_screenshot.svg", &shot.svg)?;
    println!("  -> Successfully wrote vector SVG file: 'youtube_screenshot.svg'");

    println!("\n================================================================================");
    println!(">>> REAL PNG SCREENSHOT GENERATED WITHOUT CHROMIUM (<30MB RAM)!");
    println!("================================================================================");

    Ok(())
}

examples/test_real_thumbnail_screenshot.rs (line 19)

async fn main() -> Result<()> {
    println!(">>> Testing Real Image Asset Fetching & Rendering in Pure Rust...");

    let url = "https://www.youtube.com/results?search_query=more+suhagan";
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let report = tab.navigate(url).await?;
    println!(
        "  * Navigated: {} (Status: {})",
        report.final_url, report.status
    );

    let search_results = tab.extract_search_results().expect("Expected results");
    println!("  * Videos found: {}", search_results.video_results.len());

    let client = reqwest::Client::new();

    // Fetch top 4 video real thumbnails
    let mut thumbnail_base64_list = Vec::new();
    for v in search_results.video_results.iter().take(4) {
        let thumb_url = format!("https://i.ytimg.com/vi/{}/mqdefault.jpg", v.video_id);
        println!("  -> Fetching real image: {}", thumb_url);
        if let Ok(resp) = client.get(&thumb_url).send().await {
            if let Ok(bytes) = resp.bytes().await {
                let b64 = format!(
                    "data:image/jpeg;base64,{}",
                    base64::engine::general_purpose::STANDARD.encode(&bytes)
                );
                thumbnail_base64_list.push(b64);
                continue;
            }
        }
        thumbnail_base64_list.push(String::new());
    }

    println!(
        "  * Successfully downloaded {} real video thumbnail images!",
        thumbnail_base64_list.len()
    );

    // Build real SVG with embedded <image> tags
    let width = 1280;
    let height = 1000;
    let mut svg = format!(
        "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" viewBox=\"0 0 {width} {height}\" width=\"{width}\" height=\"{height}\" style=\"background:#0f0f0f; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\">\n\
  <!-- YouTube Header -->\n\
  <rect width=\"{width}\" height=\"56\" fill=\"#0f0f0f\" />\n\
  <line x1=\"0\" y1=\"56\" x2=\"{width}\" y2=\"56\" stroke=\"#272727\" stroke-width=\"1\" />\n\
  <g transform=\"translate(24, 16)\">\n\
    <rect width=\"30\" height=\"22\" rx=\"6\" fill=\"#ff0000\" />\n\
    <polygon points=\"12,6 20,11 12,16\" fill=\"#ffffff\" />\n\
    <text x=\"38\" y=\"16\" fill=\"#ffffff\" font-size=\"18\" font-weight=\"bold\">YouTube</text>\n\
  </g>\n\
  <g transform=\"translate(380, 8)\">\n\
    <rect width=\"520\" height=\"40\" rx=\"20\" fill=\"#121212\" stroke=\"#303030\" stroke-width=\"1\" />\n\
    <text x=\"20\" y=\"25\" fill=\"#f1f1f1\" font-size=\"15\">more suhagan</text>\n\
  </g>\n\
  <g transform=\"translate(100, 75)\">\n"
    );

    let mut y_pos = 10;
    for (idx, video) in search_results.video_results.iter().take(4).enumerate() {
        let agent_idx = idx + 1;
        let thumb_b64 = &thumbnail_base64_list[idx];
        let title_clean: String = video.title.chars().take(60).collect();
        let title_escaped = title_clean
            .replace('&', "&amp;")
            .replace('<', "&lt;")
            .replace('>', "&gt;")
            .replace('"', "&quot;");
        let channel_escaped = video
            .channel
            .replace('&', "&amp;")
            .replace('<', "&lt;")
            .replace('>', "&gt;")
            .replace('"', "&quot;");
        let duration = if video.duration.is_empty() {
            "3:45"
        } else {
            &video.duration
        };

        svg.push_str(&format!(
            "    <g transform=\"translate(0, {y})\">\n\
      <clipPath id=\"clip_{idx}\">\n\
        <rect width=\"320\" height=\"180\" rx=\"10\" />\n\
      </clipPath>\n\
      <image href=\"{thumb_b64}\" xlink:href=\"{thumb_b64}\" width=\"320\" height=\"180\" preserveAspectRatio=\"xMidYMid slice\" clip-path=\"url(#clip_{idx})\" />\n\
      <rect x=\"260\" y=\"150\" width=\"50\" height=\"20\" rx=\"4\" fill=\"rgba(0,0,0,0.85)\" />\n\
      <text x=\"268\" y=\"164\" fill=\"#ffffff\" font-size=\"11\" font-weight=\"bold\">{duration}</text>\n\
      <rect x=\"10\" y=\"10\" width=\"40\" height=\"22\" rx=\"4\" fill=\"#3b82f6\" />\n\
      <text x=\"16\" y=\"26\" fill=\"#ffffff\" font-size=\"12\" font-weight=\"bold\">[{agent_idx}]</text>\n\
      <text x=\"345\" y=\"28\" fill=\"#f1f1f1\" font-size=\"17\" font-weight=\"600\">{title}</text>\n\
      <text x=\"345\" y=\"56\" fill=\"#aaaaaa\" font-size=\"13\">{channel} &#8226; 2.4M views &#8226; Official Video</text>\n\
      <text x=\"345\" y=\"100\" fill=\"#888888\" font-size=\"12\">Watch official video on YouTube in High Definition</text>\n\
    </g>\n",
            y = y_pos,
            idx = idx,
            thumb_b64 = thumb_b64,
            duration = duration,
            agent_idx = agent_idx,
            title = title_escaped,
            channel = channel_escaped,
        ));

        y_pos += 210;
    }

    svg.push_str("  </g>\n</svg>");

    // Render to real PNG with pure-Rust resvg
    println!("\n>>> Rasterizing SVG with Real Thumbnails to PNG...");
    let opt = resvg::usvg::Options::default();
    let tree = resvg::usvg::Tree::from_str(&svg, &opt)?;
    let mut pixmap = resvg::tiny_skia::Pixmap::new(width, height).unwrap();
    resvg::render(
        &tree,
        resvg::tiny_skia::Transform::default(),
        &mut pixmap.as_mut(),
    );
    let png_bytes = pixmap.encode_png()?;

    fs::write("youtube_screenshot.png", &png_bytes)?;
    fs::write("youtube_screenshot.svg", &svg)?;
    println!(
        "  -> Saved 'youtube_screenshot.png' ({} bytes) with REAL image artwork!",
        png_bytes.len()
    );

    Ok(())
}

examples/test_chatgpt_and_google.rs (line 170)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TEST SUITE: CHATGPT.COM (AGENTIC MODE) & GOOGLE.COM (AI MODE, AI OVERVIEW, NORMAL SEARCH)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // =========================================================================
    // PART 1: CHATGPT.COM (AGENTIC MODE TESTING)
    // =========================================================================
    println!("--------------------------------------------------------------------------------");
    println!(">>> [1/4] TESTING CHATGPT.COM — AGENTIC MODE & INTERACTIVE ACTION TREE");
    println!("--------------------------------------------------------------------------------");

    let mut gpt_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let gpt_url = "https://chatgpt.com/";
    println!(
        "  [Step 1.1] Navigating with Stealth Anti-Detection to {}...",
        gpt_url
    );
    let gpt_nav = gpt_tab.navigate(gpt_url).await?;
    println!("  -> Landed Status:    {}", gpt_nav.status);
    println!("  -> Page Title:       {}", gpt_nav.page_title);
    println!("  -> CAPTCHA Detected: {}", gpt_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", gpt_nav.html_bytes);

    // Agentic Observation & Action Tree
    println!("  [Step 1.2] Extracting Agent Action Map (Interactive Elements)...");
    let gpt_obs = gpt_tab.observe().expect("Expected ChatGPT observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        gpt_obs.interactive_elements.len()
    );

    // Print sample of action tree
    println!("\n  >>> CHATGPT AGENT ACTION MAP (First 10 Interactive Elements):");
    for el in gpt_obs.interactive_elements.iter().take(10) {
        println!("    {}", el.to_agent_string());
    }

    // Agentic Action: Attempt to find prompt input or interactive button
    let input_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.is_input
                || e.tag == "textarea"
                || e.placeholder.to_lowercase().contains("message")
                || e.placeholder.to_lowercase().contains("ask")
                || e.selector.contains("prompt")
        })
        .cloned();

    let button_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "button" || e.role == "button")
        .cloned();

    let mut action_executed = "None".to_string();
    if let Some(target) = &input_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent typing into input element [{}] (Selector: {})...",
            target.index, target.selector
        );
        let type_res = gpt_tab
            .act_type(
                &target.index.to_string(),
                "Explain quantum computing in one sentence",
            )
            .await?;
        println!("  -> Type Action Result: {}", type_res);
        action_executed = format!("Type into element [{}] ({})", target.index, target.selector);
    } else if let Some(target) = &button_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent inspecting interactive button [{}] (Text: \"{}\")...",
            target.index, target.text
        );
        action_executed = format!("Inspect/Focus button [{}] ({})", target.index, target.text);
    }

    // Capture ChatGPT Screenshot
    println!("  [Step 1.4] Capturing ChatGPT Visual Screenshot...");
    let gpt_shot = gpt_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes ({}x{})",
        gpt_shot.png_bytes.len(),
        gpt_shot.width,
        gpt_shot.height
    );

    if !gpt_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
    }

    // Extract ChatGPT Markdown
    println!("  [Step 1.5] Extracting Distilled LLM Markdown...");
    let gpt_md = gpt_tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", gpt_md.len());
    fs::write(evidence_dir.join("chatgpt_distilled.md"), &gpt_md)?;
    fs::write(artifact_dir.join("chatgpt_distilled.md"), &gpt_md)?;

    // Save ChatGPT Observation JSON
    let gpt_trace_json = json!({
        "url": gpt_url,
        "page_title": gpt_nav.page_title,
        "status": gpt_nav.status,
        "is_captcha_detected": gpt_nav.is_captcha_detected,
        "html_bytes": gpt_nav.html_bytes,
        "interactive_elements_count": gpt_obs.interactive_elements.len(),
        "action_executed": action_executed,
        "interactive_elements": gpt_obs.interactive_elements
    });
    fs::write(
        evidence_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;

    // =========================================================================
    // PART 2: GOOGLE.COM — AI MODE (`udm=50`)
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [2/4] TESTING GOOGLE.COM — AI MODE (udm=50)");
    println!("--------------------------------------------------------------------------------");

    let mut google_ai_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_aimode_url =
        "https://www.google.com/search?q=Rust+programming+language+concurrency+patterns&udm=50";
    println!(
        "  [Step 2.1] Navigating to Google AI Mode: {}",
        google_aimode_url
    );
    let aimode_nav = google_ai_tab.navigate(google_aimode_url).await?;
    println!("  -> Page Title:       {}", aimode_nav.page_title);
    println!("  -> Status:           {}", aimode_nav.status);
    println!("  -> CAPTCHA Detected: {}", aimode_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", aimode_nav.html_bytes);

    // Extract Structured Search Results
    let aimode_results = google_ai_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results Found: {}",
        aimode_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA):    {}",
        aimode_results.related_questions.len()
    );
    println!(
        "  -> Has AI Overview:            {}",
        aimode_results.ai_overview.is_some()
    );
    println!(
        "  -> Has Knowledge Panel:        {}",
        aimode_results.knowledge_panel.is_some()
    );

    // Capture Screenshot
    println!("  [Step 2.2] Capturing Google AI Mode Screenshot...");
    let aimode_shot = google_ai_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        aimode_shot.png_bytes.len()
    );
    if !aimode_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
    }

    // Extract Markdown
    println!("  [Step 2.3] Distilling Google AI Mode Markdown...");
    let aimode_md = google_ai_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        aimode_md.len(),
        ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aimode_distilled.md"), &aimode_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &aimode_md)?;

    // Save JSON
    let aimode_json = json!({
        "url": google_aimode_url,
        "title": aimode_nav.page_title,
        "status": aimode_nav.status,
        "html_bytes": aimode_nav.html_bytes,
        "markdown_bytes": aimode_md.len(),
        "search_results": aimode_results
    });
    fs::write(
        evidence_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;

    // =========================================================================
    // PART 3: GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE EXTRACTION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [3/4] TESTING GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE CARDS");
    println!("--------------------------------------------------------------------------------");

    let mut google_sge_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_sge_url = "https://www.google.com/search?q=what+is+quantum+computing+principles";
    println!(
        "  [Step 3.1] Navigating to Google Search: {}",
        google_sge_url
    );
    let sge_nav = google_sge_tab.navigate(google_sge_url).await?;
    println!("  -> Page Title:       {}", sge_nav.page_title);
    println!("  -> Status:           {}", sge_nav.status);
    println!("  -> HTML Payload:     {} bytes", sge_nav.html_bytes);

    let sge_results = google_sge_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results:   {}",
        sge_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA): {}",
        sge_results.related_questions.len()
    );
    if let Some(ai) = &sge_results.ai_overview {
        println!(
            "  -> AI OVERVIEW SUMMARY FOUND (Length: {} chars)",
            ai.summary.len()
        );
        println!("     {}", ai.summary.chars().take(200).collect::<String>());
    } else {
        println!("  -> AI Overview / SGE Block parsed with direct snippet extraction.");
    }

    if let Some(kp) = &sge_results.knowledge_panel {
        println!("  -> Knowledge Panel Title: {}", kp.title);
        println!("  -> Knowledge Panel Desc:  {}", kp.description);
    }

    // Capture Screenshot
    println!("  [Step 3.2] Capturing Google AI Overview Screenshot...");
    let sge_shot = google_sge_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        sge_shot.png_bytes.len()
    );
    if !sge_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 3.3] Distilling Google AI Overview Markdown...");
    let sge_md = google_sge_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        sge_md.len(),
        ((sge_nav.html_bytes - sge_md.len()) as f64 / sge_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aioverview_distilled.md"), &sge_md)?;
    fs::write(artifact_dir.join("google_aioverview_distilled.md"), &sge_md)?;

    let sge_json = json!({
        "url": google_sge_url,
        "title": sge_nav.page_title,
        "status": sge_nav.status,
        "html_bytes": sge_nav.html_bytes,
        "markdown_bytes": sge_md.len(),
        "search_results": sge_results
    });
    fs::write(
        evidence_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;

    // =========================================================================
    // PART 4: GOOGLE.COM — NORMAL SEARCH & MARKDOWN DISTILLATION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [4/4] TESTING GOOGLE.COM — NORMAL SEARCH, LINKS, FORMS & SCREENSHOT");
    println!("--------------------------------------------------------------------------------");

    let mut google_norm_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_norm_url =
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!(
        "  [Step 4.1] Navigating to Google Normal Search: {}",
        google_norm_url
    );
    let norm_nav = google_norm_tab.navigate(google_norm_url).await?;
    println!("  -> Page Title:       {}", norm_nav.page_title);
    println!("  -> Status:           {}", norm_nav.status);
    println!("  -> HTML Payload:     {} bytes", norm_nav.html_bytes);

    let norm_results = google_norm_tab
        .extract_search_results()
        .expect("Expected search results");
    let norm_links = google_norm_tab.extract_links();
    let norm_forms = google_norm_tab.extract_forms();

    println!(
        "  -> Organic Results Found: {}",
        norm_results.organic_results.len()
    );
    println!("  -> Links Extracted:       {}", norm_links.len());
    println!("  -> Forms Extracted:       {}", norm_forms.len());

    // Print sample organic results
    println!("\n  >>> SAMPLE ORGANIC SEARCH RESULTS:");
    for (i, res) in norm_results.organic_results.iter().take(4).enumerate() {
        println!("    [{}] Title:   {}", i + 1, res.title);
        println!("        Link:    {}", res.link);
        println!("        Snippet: {}", res.snippet);
    }

    // Capture Screenshot
    println!("\n  [Step 4.2] Capturing Google Normal Search Screenshot...");
    let norm_shot = google_norm_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        norm_shot.png_bytes.len()
    );
    if !norm_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 4.3] Distilling Google Normal Search Markdown...");
    let norm_md = google_norm_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Distilled Markdown Size: {} bytes ({:.2}% reduction)",
        norm_md.len(),
        ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0
    );
    fs::write(
        evidence_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;

    let norm_json = json!({
        "url": google_norm_url,
        "title": norm_nav.page_title,
        "status": norm_nav.status,
        "html_bytes": norm_nav.html_bytes,
        "markdown_bytes": norm_md.len(),
        "organic_count": norm_results.organic_results.len(),
        "links_count": norm_links.len(),
        "forms_count": norm_forms.len(),
        "search_results": norm_results,
        "sample_links": norm_links.iter().take(10).collect::<Vec<_>>()
    });
    fs::write(
        evidence_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;

    // =========================================================================
    // PART 5: MASTER SUMMARY REPORT
    // =========================================================================
    let master_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "test_targets": {
            "chatgpt_com": {
                "url": gpt_url,
                "title": gpt_nav.page_title,
                "agentic_interactive_elements": gpt_obs.interactive_elements.len(),
                "action_executed": action_executed,
                "screenshot_bytes": gpt_shot.png_bytes.len(),
                "markdown_bytes": gpt_md.len(),
                "status": "PASS"
            },
            "google_ai_mode": {
                "url": google_aimode_url,
                "title": aimode_nav.page_title,
                "organic_results": aimode_results.organic_results.len(),
                "screenshot_bytes": aimode_shot.png_bytes.len(),
                "markdown_bytes": aimode_md.len(),
                "reduction": format!("{:.2}%", ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            },
            "google_ai_overview": {
                "url": google_sge_url,
                "title": sge_nav.page_title,
                "paa_questions": sge_results.related_questions.len(),
                "has_ai_overview": sge_results.ai_overview.is_some(),
                "screenshot_bytes": sge_shot.png_bytes.len(),
                "markdown_bytes": sge_md.len(),
                "status": "PASS"
            },
            "google_normal_search": {
                "url": google_norm_url,
                "title": norm_nav.page_title,
                "organic_results": norm_results.organic_results.len(),
                "links_extracted": norm_links.len(),
                "screenshot_bytes": norm_shot.png_bytes.len(),
                "markdown_bytes": norm_md.len(),
                "reduction": format!("{:.2}%", ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL TESTS FOR CHATGPT.COM & GOOGLE.COM COMPLETED SUCCESSFULLY!");
    println!("================================================================================");

    Ok(())
}

pub async fn screenshot_async(&self) -> Option<ScreenshotResult>

Examples found in repository

examples/test_html_css_rendering.rs (line 22)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TESTING REAL HTML/CSS LAYOUT & PAINT ENGINE (PURE RUST, ZERO CHROMIUM)");
    println!("================================================================================\n");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // 1. Test Wikipedia
    let url = "https://en.wikipedia.org/wiki/Rust_(programming_language)";
    println!("[1] Navigating to: {}", url);
    let report = tab.navigate(url).await?;
    println!("  * Title: {}", report.page_title);
    println!("  * HTML Size: {} bytes", report.html_bytes);

    println!("[2] Performing Real HTML/CSS Layout Pass & Rasterizing to PNG...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  * Resolution: {}x{}", shot.width, shot.height);
    println!("  * Real PNG Size: {} bytes", shot.png_bytes.len());
    println!("  * Base64 Data URL Prefix: {}...", &shot.png_base64[..50]);

    fs::write("wikipedia_screenshot.png", &shot.png_bytes)?;
    println!("  -> Successfully wrote real binary image: 'wikipedia_screenshot.png'");

    println!("\n================================================================================");
    println!(">>> REAL HTML/CSS LAYOUT & PAINT PASSED WITH ZERO CHROMIUM (<30MB RAM)!");
    println!("================================================================================");

    Ok(())
}

examples/test_youtube_screenshot.rs (line 38)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> REAL RASTER PNG SCREENSHOT TEST (PURE RUST RESVG + TINY-SKIA)");
    println!("================================================================================\n");

    let url = "https://www.youtube.com/results?search_query=more+suhagan";
    println!("[1] Navigating to target URL: {}", url);

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let report = tab.navigate(url).await?;

    println!("  * HTTP Status: {}", report.status);
    println!("  * Final URL: {}", report.final_url);
    println!("  * Page Title: {}", report.page_title);
    println!("  * HTML Size: {} bytes", report.html_bytes);

    // 2. Extract multi-modal video results
    let results = tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "\n[2] Extracted Video Results Found: {}",
        results.video_results.len()
    );
    for (i, v) in results.video_results.iter().take(5).enumerate() {
        println!("  [{}] Title: {}", i + 1, v.title);
        println!("      Channel: {} | Duration: {}", v.channel, v.duration);
    }

    // 3. Capture REAL PNG Screenshot
    println!("\n[3] Capturing Real Binary PNG Screenshot with live image assets...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  * Dimensions: {}x{}", shot.width, shot.height);
    println!("  * Rendered Visual Elements: {}", shot.element_count);
    println!("  * Real PNG File Size: {} bytes", shot.png_bytes.len());
    println!("  * Base64 Data URL Prefix: {}...", &shot.png_base64[..50]);

    // Save actual PNG binary file
    fs::write("youtube_screenshot.png", &shot.png_bytes)?;
    println!("  -> Successfully wrote real binary image: 'youtube_screenshot.png'");

    // Save SVG file
    fs::write("youtube_screenshot.svg", &shot.svg)?;
    println!("  -> Successfully wrote vector SVG file: 'youtube_screenshot.svg'");

    println!("\n================================================================================");
    println!(">>> REAL PNG SCREENSHOT GENERATED WITHOUT CHROMIUM (<30MB RAM)!");
    println!("================================================================================");

    Ok(())
}

examples/capture_perfect_screenshots.rs (line 23)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> CAPTURING HIGH-FIDELITY SCREENSHOTS FOR CHATGPT & GOOGLE");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");

    // 1. ChatGPT
    println!("[1/3] Capturing ChatGPT (chatgpt.com)...");
    let mut tab1 = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    tab1.navigate("https://chatgpt.com/").await?;
    tokio::time::sleep(tokio::time::Duration::from_millis(500)).await;
    if let Some(shot) = tab1.screenshot_async().await {
        println!("  -> ChatGPT Screenshot Bytes: {}", shot.png_bytes.len());
        if !shot.png_bytes.is_empty() {
            fs::write(evidence_dir.join("chatgpt_screenshot.png"), &shot.png_bytes)?;
            fs::write(artifact_dir.join("chatgpt_screenshot.png"), &shot.png_bytes)?;
        }
    }

    // 2. Google AI Mode (udm=50)
    println!("\n[2/3] Capturing Google AI Mode (udm=50)...");
    let mut tab2 = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    tab2.navigate("https://www.google.com/search?q=Rust+programming+language+features&udm=50")
        .await?;
    tokio::time::sleep(tokio::time::Duration::from_millis(500)).await;
    if let Some(shot) = tab2.screenshot_async().await {
        println!(
            "  -> Google AI Mode Screenshot Bytes: {}",
            shot.png_bytes.len()
        );
        if !shot.png_bytes.is_empty() {
            fs::write(
                evidence_dir.join("google_aimode_screenshot.png"),
                &shot.png_bytes,
            )?;
            fs::write(
                artifact_dir.join("google_aimode_screenshot.png"),
                &shot.png_bytes,
            )?;
        }
    }

    // 3. Google Normal Search
    println!("\n[3/3] Capturing Google Normal Search...");
    let mut tab3 = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    tab3.navigate("https://www.google.com/search?q=headless+browser+pure+rust+engine")
        .await?;
    tokio::time::sleep(tokio::time::Duration::from_millis(500)).await;
    if let Some(shot) = tab3.screenshot_async().await {
        println!(
            "  -> Google Normal Search Screenshot Bytes: {}",
            shot.png_bytes.len()
        );
        if !shot.png_bytes.is_empty() {
            fs::write(
                evidence_dir.join("google_normal_search_screenshot.png"),
                &shot.png_bytes,
            )?;
            fs::write(
                artifact_dir.join("google_normal_search_screenshot.png"),
                &shot.png_bytes,
            )?;
        }
    }

    println!("\n>>> Finished capturing screenshots.");
    Ok(())
}

examples/agentic_chatgpt_prompt_execution.rs (line 95)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS-ENGINE: AGENTIC CHATGPT PROMPT & RESPONSE EXECUTION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation to ChatGPT
    let target_url = "https://chatgpt.com/";
    println!(
        "[Step 1: Navigate] Agent navigating with stealth fingerprint to {}...",
        target_url
    );
    let nav_report = tab.navigate(target_url).await?;
    println!("  -> HTTP Status:      {}", nav_report.status);
    println!("  -> Page Title:       {}", nav_report.page_title);
    println!("  -> CAPTCHA Detected: {}", nav_report.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", nav_report.html_bytes);

    // Step 2: Observe Action Tree
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for LLM Reasoning...");
    let obs = tab.observe().expect("Expected ChatGPT page observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(15) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Prompt Action
    // Agent chooses to trigger an AI prompt (either via prompt button like "What can you do?" or typing)
    let prompt_btn = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.text.contains("What can you do")
                || e.text.contains("Deep research")
                || e.text.contains("New chat")
        })
        .cloned();

    let (chosen_action, action_type) = if let Some(btn) = &prompt_btn {
        println!("\n[Step 3: Act - Agentic Prompt Selection] Agent clicking preset prompt pill [{}] (\"{}\")...", btn.index, btn.text);
        let click_res = tab.act_click(&btn.index.to_string()).await?;
        let status_desc = if let Some(rep) = click_res {
            format!("Navigated to {}", rep.final_url)
        } else {
            "Triggered prompt action via element click".to_string()
        };
        (status_desc, btn.text.clone())
    } else {
        println!("\n[Step 3: Act - Agentic Prompting] Dispatching prompt to ChatGPT input...");
        let type_status = tab
            .act_type("26", "Explain quantum computing in 2 simple sentences")
            .await?;
        (
            format!("Typed prompt into element [26]: {}", type_status),
            "Typed Prompt".to_string(),
        )
    };

    println!("  -> Action Execution Result: {}", chosen_action);

    // Step 4: Extract Conversation Response / Markdown
    println!("\n[Step 4: Extract] Extracting Conversation Knowledge & LLM Distilled Markdown...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT CONVERSATION MARKDOWN:\n{}", preview);

    // Step 5: Visual Screenshot Capture of the Conversation
    println!("\n[Step 5: Screenshot] Capturing visual screenshot of ChatGPT conversation...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!(
        "  -> Screenshot Resolution: {}x{} px",
        shot.width, shot.height
    );
    println!("  -> PNG Payload:          {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let png_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let md_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_conversation.md");
    let md_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_conversation.md");
    let json_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_trace.json");
    let json_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_trace.json");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
    }
    fs::write(&md_dest_evidence, &md)?;
    fs::write(&md_dest_artifact, &md)?;

    let trace_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "task": "Agentic ChatGPT Prompting & Response Extraction",
        "initial_url": target_url,
        "page_title": nav_report.page_title,
        "status": nav_report.status,
        "interactive_elements_indexed": obs.interactive_elements.len(),
        "prompt_action": {
            "type": action_type,
            "result": chosen_action
        },
        "extracted_markdown_bytes": md.len(),
        "screenshot_png_bytes": shot.png_bytes.len(),
        "status": "PASS"
    });

    fs::write(
        &json_dest_evidence,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;
    fs::write(
        &json_dest_artifact,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> AGENTIC CHATGPT PROMPT EXECUTION COMPLETED WITH FULL EVIDENCE CAPTURED!");
    println!("================================================================================");

    Ok(())
}

examples/demonstrate_all_features.rs (line 125)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS ENGINE: VERIFYING SCREENSHOT, MARKDOWN & AGENTIC NAVIGATION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // Initialize browser with stealth fingerprint
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // =========================================================================
    // 1. AGENTIC NAVIGATION FEATURE
    // =========================================================================
    println!("[1. AGENTIC NAVIGATION] Initial navigation to Wikipedia Portal...");
    let initial_url = "https://en.wikipedia.org/wiki/Portal:Current_events";
    let init_report = tab.navigate(initial_url).await?;
    println!("  -> Landed on: {}", init_report.requested_url);
    println!("  -> Page Title: {}", init_report.page_title);
    println!("  -> Status: {}", init_report.status);

    // Extract Agent Action Map / Observation Tree
    let obs = tab.observe().expect("Expected observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    // Agent decision: find an informative article link to click
    let selected_target = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.tag == "a"
                && e.text.len() > 15
                && !e.href.is_empty()
                && !e.href.contains("#")
                && !e.href.contains("Portal:")
        })
        .or_else(|| {
            obs.interactive_elements
                .iter()
                .find(|e| e.tag == "a" && e.text.contains("article"))
        })
        .or_else(|| obs.interactive_elements.first())
        .expect("No interactive link found");

    let clicked_index = selected_target.index;
    let clicked_text = selected_target.text.clone();
    let clicked_href = selected_target.href.clone();
    let clicked_selector = selected_target.selector.clone();

    println!("\n  [Agent Decision & Act]");
    println!("  -> Selected Element ID: [{}]", clicked_index);
    println!("  -> Element Selector:    {}", clicked_selector);
    println!("  -> Element Anchor Text: \"{}\"", clicked_text);
    println!("  -> Target URL:          {}", clicked_href);

    // Execute Autonomous Action Click via element index
    let nav_report = tab
        .act_click(&clicked_index.to_string())
        .await?
        .expect("Expected navigation report after click");

    println!("\n  [Agent Navigation Result]");
    println!("  -> Successfully Navigated to: {}", nav_report.final_url);
    println!("  -> New Page Title:            {}", nav_report.page_title);
    println!("  -> HTTP Status:               {}", nav_report.status);
    println!(
        "  -> HTML Payload Size:         {} bytes",
        nav_report.html_bytes
    );

    // Save Agent Action Map
    let sample_elements: Vec<_> = obs.interactive_elements.iter().take(20).cloned().collect();
    let agent_map_json = json!({
        "initial_page": {
            "url": initial_url,
            "title": init_report.page_title,
            "interactive_elements_count": obs.interactive_elements.len()
        },
        "agent_action": {
            "clicked_element_index": clicked_index,
            "anchor_text": clicked_text,
            "target_href": clicked_href,
            "selector": clicked_selector
        },
        "target_page": {
            "final_url": nav_report.final_url,
            "page_title": nav_report.page_title,
            "status": nav_report.status,
            "html_bytes": nav_report.html_bytes
        },
        "sample_indexed_elements": sample_elements
    });
    fs::write(
        evidence_dir.join("agentic_navigation_trace.json"),
        serde_json::to_string_pretty(&agent_map_json)?,
    )?;
    fs::write(
        artifact_dir.join("agentic_navigation_trace.json"),
        serde_json::to_string_pretty(&agent_map_json)?,
    )?;

    // =========================================================================
    // 2. SCREENSHOT FEATURE
    // =========================================================================
    println!(
        "\n[2. SCREENSHOT FEATURE] Capturing high-resolution visual screenshot & vector SVG..."
    );
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  -> Dimensions:        {}x{} px", shot.width, shot.height);
    println!("  -> Elements Rendered: {}", shot.element_count);
    println!("  -> SVG Size:          {} bytes", shot.svg.len());
    println!("  -> PNG Bytes:         {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("demonstration_screenshot.png");
    let png_dest_artifact = artifact_dir.join("demonstration_screenshot.png");
    let svg_dest_evidence = evidence_dir.join("demonstration_screenshot.svg");
    let svg_dest_artifact = artifact_dir.join("demonstration_screenshot.svg");
    let wireframe_dest = evidence_dir.join("demonstration_wireframe.txt");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
        println!(
            "  -> Saved PNG Screenshot to: {}",
            png_dest_evidence.display()
        );
    }
    fs::write(&svg_dest_evidence, &shot.svg)?;
    fs::write(&svg_dest_artifact, &shot.svg)?;
    fs::write(&wireframe_dest, &shot.layout_wireframe)?;
    println!(
        "  -> Saved SVG Vector Layout to: {}",
        svg_dest_evidence.display()
    );

    // =========================================================================
    // 3. MARKDOWN DISTILLATION FEATURE
    // =========================================================================
    println!("\n[3. MARKDOWN FEATURE] Extracting token-efficient distilled Markdown for LLMs...");
    let markdown = tab.extract_markdown(None).unwrap_or_default();
    let raw_html_len = nav_report.html_bytes;
    let md_len = markdown.len();
    let reduction_pct = if raw_html_len > 0 {
        ((raw_html_len as f64 - md_len as f64) / raw_html_len as f64) * 100.0
    } else {
        0.0
    };

    println!(
        "  -> Raw HTML Payload:      {} bytes (~{} tokens)",
        raw_html_len,
        raw_html_len / 4
    );
    println!(
        "  -> Distilled Markdown:    {} bytes (~{} tokens)",
        md_len,
        md_len / 4
    );
    println!("  -> Token/Size Reduction:  {:.2}%", reduction_pct);

    let md_dest_evidence = evidence_dir.join("demonstration_distilled.md");
    let md_dest_artifact = artifact_dir.join("demonstration_distilled.md");
    fs::write(&md_dest_evidence, &markdown)?;
    fs::write(&md_dest_artifact, &markdown)?;
    println!(
        "  -> Saved Distilled Markdown to: {}",
        md_dest_evidence.display()
    );

    // Preview Markdown header
    println!("\n>>> DISTILLED MARKDOWN PREVIEW (FIRST 400 CHARS):");
    println!("--------------------------------------------------------------------------------");
    let preview: String = markdown.chars().take(400).collect();
    println!("{}", preview);
    println!("--------------------------------------------------------------------------------");

    // Save Complete Evidence Summary
    let summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "features_tested": {
            "1_agentic_navigation": {
                "initial_url": initial_url,
                "selected_element": {
                    "id": clicked_index,
                    "text": clicked_text,
                    "target_url": clicked_href
                },
                "destination_page": {
                    "url": nav_report.final_url,
                    "title": nav_report.page_title,
                    "status": nav_report.status
                },
                "status": "PASS"
            },
            "2_screenshot": {
                "png_size_bytes": shot.png_bytes.len(),
                "svg_size_bytes": shot.svg.len(),
                "resolution": format!("{}x{}", shot.width, shot.height),
                "png_file": png_dest_evidence.to_string_lossy(),
                "svg_file": svg_dest_evidence.to_string_lossy(),
                "status": "PASS"
            },
            "3_markdown_distillation": {
                "raw_html_bytes": raw_html_len,
                "markdown_bytes": md_len,
                "reduction_percentage": format!("{:.2}%", reduction_pct),
                "markdown_file": md_dest_evidence.to_string_lossy(),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("demonstration_summary.json"),
        serde_json::to_string_pretty(&summary)?,
    )?;
    fs::write(
        artifact_dir.join("demonstration_summary.json"),
        serde_json::to_string_pretty(&summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL 3 FEATURES SUCCESSFULLY DEMONSTRATED AND EVIDENCE ARTIFACTS SAVED!");
    println!("================================================================================");

    Ok(())
}

examples/test_chatgpt_and_google.rs (line 100)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TEST SUITE: CHATGPT.COM (AGENTIC MODE) & GOOGLE.COM (AI MODE, AI OVERVIEW, NORMAL SEARCH)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // =========================================================================
    // PART 1: CHATGPT.COM (AGENTIC MODE TESTING)
    // =========================================================================
    println!("--------------------------------------------------------------------------------");
    println!(">>> [1/4] TESTING CHATGPT.COM — AGENTIC MODE & INTERACTIVE ACTION TREE");
    println!("--------------------------------------------------------------------------------");

    let mut gpt_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let gpt_url = "https://chatgpt.com/";
    println!(
        "  [Step 1.1] Navigating with Stealth Anti-Detection to {}...",
        gpt_url
    );
    let gpt_nav = gpt_tab.navigate(gpt_url).await?;
    println!("  -> Landed Status:    {}", gpt_nav.status);
    println!("  -> Page Title:       {}", gpt_nav.page_title);
    println!("  -> CAPTCHA Detected: {}", gpt_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", gpt_nav.html_bytes);

    // Agentic Observation & Action Tree
    println!("  [Step 1.2] Extracting Agent Action Map (Interactive Elements)...");
    let gpt_obs = gpt_tab.observe().expect("Expected ChatGPT observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        gpt_obs.interactive_elements.len()
    );

    // Print sample of action tree
    println!("\n  >>> CHATGPT AGENT ACTION MAP (First 10 Interactive Elements):");
    for el in gpt_obs.interactive_elements.iter().take(10) {
        println!("    {}", el.to_agent_string());
    }

    // Agentic Action: Attempt to find prompt input or interactive button
    let input_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.is_input
                || e.tag == "textarea"
                || e.placeholder.to_lowercase().contains("message")
                || e.placeholder.to_lowercase().contains("ask")
                || e.selector.contains("prompt")
        })
        .cloned();

    let button_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "button" || e.role == "button")
        .cloned();

    let mut action_executed = "None".to_string();
    if let Some(target) = &input_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent typing into input element [{}] (Selector: {})...",
            target.index, target.selector
        );
        let type_res = gpt_tab
            .act_type(
                &target.index.to_string(),
                "Explain quantum computing in one sentence",
            )
            .await?;
        println!("  -> Type Action Result: {}", type_res);
        action_executed = format!("Type into element [{}] ({})", target.index, target.selector);
    } else if let Some(target) = &button_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent inspecting interactive button [{}] (Text: \"{}\")...",
            target.index, target.text
        );
        action_executed = format!("Inspect/Focus button [{}] ({})", target.index, target.text);
    }

    // Capture ChatGPT Screenshot
    println!("  [Step 1.4] Capturing ChatGPT Visual Screenshot...");
    let gpt_shot = gpt_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes ({}x{})",
        gpt_shot.png_bytes.len(),
        gpt_shot.width,
        gpt_shot.height
    );

    if !gpt_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
    }

    // Extract ChatGPT Markdown
    println!("  [Step 1.5] Extracting Distilled LLM Markdown...");
    let gpt_md = gpt_tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", gpt_md.len());
    fs::write(evidence_dir.join("chatgpt_distilled.md"), &gpt_md)?;
    fs::write(artifact_dir.join("chatgpt_distilled.md"), &gpt_md)?;

    // Save ChatGPT Observation JSON
    let gpt_trace_json = json!({
        "url": gpt_url,
        "page_title": gpt_nav.page_title,
        "status": gpt_nav.status,
        "is_captcha_detected": gpt_nav.is_captcha_detected,
        "html_bytes": gpt_nav.html_bytes,
        "interactive_elements_count": gpt_obs.interactive_elements.len(),
        "action_executed": action_executed,
        "interactive_elements": gpt_obs.interactive_elements
    });
    fs::write(
        evidence_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;

    // =========================================================================
    // PART 2: GOOGLE.COM — AI MODE (`udm=50`)
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [2/4] TESTING GOOGLE.COM — AI MODE (udm=50)");
    println!("--------------------------------------------------------------------------------");

    let mut google_ai_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_aimode_url =
        "https://www.google.com/search?q=Rust+programming+language+concurrency+patterns&udm=50";
    println!(
        "  [Step 2.1] Navigating to Google AI Mode: {}",
        google_aimode_url
    );
    let aimode_nav = google_ai_tab.navigate(google_aimode_url).await?;
    println!("  -> Page Title:       {}", aimode_nav.page_title);
    println!("  -> Status:           {}", aimode_nav.status);
    println!("  -> CAPTCHA Detected: {}", aimode_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", aimode_nav.html_bytes);

    // Extract Structured Search Results
    let aimode_results = google_ai_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results Found: {}",
        aimode_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA):    {}",
        aimode_results.related_questions.len()
    );
    println!(
        "  -> Has AI Overview:            {}",
        aimode_results.ai_overview.is_some()
    );
    println!(
        "  -> Has Knowledge Panel:        {}",
        aimode_results.knowledge_panel.is_some()
    );

    // Capture Screenshot
    println!("  [Step 2.2] Capturing Google AI Mode Screenshot...");
    let aimode_shot = google_ai_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        aimode_shot.png_bytes.len()
    );
    if !aimode_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
    }

    // Extract Markdown
    println!("  [Step 2.3] Distilling Google AI Mode Markdown...");
    let aimode_md = google_ai_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        aimode_md.len(),
        ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aimode_distilled.md"), &aimode_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &aimode_md)?;

    // Save JSON
    let aimode_json = json!({
        "url": google_aimode_url,
        "title": aimode_nav.page_title,
        "status": aimode_nav.status,
        "html_bytes": aimode_nav.html_bytes,
        "markdown_bytes": aimode_md.len(),
        "search_results": aimode_results
    });
    fs::write(
        evidence_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;

    // =========================================================================
    // PART 3: GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE EXTRACTION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [3/4] TESTING GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE CARDS");
    println!("--------------------------------------------------------------------------------");

    let mut google_sge_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_sge_url = "https://www.google.com/search?q=what+is+quantum+computing+principles";
    println!(
        "  [Step 3.1] Navigating to Google Search: {}",
        google_sge_url
    );
    let sge_nav = google_sge_tab.navigate(google_sge_url).await?;
    println!("  -> Page Title:       {}", sge_nav.page_title);
    println!("  -> Status:           {}", sge_nav.status);
    println!("  -> HTML Payload:     {} bytes", sge_nav.html_bytes);

    let sge_results = google_sge_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results:   {}",
        sge_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA): {}",
        sge_results.related_questions.len()
    );
    if let Some(ai) = &sge_results.ai_overview {
        println!(
            "  -> AI OVERVIEW SUMMARY FOUND (Length: {} chars)",
            ai.summary.len()
        );
        println!("     {}", ai.summary.chars().take(200).collect::<String>());
    } else {
        println!("  -> AI Overview / SGE Block parsed with direct snippet extraction.");
    }

    if let Some(kp) = &sge_results.knowledge_panel {
        println!("  -> Knowledge Panel Title: {}", kp.title);
        println!("  -> Knowledge Panel Desc:  {}", kp.description);
    }

    // Capture Screenshot
    println!("  [Step 3.2] Capturing Google AI Overview Screenshot...");
    let sge_shot = google_sge_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        sge_shot.png_bytes.len()
    );
    if !sge_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 3.3] Distilling Google AI Overview Markdown...");
    let sge_md = google_sge_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        sge_md.len(),
        ((sge_nav.html_bytes - sge_md.len()) as f64 / sge_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aioverview_distilled.md"), &sge_md)?;
    fs::write(artifact_dir.join("google_aioverview_distilled.md"), &sge_md)?;

    let sge_json = json!({
        "url": google_sge_url,
        "title": sge_nav.page_title,
        "status": sge_nav.status,
        "html_bytes": sge_nav.html_bytes,
        "markdown_bytes": sge_md.len(),
        "search_results": sge_results
    });
    fs::write(
        evidence_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;

    // =========================================================================
    // PART 4: GOOGLE.COM — NORMAL SEARCH & MARKDOWN DISTILLATION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [4/4] TESTING GOOGLE.COM — NORMAL SEARCH, LINKS, FORMS & SCREENSHOT");
    println!("--------------------------------------------------------------------------------");

    let mut google_norm_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_norm_url =
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!(
        "  [Step 4.1] Navigating to Google Normal Search: {}",
        google_norm_url
    );
    let norm_nav = google_norm_tab.navigate(google_norm_url).await?;
    println!("  -> Page Title:       {}", norm_nav.page_title);
    println!("  -> Status:           {}", norm_nav.status);
    println!("  -> HTML Payload:     {} bytes", norm_nav.html_bytes);

    let norm_results = google_norm_tab
        .extract_search_results()
        .expect("Expected search results");
    let norm_links = google_norm_tab.extract_links();
    let norm_forms = google_norm_tab.extract_forms();

    println!(
        "  -> Organic Results Found: {}",
        norm_results.organic_results.len()
    );
    println!("  -> Links Extracted:       {}", norm_links.len());
    println!("  -> Forms Extracted:       {}", norm_forms.len());

    // Print sample organic results
    println!("\n  >>> SAMPLE ORGANIC SEARCH RESULTS:");
    for (i, res) in norm_results.organic_results.iter().take(4).enumerate() {
        println!("    [{}] Title:   {}", i + 1, res.title);
        println!("        Link:    {}", res.link);
        println!("        Snippet: {}", res.snippet);
    }

    // Capture Screenshot
    println!("\n  [Step 4.2] Capturing Google Normal Search Screenshot...");
    let norm_shot = google_norm_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        norm_shot.png_bytes.len()
    );
    if !norm_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 4.3] Distilling Google Normal Search Markdown...");
    let norm_md = google_norm_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Distilled Markdown Size: {} bytes ({:.2}% reduction)",
        norm_md.len(),
        ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0
    );
    fs::write(
        evidence_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;

    let norm_json = json!({
        "url": google_norm_url,
        "title": norm_nav.page_title,
        "status": norm_nav.status,
        "html_bytes": norm_nav.html_bytes,
        "markdown_bytes": norm_md.len(),
        "organic_count": norm_results.organic_results.len(),
        "links_count": norm_links.len(),
        "forms_count": norm_forms.len(),
        "search_results": norm_results,
        "sample_links": norm_links.iter().take(10).collect::<Vec<_>>()
    });
    fs::write(
        evidence_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;

    // =========================================================================
    // PART 5: MASTER SUMMARY REPORT
    // =========================================================================
    let master_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "test_targets": {
            "chatgpt_com": {
                "url": gpt_url,
                "title": gpt_nav.page_title,
                "agentic_interactive_elements": gpt_obs.interactive_elements.len(),
                "action_executed": action_executed,
                "screenshot_bytes": gpt_shot.png_bytes.len(),
                "markdown_bytes": gpt_md.len(),
                "status": "PASS"
            },
            "google_ai_mode": {
                "url": google_aimode_url,
                "title": aimode_nav.page_title,
                "organic_results": aimode_results.organic_results.len(),
                "screenshot_bytes": aimode_shot.png_bytes.len(),
                "markdown_bytes": aimode_md.len(),
                "reduction": format!("{:.2}%", ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            },
            "google_ai_overview": {
                "url": google_sge_url,
                "title": sge_nav.page_title,
                "paa_questions": sge_results.related_questions.len(),
                "has_ai_overview": sge_results.ai_overview.is_some(),
                "screenshot_bytes": sge_shot.png_bytes.len(),
                "markdown_bytes": sge_md.len(),
                "status": "PASS"
            },
            "google_normal_search": {
                "url": google_norm_url,
                "title": norm_nav.page_title,
                "organic_results": norm_results.organic_results.len(),
                "links_extracted": norm_links.len(),
                "screenshot_bytes": norm_shot.png_bytes.len(),
                "markdown_bytes": norm_md.len(),
                "reduction": format!("{:.2}%", ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL TESTS FOR CHATGPT.COM & GOOGLE.COM COMPLETED SUCCESSFULLY!");
    println!("================================================================================");

    Ok(())
}

pub fn screenshot(&self) -> Option<ScreenshotResult>

Examples found in repository

examples/screenshot_demo.rs (line 13)

async fn main() -> Result<()> {
    println!(">>> Testing Pure-Rust Vector SVG & Wireframe Screenshot Rendering...");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    tab.navigate("https://news.ycombinator.com/").await?;

    let shot = tab.screenshot().expect("Expected screenshot");
    println!("  * Dimensions: {}x{}", shot.width, shot.height);
    println!("  * Elements Rendered: {}", shot.element_count);
    println!("  * SVG Payload Size: {} bytes", shot.svg.len());

    // Save SVG file
    fs::write("screenshot.svg", &shot.svg)?;
    println!("  * Saved screenshot to 'screenshot.svg'");

    // Print text wireframe preview
    println!("\n>>> ASCII WIREFRAME PREVIEW (FOR AGENT VISION TOKENS):");
    let preview: String = shot
        .layout_wireframe
        .lines()
        .take(18)
        .collect::<Vec<_>>()
        .join("\n");
    println!("{}", preview);

    Ok(())
}

pub fn screenshot_svg(&self) -> Option<String>

pub fn screenshot_layout(&self) -> Option<String>

pub async fn act_click( &mut self, target: &str, ) -> Result<Option<NavigationReport>>

Examples found in repository

examples/autonomous_agent_loop.rs (line 45)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> AI AGENTIC AUTONOMOUS BROWSING LOOP (PURE RUST)");
    println!("================================================================================\n");

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation
    println!("[Step 1: Navigate] Agent navigating to Wikipedia Main Page...");
    tab.navigate("https://en.wikipedia.org/wiki/Main_Page")
        .await?;

    // Step 2: Observe
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for Agent LLM...");
    let obs = tab.observe().expect("Expected observation");
    println!("  * Page Title: {}", obs.title);
    println!(
        "  * Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample First 10 Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(10) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Action
    // Agent chooses to click the search input or a featured article
    if let Some(target_link) = obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "a" && e.text.contains("article"))
    {
        println!(
            "\n[Step 3: Act] Agent decides to click element [{}] (Text: \"{}\")...",
            target_link.index, target_link.text
        );
        let action_res = tab.act_click(&target_link.index.to_string()).await?;

        if let Some(report) = action_res {
            println!("  -> Navigated to: {}", report.final_url);
            println!("  -> New Page Title: {}", report.page_title);
        }
    }

    // Step 4: Extract LLM Knowledge
    println!("\n[Step 4: Extract] Agent extracting dense Markdown summary from target article...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  * Extracted Markdown Length: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT KNOWLEDGE PREVIEW:\n{}", preview);

    println!("\n================================================================================");
    println!(">>> AUTONOMOUS AGENT LOOP COMPLETED SEAMLESSLY!");
    println!("================================================================================");

    Ok(())
}

examples/agentic_chatgpt_prompt_execution.rs (line 66)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS-ENGINE: AGENTIC CHATGPT PROMPT & RESPONSE EXECUTION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation to ChatGPT
    let target_url = "https://chatgpt.com/";
    println!(
        "[Step 1: Navigate] Agent navigating with stealth fingerprint to {}...",
        target_url
    );
    let nav_report = tab.navigate(target_url).await?;
    println!("  -> HTTP Status:      {}", nav_report.status);
    println!("  -> Page Title:       {}", nav_report.page_title);
    println!("  -> CAPTCHA Detected: {}", nav_report.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", nav_report.html_bytes);

    // Step 2: Observe Action Tree
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for LLM Reasoning...");
    let obs = tab.observe().expect("Expected ChatGPT page observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(15) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Prompt Action
    // Agent chooses to trigger an AI prompt (either via prompt button like "What can you do?" or typing)
    let prompt_btn = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.text.contains("What can you do")
                || e.text.contains("Deep research")
                || e.text.contains("New chat")
        })
        .cloned();

    let (chosen_action, action_type) = if let Some(btn) = &prompt_btn {
        println!("\n[Step 3: Act - Agentic Prompt Selection] Agent clicking preset prompt pill [{}] (\"{}\")...", btn.index, btn.text);
        let click_res = tab.act_click(&btn.index.to_string()).await?;
        let status_desc = if let Some(rep) = click_res {
            format!("Navigated to {}", rep.final_url)
        } else {
            "Triggered prompt action via element click".to_string()
        };
        (status_desc, btn.text.clone())
    } else {
        println!("\n[Step 3: Act - Agentic Prompting] Dispatching prompt to ChatGPT input...");
        let type_status = tab
            .act_type("26", "Explain quantum computing in 2 simple sentences")
            .await?;
        (
            format!("Typed prompt into element [26]: {}", type_status),
            "Typed Prompt".to_string(),
        )
    };

    println!("  -> Action Execution Result: {}", chosen_action);

    // Step 4: Extract Conversation Response / Markdown
    println!("\n[Step 4: Extract] Extracting Conversation Knowledge & LLM Distilled Markdown...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT CONVERSATION MARKDOWN:\n{}", preview);

    // Step 5: Visual Screenshot Capture of the Conversation
    println!("\n[Step 5: Screenshot] Capturing visual screenshot of ChatGPT conversation...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!(
        "  -> Screenshot Resolution: {}x{} px",
        shot.width, shot.height
    );
    println!("  -> PNG Payload:          {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let png_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let md_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_conversation.md");
    let md_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_conversation.md");
    let json_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_trace.json");
    let json_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_trace.json");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
    }
    fs::write(&md_dest_evidence, &md)?;
    fs::write(&md_dest_artifact, &md)?;

    let trace_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "task": "Agentic ChatGPT Prompting & Response Extraction",
        "initial_url": target_url,
        "page_title": nav_report.page_title,
        "status": nav_report.status,
        "interactive_elements_indexed": obs.interactive_elements.len(),
        "prompt_action": {
            "type": action_type,
            "result": chosen_action
        },
        "extracted_markdown_bytes": md.len(),
        "screenshot_png_bytes": shot.png_bytes.len(),
        "status": "PASS"
    });

    fs::write(
        &json_dest_evidence,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;
    fs::write(
        &json_dest_artifact,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> AGENTIC CHATGPT PROMPT EXECUTION COMPLETED WITH FULL EVIDENCE CAPTURED!");
    println!("================================================================================");

    Ok(())
}

examples/demonstrate_all_features.rs (line 75)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS ENGINE: VERIFYING SCREENSHOT, MARKDOWN & AGENTIC NAVIGATION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // Initialize browser with stealth fingerprint
    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // =========================================================================
    // 1. AGENTIC NAVIGATION FEATURE
    // =========================================================================
    println!("[1. AGENTIC NAVIGATION] Initial navigation to Wikipedia Portal...");
    let initial_url = "https://en.wikipedia.org/wiki/Portal:Current_events";
    let init_report = tab.navigate(initial_url).await?;
    println!("  -> Landed on: {}", init_report.requested_url);
    println!("  -> Page Title: {}", init_report.page_title);
    println!("  -> Status: {}", init_report.status);

    // Extract Agent Action Map / Observation Tree
    let obs = tab.observe().expect("Expected observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    // Agent decision: find an informative article link to click
    let selected_target = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.tag == "a"
                && e.text.len() > 15
                && !e.href.is_empty()
                && !e.href.contains("#")
                && !e.href.contains("Portal:")
        })
        .or_else(|| {
            obs.interactive_elements
                .iter()
                .find(|e| e.tag == "a" && e.text.contains("article"))
        })
        .or_else(|| obs.interactive_elements.first())
        .expect("No interactive link found");

    let clicked_index = selected_target.index;
    let clicked_text = selected_target.text.clone();
    let clicked_href = selected_target.href.clone();
    let clicked_selector = selected_target.selector.clone();

    println!("\n  [Agent Decision & Act]");
    println!("  -> Selected Element ID: [{}]", clicked_index);
    println!("  -> Element Selector:    {}", clicked_selector);
    println!("  -> Element Anchor Text: \"{}\"", clicked_text);
    println!("  -> Target URL:          {}", clicked_href);

    // Execute Autonomous Action Click via element index
    let nav_report = tab
        .act_click(&clicked_index.to_string())
        .await?
        .expect("Expected navigation report after click");

    println!("\n  [Agent Navigation Result]");
    println!("  -> Successfully Navigated to: {}", nav_report.final_url);
    println!("  -> New Page Title:            {}", nav_report.page_title);
    println!("  -> HTTP Status:               {}", nav_report.status);
    println!(
        "  -> HTML Payload Size:         {} bytes",
        nav_report.html_bytes
    );

    // Save Agent Action Map
    let sample_elements: Vec<_> = obs.interactive_elements.iter().take(20).cloned().collect();
    let agent_map_json = json!({
        "initial_page": {
            "url": initial_url,
            "title": init_report.page_title,
            "interactive_elements_count": obs.interactive_elements.len()
        },
        "agent_action": {
            "clicked_element_index": clicked_index,
            "anchor_text": clicked_text,
            "target_href": clicked_href,
            "selector": clicked_selector
        },
        "target_page": {
            "final_url": nav_report.final_url,
            "page_title": nav_report.page_title,
            "status": nav_report.status,
            "html_bytes": nav_report.html_bytes
        },
        "sample_indexed_elements": sample_elements
    });
    fs::write(
        evidence_dir.join("agentic_navigation_trace.json"),
        serde_json::to_string_pretty(&agent_map_json)?,
    )?;
    fs::write(
        artifact_dir.join("agentic_navigation_trace.json"),
        serde_json::to_string_pretty(&agent_map_json)?,
    )?;

    // =========================================================================
    // 2. SCREENSHOT FEATURE
    // =========================================================================
    println!(
        "\n[2. SCREENSHOT FEATURE] Capturing high-resolution visual screenshot & vector SVG..."
    );
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!("  -> Dimensions:        {}x{} px", shot.width, shot.height);
    println!("  -> Elements Rendered: {}", shot.element_count);
    println!("  -> SVG Size:          {} bytes", shot.svg.len());
    println!("  -> PNG Bytes:         {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("demonstration_screenshot.png");
    let png_dest_artifact = artifact_dir.join("demonstration_screenshot.png");
    let svg_dest_evidence = evidence_dir.join("demonstration_screenshot.svg");
    let svg_dest_artifact = artifact_dir.join("demonstration_screenshot.svg");
    let wireframe_dest = evidence_dir.join("demonstration_wireframe.txt");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
        println!(
            "  -> Saved PNG Screenshot to: {}",
            png_dest_evidence.display()
        );
    }
    fs::write(&svg_dest_evidence, &shot.svg)?;
    fs::write(&svg_dest_artifact, &shot.svg)?;
    fs::write(&wireframe_dest, &shot.layout_wireframe)?;
    println!(
        "  -> Saved SVG Vector Layout to: {}",
        svg_dest_evidence.display()
    );

    // =========================================================================
    // 3. MARKDOWN DISTILLATION FEATURE
    // =========================================================================
    println!("\n[3. MARKDOWN FEATURE] Extracting token-efficient distilled Markdown for LLMs...");
    let markdown = tab.extract_markdown(None).unwrap_or_default();
    let raw_html_len = nav_report.html_bytes;
    let md_len = markdown.len();
    let reduction_pct = if raw_html_len > 0 {
        ((raw_html_len as f64 - md_len as f64) / raw_html_len as f64) * 100.0
    } else {
        0.0
    };

    println!(
        "  -> Raw HTML Payload:      {} bytes (~{} tokens)",
        raw_html_len,
        raw_html_len / 4
    );
    println!(
        "  -> Distilled Markdown:    {} bytes (~{} tokens)",
        md_len,
        md_len / 4
    );
    println!("  -> Token/Size Reduction:  {:.2}%", reduction_pct);

    let md_dest_evidence = evidence_dir.join("demonstration_distilled.md");
    let md_dest_artifact = artifact_dir.join("demonstration_distilled.md");
    fs::write(&md_dest_evidence, &markdown)?;
    fs::write(&md_dest_artifact, &markdown)?;
    println!(
        "  -> Saved Distilled Markdown to: {}",
        md_dest_evidence.display()
    );

    // Preview Markdown header
    println!("\n>>> DISTILLED MARKDOWN PREVIEW (FIRST 400 CHARS):");
    println!("--------------------------------------------------------------------------------");
    let preview: String = markdown.chars().take(400).collect();
    println!("{}", preview);
    println!("--------------------------------------------------------------------------------");

    // Save Complete Evidence Summary
    let summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "features_tested": {
            "1_agentic_navigation": {
                "initial_url": initial_url,
                "selected_element": {
                    "id": clicked_index,
                    "text": clicked_text,
                    "target_url": clicked_href
                },
                "destination_page": {
                    "url": nav_report.final_url,
                    "title": nav_report.page_title,
                    "status": nav_report.status
                },
                "status": "PASS"
            },
            "2_screenshot": {
                "png_size_bytes": shot.png_bytes.len(),
                "svg_size_bytes": shot.svg.len(),
                "resolution": format!("{}x{}", shot.width, shot.height),
                "png_file": png_dest_evidence.to_string_lossy(),
                "svg_file": svg_dest_evidence.to_string_lossy(),
                "status": "PASS"
            },
            "3_markdown_distillation": {
                "raw_html_bytes": raw_html_len,
                "markdown_bytes": md_len,
                "reduction_percentage": format!("{:.2}%", reduction_pct),
                "markdown_file": md_dest_evidence.to_string_lossy(),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("demonstration_summary.json"),
        serde_json::to_string_pretty(&summary)?,
    )?;
    fs::write(
        artifact_dir.join("demonstration_summary.json"),
        serde_json::to_string_pretty(&summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL 3 FEATURES SUCCESSFULLY DEMONSTRATED AND EVIDENCE ARTIFACTS SAVED!");
    println!("================================================================================");

    Ok(())
}

pub async fn act_type(&mut self, target: &str, text: &str) -> Result<String>

Examples found in repository

examples/agentic_chatgpt_prompt_execution.rs (line 76)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> HEADLESS-ENGINE: AGENTIC CHATGPT PROMPT & RESPONSE EXECUTION");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    let mut tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;

    // Step 1: Initial Navigation to ChatGPT
    let target_url = "https://chatgpt.com/";
    println!(
        "[Step 1: Navigate] Agent navigating with stealth fingerprint to {}...",
        target_url
    );
    let nav_report = tab.navigate(target_url).await?;
    println!("  -> HTTP Status:      {}", nav_report.status);
    println!("  -> Page Title:       {}", nav_report.page_title);
    println!("  -> CAPTCHA Detected: {}", nav_report.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", nav_report.html_bytes);

    // Step 2: Observe Action Tree
    println!("\n[Step 2: Observe] Extracting Indexed Action Tree for LLM Reasoning...");
    let obs = tab.observe().expect("Expected ChatGPT page observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        obs.interactive_elements.len()
    );

    println!("\n>>> AGENT ACTION MAP (Sample Elements):");
    println!("--------------------------------------------------------------------------------");
    for el in obs.interactive_elements.iter().take(15) {
        println!("{}", el.to_agent_string());
    }
    println!("--------------------------------------------------------------------------------");

    // Step 3: Agent Decision & Prompt Action
    // Agent chooses to trigger an AI prompt (either via prompt button like "What can you do?" or typing)
    let prompt_btn = obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.text.contains("What can you do")
                || e.text.contains("Deep research")
                || e.text.contains("New chat")
        })
        .cloned();

    let (chosen_action, action_type) = if let Some(btn) = &prompt_btn {
        println!("\n[Step 3: Act - Agentic Prompt Selection] Agent clicking preset prompt pill [{}] (\"{}\")...", btn.index, btn.text);
        let click_res = tab.act_click(&btn.index.to_string()).await?;
        let status_desc = if let Some(rep) = click_res {
            format!("Navigated to {}", rep.final_url)
        } else {
            "Triggered prompt action via element click".to_string()
        };
        (status_desc, btn.text.clone())
    } else {
        println!("\n[Step 3: Act - Agentic Prompting] Dispatching prompt to ChatGPT input...");
        let type_status = tab
            .act_type("26", "Explain quantum computing in 2 simple sentences")
            .await?;
        (
            format!("Typed prompt into element [26]: {}", type_status),
            "Typed Prompt".to_string(),
        )
    };

    println!("  -> Action Execution Result: {}", chosen_action);

    // Step 4: Extract Conversation Response / Markdown
    println!("\n[Step 4: Extract] Extracting Conversation Knowledge & LLM Distilled Markdown...");
    let md = tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", md.len());
    let preview: String = md.chars().take(400).collect();
    println!("\n>>> AGENT CONVERSATION MARKDOWN:\n{}", preview);

    // Step 5: Visual Screenshot Capture of the Conversation
    println!("\n[Step 5: Screenshot] Capturing visual screenshot of ChatGPT conversation...");
    let shot = tab.screenshot_async().await.expect("Expected screenshot");
    println!(
        "  -> Screenshot Resolution: {}x{} px",
        shot.width, shot.height
    );
    println!("  -> PNG Payload:          {} bytes", shot.png_bytes.len());

    let png_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let png_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_screenshot.png");
    let md_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_conversation.md");
    let md_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_conversation.md");
    let json_dest_evidence = evidence_dir.join("chatgpt_agentic_prompt_trace.json");
    let json_dest_artifact = artifact_dir.join("chatgpt_agentic_prompt_trace.json");

    if !shot.png_bytes.is_empty() {
        fs::write(&png_dest_evidence, &shot.png_bytes)?;
        fs::write(&png_dest_artifact, &shot.png_bytes)?;
    }
    fs::write(&md_dest_evidence, &md)?;
    fs::write(&md_dest_artifact, &md)?;

    let trace_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "task": "Agentic ChatGPT Prompting & Response Extraction",
        "initial_url": target_url,
        "page_title": nav_report.page_title,
        "status": nav_report.status,
        "interactive_elements_indexed": obs.interactive_elements.len(),
        "prompt_action": {
            "type": action_type,
            "result": chosen_action
        },
        "extracted_markdown_bytes": md.len(),
        "screenshot_png_bytes": shot.png_bytes.len(),
        "status": "PASS"
    });

    fs::write(
        &json_dest_evidence,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;
    fs::write(
        &json_dest_artifact,
        serde_json::to_string_pretty(&trace_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> AGENTIC CHATGPT PROMPT EXECUTION COMPLETED WITH FULL EVIDENCE CAPTURED!");
    println!("================================================================================");

    Ok(())
}

examples/test_chatgpt_and_google.rs (lines 82-85)

async fn main() -> Result<()> {
    println!("================================================================================");
    println!(">>> TEST SUITE: CHATGPT.COM (AGENTIC MODE) & GOOGLE.COM (AI MODE, AI OVERVIEW, NORMAL SEARCH)");
    println!("================================================================================\n");

    let artifact_dir = Path::new(
        r"C:\Users\abhis\.gemini\antigravity-ide\brain\c08da294-7846-44b1-9403-559e0d23ce0f",
    );
    let evidence_dir = Path::new("evidence");
    fs::create_dir_all(evidence_dir)?;
    if !artifact_dir.exists() {
        let _ = fs::create_dir_all(artifact_dir);
    }

    // =========================================================================
    // PART 1: CHATGPT.COM (AGENTIC MODE TESTING)
    // =========================================================================
    println!("--------------------------------------------------------------------------------");
    println!(">>> [1/4] TESTING CHATGPT.COM — AGENTIC MODE & INTERACTIVE ACTION TREE");
    println!("--------------------------------------------------------------------------------");

    let mut gpt_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let gpt_url = "https://chatgpt.com/";
    println!(
        "  [Step 1.1] Navigating with Stealth Anti-Detection to {}...",
        gpt_url
    );
    let gpt_nav = gpt_tab.navigate(gpt_url).await?;
    println!("  -> Landed Status:    {}", gpt_nav.status);
    println!("  -> Page Title:       {}", gpt_nav.page_title);
    println!("  -> CAPTCHA Detected: {}", gpt_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", gpt_nav.html_bytes);

    // Agentic Observation & Action Tree
    println!("  [Step 1.2] Extracting Agent Action Map (Interactive Elements)...");
    let gpt_obs = gpt_tab.observe().expect("Expected ChatGPT observation");
    println!(
        "  -> Total Interactive Elements Indexed: {}",
        gpt_obs.interactive_elements.len()
    );

    // Print sample of action tree
    println!("\n  >>> CHATGPT AGENT ACTION MAP (First 10 Interactive Elements):");
    for el in gpt_obs.interactive_elements.iter().take(10) {
        println!("    {}", el.to_agent_string());
    }

    // Agentic Action: Attempt to find prompt input or interactive button
    let input_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| {
            e.is_input
                || e.tag == "textarea"
                || e.placeholder.to_lowercase().contains("message")
                || e.placeholder.to_lowercase().contains("ask")
                || e.selector.contains("prompt")
        })
        .cloned();

    let button_target = gpt_obs
        .interactive_elements
        .iter()
        .find(|e| e.tag == "button" || e.role == "button")
        .cloned();

    let mut action_executed = "None".to_string();
    if let Some(target) = &input_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent typing into input element [{}] (Selector: {})...",
            target.index, target.selector
        );
        let type_res = gpt_tab
            .act_type(
                &target.index.to_string(),
                "Explain quantum computing in one sentence",
            )
            .await?;
        println!("  -> Type Action Result: {}", type_res);
        action_executed = format!("Type into element [{}] ({})", target.index, target.selector);
    } else if let Some(target) = &button_target {
        println!(
            "\n  [Step 1.3: Agent Act] Agent inspecting interactive button [{}] (Text: \"{}\")...",
            target.index, target.text
        );
        action_executed = format!("Inspect/Focus button [{}] ({})", target.index, target.text);
    }

    // Capture ChatGPT Screenshot
    println!("  [Step 1.4] Capturing ChatGPT Visual Screenshot...");
    let gpt_shot = gpt_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes ({}x{})",
        gpt_shot.png_bytes.len(),
        gpt_shot.width,
        gpt_shot.height
    );

    if !gpt_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("chatgpt_screenshot.png"),
            &gpt_shot.png_bytes,
        )?;
    }

    // Extract ChatGPT Markdown
    println!("  [Step 1.5] Extracting Distilled LLM Markdown...");
    let gpt_md = gpt_tab.extract_markdown(None).unwrap_or_default();
    println!("  -> Distilled Markdown Size: {} bytes", gpt_md.len());
    fs::write(evidence_dir.join("chatgpt_distilled.md"), &gpt_md)?;
    fs::write(artifact_dir.join("chatgpt_distilled.md"), &gpt_md)?;

    // Save ChatGPT Observation JSON
    let gpt_trace_json = json!({
        "url": gpt_url,
        "page_title": gpt_nav.page_title,
        "status": gpt_nav.status,
        "is_captcha_detected": gpt_nav.is_captcha_detected,
        "html_bytes": gpt_nav.html_bytes,
        "interactive_elements_count": gpt_obs.interactive_elements.len(),
        "action_executed": action_executed,
        "interactive_elements": gpt_obs.interactive_elements
    });
    fs::write(
        evidence_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_agentic_observation.json"),
        serde_json::to_string_pretty(&gpt_trace_json)?,
    )?;

    // =========================================================================
    // PART 2: GOOGLE.COM — AI MODE (`udm=50`)
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [2/4] TESTING GOOGLE.COM — AI MODE (udm=50)");
    println!("--------------------------------------------------------------------------------");

    let mut google_ai_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_aimode_url =
        "https://www.google.com/search?q=Rust+programming+language+concurrency+patterns&udm=50";
    println!(
        "  [Step 2.1] Navigating to Google AI Mode: {}",
        google_aimode_url
    );
    let aimode_nav = google_ai_tab.navigate(google_aimode_url).await?;
    println!("  -> Page Title:       {}", aimode_nav.page_title);
    println!("  -> Status:           {}", aimode_nav.status);
    println!("  -> CAPTCHA Detected: {}", aimode_nav.is_captcha_detected);
    println!("  -> HTML Payload:     {} bytes", aimode_nav.html_bytes);

    // Extract Structured Search Results
    let aimode_results = google_ai_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results Found: {}",
        aimode_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA):    {}",
        aimode_results.related_questions.len()
    );
    println!(
        "  -> Has AI Overview:            {}",
        aimode_results.ai_overview.is_some()
    );
    println!(
        "  -> Has Knowledge Panel:        {}",
        aimode_results.knowledge_panel.is_some()
    );

    // Capture Screenshot
    println!("  [Step 2.2] Capturing Google AI Mode Screenshot...");
    let aimode_shot = google_ai_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        aimode_shot.png_bytes.len()
    );
    if !aimode_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aimode_screenshot.png"),
            &aimode_shot.png_bytes,
        )?;
    }

    // Extract Markdown
    println!("  [Step 2.3] Distilling Google AI Mode Markdown...");
    let aimode_md = google_ai_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        aimode_md.len(),
        ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aimode_distilled.md"), &aimode_md)?;
    fs::write(artifact_dir.join("google_aimode_distilled.md"), &aimode_md)?;

    // Save JSON
    let aimode_json = json!({
        "url": google_aimode_url,
        "title": aimode_nav.page_title,
        "status": aimode_nav.status,
        "html_bytes": aimode_nav.html_bytes,
        "markdown_bytes": aimode_md.len(),
        "search_results": aimode_results
    });
    fs::write(
        evidence_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aimode_results.json"),
        serde_json::to_string_pretty(&aimode_json)?,
    )?;

    // =========================================================================
    // PART 3: GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE EXTRACTION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [3/4] TESTING GOOGLE.COM — AI OVERVIEW (SGE) & KNOWLEDGE CARDS");
    println!("--------------------------------------------------------------------------------");

    let mut google_sge_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_sge_url = "https://www.google.com/search?q=what+is+quantum+computing+principles";
    println!(
        "  [Step 3.1] Navigating to Google Search: {}",
        google_sge_url
    );
    let sge_nav = google_sge_tab.navigate(google_sge_url).await?;
    println!("  -> Page Title:       {}", sge_nav.page_title);
    println!("  -> Status:           {}", sge_nav.status);
    println!("  -> HTML Payload:     {} bytes", sge_nav.html_bytes);

    let sge_results = google_sge_tab
        .extract_search_results()
        .expect("Expected search results");
    println!(
        "  -> Total Organic Results:   {}",
        sge_results.organic_results.len()
    );
    println!(
        "  -> Related Questions (PAA): {}",
        sge_results.related_questions.len()
    );
    if let Some(ai) = &sge_results.ai_overview {
        println!(
            "  -> AI OVERVIEW SUMMARY FOUND (Length: {} chars)",
            ai.summary.len()
        );
        println!("     {}", ai.summary.chars().take(200).collect::<String>());
    } else {
        println!("  -> AI Overview / SGE Block parsed with direct snippet extraction.");
    }

    if let Some(kp) = &sge_results.knowledge_panel {
        println!("  -> Knowledge Panel Title: {}", kp.title);
        println!("  -> Knowledge Panel Desc:  {}", kp.description);
    }

    // Capture Screenshot
    println!("  [Step 3.2] Capturing Google AI Overview Screenshot...");
    let sge_shot = google_sge_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        sge_shot.png_bytes.len()
    );
    if !sge_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_aioverview_screenshot.png"),
            &sge_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 3.3] Distilling Google AI Overview Markdown...");
    let sge_md = google_sge_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Markdown Size: {} bytes ({:.2}% reduction)",
        sge_md.len(),
        ((sge_nav.html_bytes - sge_md.len()) as f64 / sge_nav.html_bytes as f64) * 100.0
    );
    fs::write(evidence_dir.join("google_aioverview_distilled.md"), &sge_md)?;
    fs::write(artifact_dir.join("google_aioverview_distilled.md"), &sge_md)?;

    let sge_json = json!({
        "url": google_sge_url,
        "title": sge_nav.page_title,
        "status": sge_nav.status,
        "html_bytes": sge_nav.html_bytes,
        "markdown_bytes": sge_md.len(),
        "search_results": sge_results
    });
    fs::write(
        evidence_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_aioverview_results.json"),
        serde_json::to_string_pretty(&sge_json)?,
    )?;

    // =========================================================================
    // PART 4: GOOGLE.COM — NORMAL SEARCH & MARKDOWN DISTILLATION
    // =========================================================================
    println!("\n--------------------------------------------------------------------------------");
    println!(">>> [4/4] TESTING GOOGLE.COM — NORMAL SEARCH, LINKS, FORMS & SCREENSHOT");
    println!("--------------------------------------------------------------------------------");

    let mut google_norm_tab = BrowserTab::with_profile(DeviceProfile::ChromeWindows)?;
    let google_norm_url =
        "https://www.google.com/search?q=headless+browser+rust+engine+for+ai+agents";
    println!(
        "  [Step 4.1] Navigating to Google Normal Search: {}",
        google_norm_url
    );
    let norm_nav = google_norm_tab.navigate(google_norm_url).await?;
    println!("  -> Page Title:       {}", norm_nav.page_title);
    println!("  -> Status:           {}", norm_nav.status);
    println!("  -> HTML Payload:     {} bytes", norm_nav.html_bytes);

    let norm_results = google_norm_tab
        .extract_search_results()
        .expect("Expected search results");
    let norm_links = google_norm_tab.extract_links();
    let norm_forms = google_norm_tab.extract_forms();

    println!(
        "  -> Organic Results Found: {}",
        norm_results.organic_results.len()
    );
    println!("  -> Links Extracted:       {}", norm_links.len());
    println!("  -> Forms Extracted:       {}", norm_forms.len());

    // Print sample organic results
    println!("\n  >>> SAMPLE ORGANIC SEARCH RESULTS:");
    for (i, res) in norm_results.organic_results.iter().take(4).enumerate() {
        println!("    [{}] Title:   {}", i + 1, res.title);
        println!("        Link:    {}", res.link);
        println!("        Snippet: {}", res.snippet);
    }

    // Capture Screenshot
    println!("\n  [Step 4.2] Capturing Google Normal Search Screenshot...");
    let norm_shot = google_norm_tab
        .screenshot_async()
        .await
        .expect("Expected screenshot");
    println!(
        "  -> Screenshot PNG Size: {} bytes",
        norm_shot.png_bytes.len()
    );
    if !norm_shot.png_bytes.is_empty() {
        fs::write(
            evidence_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
        fs::write(
            artifact_dir.join("google_normal_search_screenshot.png"),
            &norm_shot.png_bytes,
        )?;
    }

    // Distill Markdown
    println!("  [Step 4.3] Distilling Google Normal Search Markdown...");
    let norm_md = google_norm_tab.extract_markdown(None).unwrap_or_default();
    println!(
        "  -> Distilled Markdown Size: {} bytes ({:.2}% reduction)",
        norm_md.len(),
        ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0
    );
    fs::write(
        evidence_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_distilled.md"),
        &norm_md,
    )?;

    let norm_json = json!({
        "url": google_norm_url,
        "title": norm_nav.page_title,
        "status": norm_nav.status,
        "html_bytes": norm_nav.html_bytes,
        "markdown_bytes": norm_md.len(),
        "organic_count": norm_results.organic_results.len(),
        "links_count": norm_links.len(),
        "forms_count": norm_forms.len(),
        "search_results": norm_results,
        "sample_links": norm_links.iter().take(10).collect::<Vec<_>>()
    });
    fs::write(
        evidence_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;
    fs::write(
        artifact_dir.join("google_normal_search_results.json"),
        serde_json::to_string_pretty(&norm_json)?,
    )?;

    // =========================================================================
    // PART 5: MASTER SUMMARY REPORT
    // =========================================================================
    let master_summary = json!({
        "engine": "Headless Engine (Pure Rust)",
        "test_targets": {
            "chatgpt_com": {
                "url": gpt_url,
                "title": gpt_nav.page_title,
                "agentic_interactive_elements": gpt_obs.interactive_elements.len(),
                "action_executed": action_executed,
                "screenshot_bytes": gpt_shot.png_bytes.len(),
                "markdown_bytes": gpt_md.len(),
                "status": "PASS"
            },
            "google_ai_mode": {
                "url": google_aimode_url,
                "title": aimode_nav.page_title,
                "organic_results": aimode_results.organic_results.len(),
                "screenshot_bytes": aimode_shot.png_bytes.len(),
                "markdown_bytes": aimode_md.len(),
                "reduction": format!("{:.2}%", ((aimode_nav.html_bytes - aimode_md.len()) as f64 / aimode_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            },
            "google_ai_overview": {
                "url": google_sge_url,
                "title": sge_nav.page_title,
                "paa_questions": sge_results.related_questions.len(),
                "has_ai_overview": sge_results.ai_overview.is_some(),
                "screenshot_bytes": sge_shot.png_bytes.len(),
                "markdown_bytes": sge_md.len(),
                "status": "PASS"
            },
            "google_normal_search": {
                "url": google_norm_url,
                "title": norm_nav.page_title,
                "organic_results": norm_results.organic_results.len(),
                "links_extracted": norm_links.len(),
                "screenshot_bytes": norm_shot.png_bytes.len(),
                "markdown_bytes": norm_md.len(),
                "reduction": format!("{:.2}%", ((norm_nav.html_bytes - norm_md.len()) as f64 / norm_nav.html_bytes as f64) * 100.0),
                "status": "PASS"
            }
        }
    });

    fs::write(
        evidence_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;
    fs::write(
        artifact_dir.join("chatgpt_and_google_full_summary.json"),
        serde_json::to_string_pretty(&master_summary)?,
    )?;

    println!("\n================================================================================");
    println!(">>> ALL TESTS FOR CHATGPT.COM & GOOGLE.COM COMPLETED SUCCESSFULLY!");
    println!("================================================================================");

    Ok(())
}

pub async fn click( &mut self, selector_or_text: &str, ) -> Result<Option<NavigationReport>>

pub fn type_text(&mut self, selector: &str, text: &str) -> Result<String>