class Riffer::Messages::Assistant

Represents an assistant (LLM) message in a conversation.

May include tool calls when the LLM requests tool execution.

msg = Riffer::Messages::Assistant.new("Hello!")
msg.role        # => :assistant
msg.content     # => "Hello!"
msg.tool_calls  # => []

Constants

ToolCall

Attributes

structured_output [R]

Parsed structured output hash, or nil when not applicable.

token_usage [R]

Token usage data for this response.

tool_calls [R]

Array of tool calls requested by the assistant.

Public Class Methods

new (content, tool_calls: [], token_usage: nil, structured_output: nil)

Source

# File lib/riffer/messages/assistant.rb, line 27
def initialize(content, tool_calls: [], token_usage: nil, structured_output: nil)
  super(content)
  @tool_calls = tool_calls
  @token_usage = token_usage
  @structured_output = structured_output
end

Calls superclass method Riffer::Messages::Base::new

Public Instance Methods

+ (other)

Source

# File lib/riffer/messages/assistant.rb, line 48
def +(other)
  self.class.new("#{content}\n\n#{other.content}", tool_calls: tool_calls + other.tool_calls)
end

role ()

Source

# File lib/riffer/messages/assistant.rb, line 36
def role
  :assistant
end

structured_output? ()

Source

# File lib/riffer/messages/assistant.rb, line 42
def structured_output?
  !@structured_output.nil?
end

to_h ()

Source

# File lib/riffer/messages/assistant.rb, line 56
def to_h
  hash = {role: role, content: content}
  hash[:tool_calls] = tool_calls.map(&:to_h) unless tool_calls.empty?
  hash[:token_usage] = token_usage.to_h if token_usage
  hash[:structured_output] = structured_output if structured_output?
  hash
end

Converts the message to a hash.