Struct ToolBox 

pub struct ToolBox {
    pub skills_dir: PathBuf,
    pub searxng_url: Option<String>,
    pub langsearch_key: Option<String>,
    pub search_provider: String,
    pub blocked_domains: Vec<String>,
    pub supports_images: bool,
    pub image_gen_backend: Option<(OpenRouter, String)>,
    pub space_files_dir: PathBuf,
    pub space_apps_dir: PathBuf,
    pub space_scripts_dir: PathBuf,
    pub session_id: String,
    pub video_gen_backend: Option<(OpenRouter, String)>,
    /* private fields */
}

Fields

skills_dir: PathBuf

App-managed destination for newly created or downloaded skills.

searxng_url: Option<String>

Base URL of a SearXNG instance (e.g. http://localhost:8080), no trailing slash. Free and self-hosted — no API key needed.

langsearch_key: Option<String>

LangSearch API key (free tier, no card): https://langsearch.com/dashboard

search_provider: String

Which backend search(mode=web) prefers: “auto” (LangSearch, then SearXNG, DuckDuckGo, and Brave), or an explicit “langsearch”/“searxng”/“duckduckgo”.

blocked_domains: Vec<String>

Domains a per-space setting always excludes from search(mode=web) results (appended to any exclude_domains the model passes).

supports_images: bool

Whether the current model supports image inputs. When false, tool image results are returned as text references instead of being injected as vision content (which would cause a 400).

image_gen_backend: Option<(OpenRouter, String)>

Provider + model for AI image generation. None = tool disabled.

space_files_dir: PathBuf

Directory to save generated images into / search for reference images.

space_apps_dir: PathBuf

space_scripts_dir: PathBuf

Directory holding space-local scripts (created by the model via the scripts tool).

session_id: String

Current session id — for attaching generated images to a message.

video_gen_backend: Option<(OpenRouter, String)>

Provider + model for video generation. None = tools hidden.

Implementations

impl ToolBox

pub fn new( skills_dir: PathBuf, searxng_url: Option<String>, langsearch_key: Option<String>, search_provider: String, blocked_domains: Vec<String>, db_path: Option<PathBuf>, files: Option<FilesCtx>, apps: Option<AppsCtx>, ) -> Self

All config knobs; kept flat because ~17 test call sites construct this with inline None/default args — a config struct would churn every one of them for no readability gain.

pub fn with_skill_dirs(self, skill_dirs: Vec<PathBuf>) -> Self

Replace the skill roots used for reads while retaining skills_dir as the app-managed install/create destination.

pub fn research( searxng_url: Option<String>, langsearch_key: Option<String>, search_provider: String, blocked_domains: Vec<String>, db_path: Option<PathBuf>, ) -> Self

A toolbox restricted to search/fetch_url — for deep-research searcher agents, which get no filesystem/app/script access.

pub fn with_research_session(self, session_id: String) -> Self

Attach a research session id, enabling research_lookup for follow-up turns in that session’s chat. Also merges any domains the user has discarded in this session into blocked_domains, so a later search/fetch_url call excludes them the same way the global setting does.

pub const fn cache_only(self) -> Self

Restrict fetch_url to serving from web_cache only — a cache miss returns [not cached] instead of fetching. Used for the Verifier’s quote-checking pass (Task 8).

pub fn defs(&self) -> Vec<ToolDef>

Tool definitions to attach to the request, or empty to send a request identical to one from before tool-calling existed (keeps models that don’t support tools working unchanged). search always works — it prefers configured API backends, then uses keyless HTML fallbacks when those are unavailable, so it needs no setup.

pub async fn run(&self, name: &str, args: &str) -> (String, String)

Run a tool by name. Returns (result text sent back to the model, status label shown in the UI while it runs).

Trait Implementations

impl ToolExecutor for ToolBox

fn defs(&self) -> Vec<ToolDef>

Tool definitions to attach to the request (see ToolBox::defs).

fn is_read_only(&self, name: &str, args: &str) -> bool

Whether a call is read-only (see is_read_only_tool) — parallel calls run concurrently only when every one of them is.

fn run<'a>( &'a self, name: &'a str, args: &'a str, ) -> Pin<Box<dyn Future<Output = (String, String)> + Send + 'a>>

Run one tool call, returning (result, status-label). Boxed future so the trait stays dyn-compatible (the loops hold Arc<dyn ToolExecutor>).

fn supports_images(&self) -> bool

Whether the current model accepts image inputs.

fn space_files_dir(&self) -> Option<PathBuf>

The active space’s files dir, for resolving image references in tool results.