Build a full decisions list for ALL tool calls in a message.

Mixes human decisions (for HITL tools) with auto-approvals (for non-HITL tools). This is needed because LLMChain.execute_tool_calls_with_decisions expects a decision for EVERY tool call, not just the ones that needed approval.

Parameters

• all_tool_calls: All tool calls from assistant message (HITL + non-HITL)
• hitl_tool_call_ids: List of tool_call_ids that needed human approval
• human_decisions: List of decisions from human (same order as action_requests)
• action_requests: List of action_requests (to map decisions to tool_call_ids)

Returns

• List of decisions matching all_tool_calls order

Example

all_tool_calls = [tc1, tc2, tc3]  # 3 total tool calls
hitl_tool_call_ids = [tc1.call_id]  # Only tc1 needed approval
action_requests = [%{tool_call_id: tc1.call_id, ...}]
human_decisions = [%{type: :approve}]  # Human approved tc1

full_decisions = build_full_decisions(all_tool_calls, hitl_tool_call_ids, human_decisions, action_requests)
# => [%{type: :approve}, %{type: :approve}, %{type: :approve}]
# First is human decision, others are auto-approved

Check if a chain has pending tool calls that require human approval.

Parameters

• chain: LLMChain with potentially pending tool calls
• interrupt_on: Map of tool_name => true/false/config

Returns

• {:interrupt, interrupt_data} - Some tools need approval
• :continue - No tools need approval or no tool calls present

Example

case AgentUtils.check_for_hitl_interrupt(chain, %{"write_file" => true}) do
  {:interrupt, interrupt_data} ->
    # Pause and request human decisions
    {:interrupt, state, interrupt_data}

  :continue ->
    # Execute tools automatically
    execute_tools(chain)
end

Extract tool calls from the last assistant message in a chain.

Parameters

• chain: LLMChain

Returns

• List of tool calls or empty list

Example

tool_calls = AgentUtils.get_tool_calls_from_last_message(chain)
# => [%ToolCall{call_id: "1", name: "write_file", ...}, ...]