Unique identifier for this tool call within the session.
Human-readable title describing what the tool is doing.
Optional ExperimentalnameUNSTABLE
This capability is not part of the spec yet, and may be removed or changed at any point.
Programmatic name of the tool being invoked.
This field is optional. Omitting it or sending null both mean that no
tool name is available.
OptionalkindThe category of tool being invoked. Helps clients choose appropriate icons and UI treatment.
OptionalstatusCurrent execution status of the tool call.
OptionalcontentContent produced by the tool call.
OptionallocationsFile locations affected by this tool call. Enables "follow-along" features in clients.
OptionalrawRaw input parameters sent to the tool.
OptionalrawRaw output returned by the tool.
Optional_The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Implementations MUST NOT make assumptions about values at these keys.
See protocol docs: Extensibility
Represents a tool call that the language model has requested.
Tool calls are actions that the agent executes on behalf of the language model, such as reading files, executing code, or fetching data from external sources.
See protocol docs: Tool Calls