Expand description
Built-in tools, schemas, permissions, and tool policy for Gestura.
This domain crate owns the implementation of Gestura’s built-in tools and the shared machinery around them: registry construction, permission checks, policy evaluation, provider schema generation, and async wrappers used by the higher-level pipeline.
§Design role
This crate is intentionally independent from the gestura-core facade so it
can stay workable with lower coupling and faster iteration. The public stable
import path for most consumers remains gestura_core::tools::*, which
re-exports these modules from the facade crate.
§High-signal modules
file,shell,git,web,screen: built-in tool implementationsregistry: built-in tool catalog and discovery helpersschemas: provider-specific tool schemas for OpenAI, Anthropic, and Geminipermissions: permission management and audit-friendly checkspolicy: policy evaluation helpers layered on top of permissions
Pipeline orchestration and higher-level request handling stay in
gestura-core; this crate focuses on the tools domain itself.
Re-exports§
pub use registry::ToolDefinition;pub use registry::all_tools;pub use registry::find_tool;pub use registry::looks_like_capabilities_question;pub use registry::looks_like_tools_question;pub use registry::render_tool_detail;pub use registry::render_tools_overview;
Modules§
- code
- Code analysis and navigation tool
- code_
async - Async code operations for pipeline integration
- config
- Tool-related configuration types.
- error
- Error compatibility module.
- file
- File operations tool
- file_
async - Async file operations for pipeline integration
- git
- Git repository operations tool
- git_
async - Async git operations for pipeline integration
- gui
- GUI Control Tool
- mcp_
manager - MCP Manager — Search, evaluate, install, and manage MCP servers
- permissions
- Permission management for tool access
- policy
- Tool policy helpers.
- registry
- Tool Registry
- schemas
- Provider-specific tool schemas (OpenAI / Anthropic / Gemini)
- screen
- Screen capture and recording tool
- screen_
async - Async screen capture operations for pipeline integration
- shell
- Shell command execution tool
- shell_
async - Async shell operations for pipeline integration
- tool_
confirmation - Async pause/resume support for Restricted-mode tool confirmations.
- tool_
inspection - Tool Inspection Manager
- web
- Web fetching and search tool