class RubyLLM::Progress

Progress a tool or an MCP server reports while it works. A Tool reports it with Tool#progress; Chat#after_tool_progress and MCP.after_progress callbacks receive it.

chat.after_tool_progress do |tool_call, progress|
  puts "#{tool_call.name}: #{progress.message} #{progress.value}/#{progress.total}"
end

What the tool or server is doing, or nil.

How much work there is in total, or nil when the reporter does not know.

How much work is done, or nil when only a message was reported. It only grows, but its unit is the reporter’s.

Source

# File lib/ruby_llm/progress.rb, line 34
def fraction
  value.to_f / total if value && total&.positive?
end

Returns the share of work done, from 0.0 to 1.0, or nil without a value and a total.