hal_tool_call: hal tool call

In hal: Agentic Coding Assistants

hal tool call

Description

An S3 class representing a single tool invocation by the agent. Tool calls appear inside hal_turn objects and are visible when printing conversation history.

Usage

## S3 method for class 'hal_tool_call'
format(x, ...)

## S3 method for class 'hal_tool_call'
print(x, ...)

Arguments

x	A hal_tool_call object.
...	Ignored.

Value

The print() method returns x invisibly; the format() method returns a character scalar. hal_tool_call objects are created internally as tool activity streams in.

Fields

tool_call_id

Character: unique ID for this tool call.

title

Character: human-readable description (e.g., "Viewing DESCRIPTION").

kind

Character: tool kind ("read", "write", "command", etc.).

status

Character: "pending", "completed", or "failed".

input

Named list of input arguments.

output

Character: output text from the tool.

See Also

hal_turn, hal_response

hal documentation built on Oct. 6, 2026, 5:07 p.m.