Expand description
brainwires-tool-builtins — the concrete-tools half of the Brainwires
tool surface. Companion crate to brainwires-tool-runtime (the executor /
registry / framework), unified by the brainwires-tools façade.
§Always Available (native feature)
- bash — Shell command execution with proactive output management
- file_ops — File read/write/edit/patch/list/search/delete/create_directory
- git — Git operations (status, diff, log, stage, commit, push, pull, …)
- web — URL fetching
- search — Regex-based code search (respects .gitignore)
- default_executor::BuiltinToolExecutor —
ToolExecutorimpl that hardcodes dispatch to the above plus the feature-gated builtins below.
§Feature-Gated
- code_exec / interpreters (
interpretersfeature) — sandboxed multi-language code execution. - semantic_search (
ragfeature) — RAG-powered codebase search. - email (
emailfeature) — IMAP/SMTP/Gmail-push integration. - calendar (
calendarfeature) — Google Calendar / CalDAV. - browser (
browserfeature) — headless-browser tooling via the MCP Thalora subprocess. - system (
systemfeature) — filesystem-event watching, service management (absorbed frombrainwires-system).
The runtime trait surface (ToolExecutor, ToolRegistry, error types,
transaction, validation, optional orchestrator / oauth /
openapi / sandbox_executor / sessions) is not exported from this
crate — depend on brainwires-tool-runtime directly, or use the
brainwires-tools façade which re-exports both.
Re-exports§
pub use calendar::CalendarTool;
Modules§
- calendar
- Calendar tools: list, create, update, delete events, and find free time.
- gmail_
push - Gmail push ingestion via Google Cloud Pub/Sub.
- interpreters
- Sandboxed multi-language code interpreters (absorbed from brainwires-code-interpreters).
- system
- OS-level primitives — filesystem event watching and service management (absorbed from brainwires-system).
Structs§
- Bash
Tool - Bash execution tool implementation
- Browser
Tool - Browser automation tools powered by Thalora (spawned as a subprocess via MCP).
- Builtin
Tool Executor - Concrete executor that dispatches tool calls to the built-in tool modules
registered in a
ToolRegistry. - Code
Exec Tool - Code execution tool with native interpreters
- Email
Config - Configuration for the email tool.
- Email
Tool - Email tool implementation providing send, search, read, and list operations.
- File
OpsTool - File operations tool implementation
- GitTool
- Git operations tool implementation
- Search
Tool - Regex-based code pattern search tool
- Semantic
Search Tool - Tool definitions and executor for semantic codebase search powered by RAG.
- WebTool
- Web fetching tool implementation
Enums§
- Email
Provider - Email provider configuration variants.
- Email
Source - Where inbound email for an account is pulled from.
Functions§
- registry_
with_ builtins - Build a
brainwires_tool_runtime::ToolRegistrypre-populated with every concrete builtin gated on by the active feature set.