Module tool 

Tool system: trait, registry, result types, and context.

Modules

async_runner

Async tool execution: lets long-running tools return a pending placeholder and run their actual work in a background task.

bash

bash tool — executes shell commands.

edit

edit tool — exact string replacement in files.

find

find tool — searches for files matching a pattern.

generate_image

generate_image tool - generates images from text prompts.

grep

grep tool — searches file contents for a pattern.

load_skill

load_skill tool — loads a skill’s full content by name.

ls

ls tool — lists directory contents.

memory

Memory tools for long-term memory.

query_task

query_task tool - inspect the status of async background tasks.

read

read tool — reads file contents with line numbers.

search_history

Search history tool — full-text search of chat messages.

task_registry

Task registry: tracks the lifecycle of async tool tasks for status queries.

write

write tool — creates or overwrites files.

Structs

ToolCallInfo

Information about a tool call, used for confirmation requests.

ToolContext

Runtime context passed to tools during execution.

ToolImage

A single image attached to a tool result.

ToolRegistry

Registry that manages all available tools.

ToolResult

Result returned to the LLM after tool execution.

Traits

Tool

A tool that can be called by the LLM and executed by the Agent.

Functions

resolve_path

Resolve a file path relative to the working directory.