Struct BrowserSession 

pub struct BrowserSession { /* private fields */ }

A sandboxed headless browser controlled from outside.

The browser (Chromium via Playwright) runs inside an agentkernel sandbox. You call high-level methods; the SDK generates and executes scripts internally.

Example

let client = agentkernel_sdk::AgentKernel::builder().build()?;
let mut browser = client.browser("my-browser", None).await?;
let page = browser.goto("https://example.com").await?;
println!("{} — {} links", page.title, page.links.len());
let png = browser.screenshot(None).await?;
browser.remove().await?;

Implementations

impl BrowserSession

pub fn name(&self) -> &str

The sandbox name backing this browser session.

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

Navigate to a URL and return page data (title, text, links).

pub async fn screenshot(&self, url: Option<&str>) -> Result<Vec<u8>>

Take a PNG screenshot. Returns the raw PNG bytes.

If url is None, re-uses the last URL from goto.

pub async fn evaluate( &self, expression: &str, url: Option<&str>, ) -> Result<Value>

Run a JavaScript expression on a page and return the result as JSON.

If url is None, re-uses the last URL from goto.

pub async fn remove(&mut self) -> Result<()>

Remove the underlying sandbox. Idempotent.