Struct BrowserToolset 

pub struct BrowserToolset { /* private fields */ }

Available on crate feature browser only.

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>) -> BrowserToolset

Create a new toolset with all tools enabled.

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

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, ) -> BrowserToolset

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, ) -> BrowserToolset

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) -> BrowserToolset

Enable or disable navigation tools.

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

Enable or disable interaction tools.

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

Enable or disable extraction tools.

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

Enable or disable wait tools.

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

Enable or disable screenshot tool.

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

Enable or disable JavaScript tools.

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

Enable or disable cookie management tools.

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

Enable or disable window/tab management tools.

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

Enable or disable frame/iframe management tools.

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

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>>, AdkError>

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

Returns the name of this toolset.

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

where 'life0: 'async_trait, BrowserToolset: 'async_trait,

Returns the tools available in this toolset for the given context.