class Riffer::Messages::Assistant
rbs_inline: enabled
Constants
- PART_TAGS
- REASONING_TEXT_TYPES
-
The other reasoning part types carry no prose.
Attributes
The turn in the order the provider produced it. content, tool_calls and reasoning are views over it.
Public Class Methods
Source
# File lib/riffer/messages/assistant.rb, line 17 def self.from_hash(msg) return msg if msg.is_a?(Riffer::Messages::Assistant) new( msg[:content], id: msg[:id], parts: msg[:parts]&.map { |part| part_from_hash(part) }, tool_calls: (msg[:tool_calls] || []).map { |tc| Riffer::Messages::Assistant::ToolCall.from_hash(tc) }, reasoning: (msg[:reasoning] || []).map { |part| Riffer::Messages::Assistant::ReasoningPart.from_hash(part) }, token_usage: msg[:token_usage] && Riffer::Providers::TokenUsage.from_hash(msg[:token_usage]), structured_output: msg[:structured_output], finish_reason: msg[:finish_reason]&.to_sym, finish_reason_raw: msg[:finish_reason_raw], ) end
Source
# File lib/riffer/messages/assistant.rb, line 67 def initialize( content = nil, id: nil, parts: nil, tool_calls: [], reasoning: [], token_usage: nil, structured_output: nil, finish_reason: nil, finish_reason_raw: nil ) if finish_reason && !Riffer::Providers::FinishReason::VALUES.include?(finish_reason) values = Riffer::Providers::FinishReason::VALUES.inspect raise Riffer::ArgumentError, "finish_reason must be one of #{values}, got #{finish_reason.inspect}" end if parts && (content || !tool_calls.empty? || !reasoning.empty?) raise Riffer::ArgumentError, "pass either parts: or content, tool_calls: and reasoning:, not both" end @parts = parts || default_parts(content, tool_calls, reasoning) super(@parts.filter_map { |part| part.text if part.is_a?(Riffer::Messages::Assistant::TextPart) }.join, id: id) @tool_calls = @parts.grep(Riffer::Messages::Assistant::ToolCall) #: Array[Riffer::Messages::Assistant::ToolCall] @reasoning = @parts.grep(Riffer::Messages::Assistant::ReasoningPart) #: Array[Riffer::Messages::Assistant::ReasoningPart] @token_usage = token_usage @structured_output = structured_output @finish_reason = finish_reason @finish_reason_raw = finish_reason_raw end
Without parts:, the parts are built in a fixed order: reasoning, then the content as one text part, then tool calls.
Calls superclass method
Riffer::Messages::Base::new
Public Instance Methods
Source
# File lib/riffer/messages/assistant.rb, line 130 def +(other) unless [self, other].all? { |message| described_by_fields?(message) } merged = parts.dup merged << Riffer::Messages::Assistant::TextPart.new("\n\n") unless content.empty? || other.content.empty? return self.class.new(parts: merged.concat(other.parts)) end self.class.new( "#{content}\n\n#{other.content}", tool_calls: tool_calls + other.tool_calls, reasoning: reasoning + other.reasoning, ) end
Source
# File lib/riffer/messages/assistant.rb, line 111 def has_tool_calls? !@tool_calls.empty? end
Source
# File lib/riffer/messages/assistant.rb, line 117 def reasoning? !@reasoning.empty? end
Source
# File lib/riffer/messages/assistant.rb, line 123 def reasoning_text texts = reasoning.filter_map { |part| part.text if REASONING_TEXT_TYPES.include?(part.type) } texts.empty? ? nil : texts.join("\n\n") end
Source
# File lib/riffer/messages/assistant.rb, line 105 def structured_output? !@structured_output.nil? end
Source
# File lib/riffer/messages/assistant.rb, line 146 def to_h hash = { role: role } #: Hash[Symbol, untyped] hash[:id] = id if id hash[:parts] = parts.map { |part| { part: PART_TAGS.fetch(part.class), **part.to_h } } hash[:token_usage] = token_usage.to_h if token_usage hash[:structured_output] = structured_output if structured_output? hash[:finish_reason] = finish_reason if finish_reason hash[:finish_reason_raw] = finish_reason_raw if finish_reason_raw hash end