leadchat/enterprise/app/services/captain/assistant/trace_payload_helper.rb

module Captain::Assistant::TracePayloadHelper
  private

  def enrich_context_with_trace_payload!(context, message_history, message_to_process)
    context[:captain_v2_trace_input] = serialize_trace_messages(message_history)
    context[:captain_v2_trace_current_input] = serialize_trace_content(message_to_process)
  end

  def serialize_trace_messages(message_history)
    message_history.map do |message|
      {
        role: message[:role].to_s,
        content: trace_content_payload(message[:content])
      }
    end.to_json
  end

  def serialize_trace_content(content)
    payload = trace_content_payload(content)
    return '' if payload.blank?

    payload.is_a?(String) ? payload : payload.to_json
  end

  def trace_content_payload(content)
    case content
    when RubyLLM::Content
      trace_parts_from_ruby_llm_content(content)
    when Array, Hash
      content
    when NilClass
      ''
    else
      content.to_s
    end
  end

  def trace_parts_from_ruby_llm_content(content)
    parts = []
    parts << { type: 'text', text: content.text } if content.text.present?

    content.attachments.each do |attachment|
      parts << { type: 'image_url', image_url: { url: attachment.source.to_s } }
    end

    return '' if parts.blank?
    return parts.first[:text] if parts.one? && parts.first[:type] == 'text'

    parts
  end
end