Crate gestura_core_tools

Crate gestura_core_tools 

Source
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 implementations
  • registry: built-in tool catalog and discovery helpers
  • schemas: provider-specific tool schemas for OpenAI, Anthropic, and Gemini
  • permissions: permission management and audit-friendly checks
  • policy: 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