Class: Ask::Conversation

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/ask/conversation.rb

Overview

Ordered collection of messages comprising a conversation with an LLM. Provides role normalization, serialization helpers, and Enumerable access.

conv = Ask::Conversation.new
conv << Ask::Message.new(role: :user, content: "Hello")
conv.system("Be helpful")
conv.to_a  # => [{ role: :user, content: "Hello" }, ...]

Instance Method Summary collapse

Constructor Details

#initialize(messages = []) ⇒ Conversation

Returns a new instance of Conversation.

Parameters:

  • messages (Array<Ask::Message>) (defaults to: []) —

    initial messages



151
152
153
154
 
# File 'lib/ask/conversation.rb', line 151

def initialize(messages = [])
  @messages = []
  messages.each { |m| self << m }
end

Instance Method Details

#<<(message) ⇒ self Also known as: add

Add a message by object or by attributes.

Parameters:

  • message (Ask::Message, Hash, String) —

    message or attributes

Returns:

  • (self) 


159
160
161
162
163
 
# File 'lib/ask/conversation.rb', line 159

def <<(message)
  msg = message.is_a?(Message) ? message : build_message(message)
  @messages << msg
  self
end

#[](index) ⇒ Ask::Message?

Access message by index.

Parameters:

  • index (Integer) —

    zero-based index

Returns:



224
225
226
 
# File 'lib/ask/conversation.rb', line 224

def [](index)
  @messages[index]
end

#assistant(text = nil, tool_calls: nil, **options) ⇒ self

Add an assistant message.

Parameters:

  • text (String, nil) (defaults to: nil) —

    message content (nil when tool_calls are present)

  • tool_calls (Array<Hash>, nil) (defaults to: nil) —

    tool call invocations

Returns:

  • (self) 


184
185
186
 
# File 'lib/ask/conversation.rb', line 184

def assistant(text = nil, tool_calls: nil, **options)
  self << Message.new(role: :assistant, content: text, tool_calls: tool_calls, **options)
end

#assistant_messages ⇒ Array<Ask::Message>

Returns assistant messages.

Returns:



246
 
# File 'lib/ask/conversation.rb', line 246

def assistant_messages = by_role(:assistant)

#by_role(role) ⇒ Array<Ask::Message>

Returns messages with the given role.

Parameters:

  • role (Symbol, String) —

    role to filter by

Returns:



235
236
237
 
# File 'lib/ask/conversation.rb', line 235

def by_role(role)
  @messages.select { |m| m.role == role.to_sym }
end

#clear ⇒ self

Remove all messages.

Returns:

  • (self) 


216
217
218
219
 
# File 'lib/ask/conversation.rb', line 216

def clear
  @messages.clear
  self
end

#dup ⇒ Ask::Conversation

Deep copy of this conversation.

Returns:



253
254
255
 
# File 'lib/ask/conversation.rb', line 253

def dup
  Conversation.new(@messages.map { |m| Message.new(**m.to_h) })
end

#each {|Message| ... } ⇒ Enumerator

Returns if no block given.

Yields:

  • (Message) —

    yields each message in order

Returns:

  • (Enumerator) —

    if no block given



198
199
200
 
# File 'lib/ask/conversation.rb', line 198

def each(&block)
  @messages.each(&block)
end

#empty? ⇒ Boolean

Returns true if there are no messages.

Returns:

  • (Boolean) —

    true if there are no messages



212
 
# File 'lib/ask/conversation.rb', line 212

def empty? = @messages.empty?

#inspect ⇒ String

Returns:

  • (String) 


258
259
260
 
# File 'lib/ask/conversation.rb', line 258

def inspect
  "#<Ask::Conversation messages=#{@messages.length}>"
end

#last(n = nil) ⇒ Ask::Message+

Returns last message or last n messages.

Returns:



203
204
205
 
# File 'lib/ask/conversation.rb', line 203

def last(n = nil)
  n ? @messages.last(n) : @messages.last
end

#length ⇒ Integer Also known as: size

Returns number of messages.

Returns:

  • (Integer) —

    number of messages



208
 
# File 'lib/ask/conversation.rb', line 208

def length = @messages.length

#system(text, **options) ⇒ self

Add a system message.

Parameters:

  • text (String) —

    message content

Returns:

  • (self) 


169
170
171
 
# File 'lib/ask/conversation.rb', line 169

def system(text, **options)
  self << Message.new(role: :system, content: text, **options)
end

#system_messages ⇒ Array<Ask::Message>

Returns system messages.

Returns:



240
 
# File 'lib/ask/conversation.rb', line 240

def system_messages = by_role(:system)

#to_a ⇒ Array<Hash>

Returns messages as an array of hashes.

Returns:

  • (Array<Hash>) —

    messages as an array of hashes



229
230
231
 
# File 'lib/ask/conversation.rb', line 229

def to_a
  @messages.map(&:to_h)
end

#tool_messages ⇒ Array<Ask::Message>

Returns tool messages.

Returns:



249
 
# File 'lib/ask/conversation.rb', line 249

def tool_messages = by_role(:tool)

#tool_result(content, tool_call_id:, **options) ⇒ self

Add a tool result message.

Parameters:

  • content (String) —

    tool output

  • tool_call_id (String) —

    ID of the tool call this result is for

Returns:

  • (self) 


192
193
194
 
# File 'lib/ask/conversation.rb', line 192

def tool_result(content, tool_call_id:, **options)
  self << Message.new(role: :tool, content: content, tool_call_id: tool_call_id, **options)
end

#user(text, **options) ⇒ self

Add a user message.

Parameters:

  • text (String) —

    message content

Returns:

  • (self) 


176
177
178
 
# File 'lib/ask/conversation.rb', line 176

def user(text, **options)
  self << Message.new(role: :user, content: text, **options)
end

#user_messages ⇒ Array<Ask::Message>

Returns user messages.

Returns:



243
 
# File 'lib/ask/conversation.rb', line 243

def user_messages = by_role(:user)