brainwires-tool-builtins 0.11.0

Built-in concrete tools for the Brainwires Agent Framework — bash, file_ops, git, web, search, code_exec, semantic_search, browser, email, calendar, system. Built on `brainwires-tool-runtime`.
Documentation

brainwires-tool-builtins

Crates.io Documentation License

Concrete builtin tools for Brainwires agents. Built on brainwires-tool-runtime, which provides the ToolExecutor / ToolRegistry framework these tools plug into.

What lives here

Always available (native feature)

Tool Purpose
BashTool Shell command execution with proactive output management
FileOpsTool File read / write / edit / patch / list / search / delete / mkdir
GitTool Git operations (status, diff, log, stage, commit, push, pull, …)
WebTool URL fetching
SearchTool Regex-based code search (respects .gitignore)
BuiltinToolExecutor ToolExecutor impl that hardcodes dispatch to all builtins

Plus registry_with_builtins() — convenience constructor that returns a ToolRegistry pre-populated with every concrete builtin gated on by the active feature set.

Feature-gated builtins

Feature Tool Notes
interpreters (-rhai, -lua, -js, -all, -wasm) CodeExecTool + interpreters::* Sandboxed multi-language code execution
rag SemanticSearchTool RAG-powered codebase search (pulls brainwires-rag)
email EmailTool + gmail_push IMAP / SMTP / Gmail Push
calendar CalendarTool Google Calendar / CalDAV
browser BrowserTool Headless browser via the MCP Thalora subprocess
system system::* OS-level primitives — fs event watching, service management

Usage

[dependencies]
brainwires-tool-builtins = "0.11"
use brainwires_tool_builtins::{BashTool, BuiltinToolExecutor, registry_with_builtins};
use brainwires_tool_runtime::{ToolExecutor, ToolRegistry};
use brainwires_core::ToolContext;

let registry = registry_with_builtins();
let executor = BuiltinToolExecutor::new(registry, ToolContext::default());

See also

  • brainwires-tool-runtime — the executor / registry framework these tools plug into.
  • brainwires — umbrella facade with tools feature that re-exports both crates.

License

MIT OR Apache-2.0