Enum ToolCallContext 

#[non_exhaustive]
pub enum ToolCallContext {
    WebSearch {
        query: String,
        engine: Option<String>,
    },
    PageVisit {
        url: String,
        reason: Option<VisitReason>,
        page_title: Option<String>,
        page_status: Option<u16>,
        page_bytes: Option<u64>,
        page_duration_ms: Option<u64>,
        navigation_error: Option<String>,
        screenshot: Option<ScreenshotMeta>,
    },
    DataExtraction {
        target: String,
        url: Option<String>,
        result_count: Option<usize>,
        page_status: Option<u16>,
        page_duration_ms: Option<u64>,
    },
    SessionAction {
        action: String,
        url: Option<String>,
    },
    ScriptStep {
        current: usize,
        total: usize,
        step: String,
    },
}

Stable since 0.63.0

Semantic context for a tool execution event.

Carries structured information about what a tool call means, derived from the tool name and arguments by the agent loop. UI consumers that understand a context variant can render it richly; older consumers simply ignore the field.

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.

WebSearch

A search engine query.

Fields

query: String

The search query string.

engine: Option<String>

Search engine used (e.g. “duckduckgo”).

PageVisit

Visiting a web page.

Fields

url: String

URL being visited.

reason: Option<VisitReason>

Why this page is being visited.

page_title: Option<String>

Page <title> after load.

page_status: Option<u16>

HTTP status code.

page_bytes: Option<u64>

HTML body size in bytes.

page_duration_ms: Option<u64>

Wall-clock page load duration in milliseconds.

navigation_error: Option<String>

Navigation error message (from BrowseProgress::NavigationFailed).

screenshot: Option<ScreenshotMeta>

Screenshot metadata (from BrowseProgress::ScreenshotCaptured).

DataExtraction

Extracting data from a web page.

Fields

target: String

Description of what is being extracted (e.g. CSS selector).

url: Option<String>

URL of the page being extracted from.

result_count: Option<usize>

Number of items extracted.

page_status: Option<u16>

HTTP status code of the page.

page_duration_ms: Option<u64>

Page load duration in milliseconds.

SessionAction

An action within a persistent browser session.

Fields

action: String

The session action being performed (e.g. “goto”, “click”).

url: Option<String>

URL if the action involves navigation.

ScriptStep

A step within a browse script.

Fields

current: usize

Current step index (1-based).

total: usize

Total number of steps.

step: String

Human-readable step description.

Trait Implementations

impl Clone for ToolCallContext

fn clone(&self) -> ToolCallContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolCallContext

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolCallContext

fn deserialize<__D>( __deserializer: __D, ) -> Result<ToolCallContext, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolCallContext

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

where __S: Serializer,

Serialize this value into the given Serde serializer.