DocsCommontoolsApprovalDecision
Package: @hexos/common

User’s response to a ToolApproval request — approve or reject with optional reason.

Submitted via AgentRuntime.submitApproval() on the backend, or via useToolApproval.approve() / reject() on the frontend. When rejected, the tool call fails with the provided reason.

Related: ToolApproval is the request, ToolApprovalDialog renders the UI.

interface ApprovalDecision {
    toolCallId: string;
    approved: boolean;
    reason?: string;
}

toolCallId

string

approved

boolean

reason

string