Skip to main content

Crate brainwires_tool_builtins

Crate brainwires_tool_builtins 

Source
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::BuiltinToolExecutorToolExecutor impl that hardcodes dispatch to the above plus the feature-gated builtins below.

§Feature-Gated

  • code_exec / interpreters (interpreters feature) — sandboxed multi-language code execution.
  • semantic_search (rag feature) — RAG-powered codebase search.
  • email (email feature) — IMAP/SMTP/Gmail-push integration.
  • calendar (calendar feature) — Google Calendar / CalDAV.
  • browser (browser feature) — headless-browser tooling via the MCP Thalora subprocess.
  • system (system feature) — filesystem-event watching, service management (absorbed from brainwires-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§

BashTool
Bash execution tool implementation
BrowserTool
Browser automation tools powered by Thalora (spawned as a subprocess via MCP).
BuiltinToolExecutor
Concrete executor that dispatches tool calls to the built-in tool modules registered in a ToolRegistry.
CodeExecTool
Code execution tool with native interpreters
EmailConfig
Configuration for the email tool.
EmailTool
Email tool implementation providing send, search, read, and list operations.
FileOpsTool
File operations tool implementation
GitTool
Git operations tool implementation
SearchTool
Regex-based code pattern search tool
SemanticSearchTool
Tool definitions and executor for semantic codebase search powered by RAG.
WebTool
Web fetching tool implementation

Enums§

EmailProvider
Email provider configuration variants.
EmailSource
Where inbound email for an account is pulled from.

Functions§

registry_with_builtins
Build a brainwires_tool_runtime::ToolRegistry pre-populated with every concrete builtin gated on by the active feature set.