Module tool 

Tool trait, registry, context, and result types for agent function calling.

Key types

Type	Role
Tool	Trait for tools callable by the agent (name, description, params, execute)
ToolRegistry	Registry of available tools with aliases
ToolContext	Per-invocation context passed to execute()
ToolResult	Result of a tool execution returned to the LLM
FileDiff	A file diff produced by a tool
ForbiddenCmd	Command restriction pattern (regex-based)
ToolGate	Host check every call passes before it runs

Structs

BackgroundRequest

A request to move a running tool call into the background.

FileDiff

A file diff produced by a tool.

ForbiddenCmd

A forbidden command configuration.

GateAsk

A question a gate asked, and how long the call waits for its answer.

ToolContext

Per-invocation context passed to Tool::execute methods.

ToolRegistry

Registry of tools available to an agent.

Enums

DiffLine

A single line in a unified diff output.

GateAnswer

The answer to a GateAsk.

GateDecision

What a ToolGate decides about one call.

ToolResult

Result of a tool execution, returned by Tool::execute and fed back to the LLM as a "role": "tool" message.

Traits

CommandAllowList

Trait for checking whether a command is allowed to execute.

InterruptPayload

Typed payload for ToolResult::Interrupt.

Tool

Trait for tools that can be invoked by the agent.

ToolGate

A host’s check on every tool call, made where the registry executes it.

Functions

parse_args

Deserialize tool arguments from a serde_json::Value into a typed struct. Returns a typed error mentioning which tool failed to parse.