Skip to main content

​
Overview

The ListToolsOptions struct provides filtering and pagination options when fetching AI tools.

​
Definition

pub struct ListToolsOptions {
    pub page: Option<u32>,
    pub per_page: Option<u32>,
    pub search: Option<String>,
    pub is_active: Option<bool>,
}

​
Fields

​
page
Option<u32>
The page number to retrieve (1-indexed). Defaults to 1 if not specified.
​
per_page
Option<u32>
Number of tools to return per page. Defaults to 20 if not specified.
​
search
Option<String>
Search query to filter tools by name, description, or other attributes.
​
is_active
Option<bool>
Filter tools by active status. When true, only returns active tools. When false, only returns inactive tools.

​
Usage Example

use wacht::api::tools::{fetch_tools, ListToolsOptions};

// Fetch all tools with default pagination
let all_tools = fetch_tools(None).await?;

// Fetch only active tools
let active_options = ListToolsOptions {
    is_active: Some(true),
    ..Default::default()
};
let active_tools = fetch_tools(Some(active_options)).await?;

// Search for specific tools
let search_options = ListToolsOptions {
    page: Some(1),
    per_page: Some(50),
    search: Some("api integration".to_string()),
    is_active: None, // Include both active and inactive
};
let api_tools = fetch_tools(Some(search_options)).await?;

// Paginate through all tools
let mut all_tool_names = Vec::new();
let mut page = 1;

loop {
    let options = ListToolsOptions {
        page: Some(page),
        per_page: Some(100),
        is_active: Some(true), // Only active tools
        ..Default::default()
    };

    let response = fetch_tools(Some(options)).await?;

    for tool in &response.data {
        all_tool_names.push(tool.name.clone());
    }

    if !response.has_more {
        break;
    }
    page += 1;
}

println!("Found {} active tools", all_tool_names.len());

​
See Also