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.

pub async fn open( &mut self, url: &str, page: Option<&str>, ) -> Result<AriaSnapshot>

Navigate to a URL and return an ARIA snapshot.

pub async fn snapshot(&mut self, page: Option<&str>) -> Result<AriaSnapshot>

Get the current ARIA snapshot without navigating.

pub async fn click( &mut self, page: Option<&str>, ref_id: Option<&str>, selector: Option<&str>, ) -> Result<AriaSnapshot>

Click an element by ref ID or CSS selector. Returns a new ARIA snapshot.

pub async fn fill( &mut self, value: &str, page: Option<&str>, ref_id: Option<&str>, selector: Option<&str>, ) -> Result<AriaSnapshot>

Fill an input by ref ID or CSS selector. Returns a new ARIA snapshot.

pub async fn close_page(&mut self, page: Option<&str>) -> Result<()>

Close a named page.

pub async fn list_pages(&mut self) -> Result<Vec<String>>

List active page names.