Module tools

Expand description

Tools for Pawan agent

This module provides all the tools that Pawan can use to interact with the filesystem, execute commands, and perform coding operations.

Native tools (rg, fd, sd, erd, mise) are thin wrappers over CLI binaries that provide structured JSON output and auto-install hints.

Modules§

agent: Sub-agent spawning tool
ares_bridge: Bridge ares tools into pawan’s ToolRegistry
bash: Bash command execution tool with safety validation
batch: Batch tool: execute multiple tool calls concurrently.
deagle: Deagle code intelligence tools — graph-backed symbol search.
edit: Edit tool for precise string replacement with write safety
file: File read/write tools with safety validation
git: Git operation tools
lsp_tool: ast-grep and LSP (rust-analyzer) tool wrappers.
mise: mise and zoxide tool wrappers.
native: Native CLI tool wrappers — thin re-export shim.
native_search: Native CLI search tool wrappers — rg, fd, sd, erd.
rmux: RMUX tool: typed terminal multiplexer control for long-running agent workflows.
search: Search tools (glob and grep)
task: Task tool: spawn an in-process subagent with restricted tools.

ToolDefinition: Tool definition — re-exported from thulp_core so pawan and the rest of the dirmacs stack share a single source of truth for tool metadata.
ToolRegistry: Registry for managing tools with tiered visibility.

ToolTier: Tool tier — controls which tools are sent to the LLM in the prompt. All tools remain executable regardless of tier; tier only affects which tool definitions appear in the LLM system prompt.