Enum BrowseProgress 

#[non_exhaustive]
pub enum BrowseProgress {
    NavigationStarted {
        url: String,
    },
    WaitingForSelector {
        selector: String,
        timeout_ms: u64,
    },
    DocumentReady {
        url: String,
        title: String,
        status: u16,
        bytes: u64,
        duration_ms: u64,
    },
    ScreenshotCaptured {
        bytes: usize,
        width: u32,
        duration_ms: u64,
    },
    PdfExported {
        bytes: usize,
        width: u32,
        duration_ms: u64,
    },
    NavigationFailed {
        url: String,
        error: String,
    },
}

Structured progress event for browser tool execution.

Converted from oxibrowser_core::BrowserEvent in the backend’s drain task. Carries structured data that would be lost if flattened to a string via short_label(). The agent loop’s browse callback receives these and enriches ToolCallContext with the result fields.

Defined here (not in oxibrowser_backend.rs) so the type is always available — no feature gate needed.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NavigationStarted

A navigation has begun.

Fields

url: String

URL being navigated to (pre-redirect).

WaitingForSelector

Waiting for a CSS selector to appear.

Fields

selector: String

CSS selector being awaited.

timeout_ms: u64

Maximum wait time in milliseconds.

DocumentReady

Page has finished loading and JS has executed. This is the key event — carries rich structured data.

Fields

url: String

Final URL after redirects.

title: String

Page <title>.

status: u16

HTTP status code.

bytes: u64

Size of the HTML body in bytes.

duration_ms: u64

Wall-clock duration of the page load, in milliseconds.

ScreenshotCaptured

A screenshot has been captured.

Fields

bytes: usize

Size of the PNG payload in bytes.

width: u32

Viewport width the screenshot was rendered at.

duration_ms: u64

Render duration in milliseconds.

PdfExported

A PDF export has completed.

Fields

bytes: usize

Size of the PDF payload in bytes.

width: u32

Viewport width the PDF was rendered at.

duration_ms: u64

Render + encode duration in milliseconds.

NavigationFailed

Navigation failed.

Fields

url: String

URL that failed.

error: String

Error description.

Trait Implementations

impl Clone for BrowseProgress

fn clone(&self) -> BrowseProgress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrowseProgress

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BrowseProgress

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BrowseProgress

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

where __S: Serializer,

Serialize this value into the given Serde serializer.