Struct BrowserToolset 

pub struct BrowserToolset { /* private fields */ }

A toolset that provides all browser automation tools.

Use this to add all browser tools to an agent at once, or use individual tools for more control.

Implementations

impl BrowserToolset

pub fn new(browser: Arc<BrowserSession>) -> Self

Create a new toolset with all tools enabled.

pub fn with_pool(pool: Arc<BrowserSessionPool>) -> Self

Create a pool-backed toolset with all tools enabled.

Sessions are resolved per-user at runtime via Toolset::tools(ctx). The pool calls get_or_create(ctx.user_id()) to obtain an isolated browser session for each user.

Example

use adk_browser::{BrowserToolset, BrowserSessionPool, BrowserConfig};
use std::sync::Arc;

let pool = Arc::new(BrowserSessionPool::new(BrowserConfig::default()));
let toolset = BrowserToolset::with_pool(pool);

pub fn with_pool_and_profile( pool: Arc<BrowserSessionPool>, profile: BrowserProfile, ) -> Self

Create a pool-backed toolset with a pre-configured profile.

Combines pool-backed session resolution with profile-based tool category selection.

Example

use adk_browser::{BrowserToolset, BrowserProfile, BrowserSessionPool, BrowserConfig};
use std::sync::Arc;

let pool = Arc::new(BrowserSessionPool::new(BrowserConfig::default()));
let toolset = BrowserToolset::with_pool_and_profile(pool, BrowserProfile::Minimal);

pub fn with_profile( browser: Arc<BrowserSession>, profile: BrowserProfile, ) -> Self

Create a toolset with a pre-configured profile.

This is the recommended way to create a toolset for most agents. Using BrowserProfile::Full is equivalent to BrowserToolset::new().

pub fn with_navigation(self, enabled: bool) -> Self

Enable or disable navigation tools.

pub fn with_interaction(self, enabled: bool) -> Self

Enable or disable interaction tools.

pub fn with_extraction(self, enabled: bool) -> Self

Enable or disable extraction tools.

pub fn with_wait(self, enabled: bool) -> Self

Enable or disable wait tools.

pub fn with_screenshot(self, enabled: bool) -> Self

Enable or disable screenshot tool.

pub fn with_js(self, enabled: bool) -> Self

Enable or disable JavaScript tools.

pub fn with_cookies(self, enabled: bool) -> Self

Enable or disable cookie management tools.

pub fn with_windows(self, enabled: bool) -> Self

Enable or disable window/tab management tools.

pub fn with_frames(self, enabled: bool) -> Self

Enable or disable frame/iframe management tools.

pub fn with_actions(self, enabled: bool) -> Self

Enable or disable advanced action tools.

pub fn all_tools(&self) -> Vec<Arc<dyn Tool>>

Get all tools as a vector (synchronous version).

Works for fixed-session toolsets. For pool-backed toolsets, returns an empty vec with a warning — use Toolset::tools(ctx) or try_all_tools() instead.

pub fn try_all_tools(&self) -> Result<Vec<Arc<dyn Tool>>>

Try to get all tools synchronously. Returns an error for pool-backed toolsets.

Prefer Toolset::tools(ctx) for pool-backed toolsets.

Trait Implementations

impl Toolset for BrowserToolset

fn name(&self) -> &str

fn tools<'life0, 'async_trait>( &'life0 self, ctx: Arc<dyn ReadonlyContext>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Arc<dyn Tool>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,