defmodule LlmComposer.LlmResponse do
  @moduledoc """
  Normalized representation of a response coming from any provider.

  Parser modules are responsible for translating provider-specific HTTP results into
  this normalized struct so the rest of the library can stay provider-agnostic.
  """

  alias LlmComposer.CostInfo
  alias LlmComposer.Message

  @type provider() :: :open_ai | :open_ai_responses | :ollama | :open_router | :bedrock | :google

  @type t() :: %__MODULE__{
          cached_tokens: non_neg_integer() | nil,
          cost_info: CostInfo.t() | nil,
          function_calls: [LlmComposer.FunctionCall.t()] | nil,
          input_tokens: non_neg_integer() | nil,
          main_response: Message.t() | nil,
          metadata: map(),
          output_tokens: non_neg_integer() | nil,
          previous_response: map() | nil,
          provider: provider(),
          provider_model: String.t() | nil,
          raw: any(),
          reasoning_tokens: non_neg_integer() | nil,
          response_id: String.t() | nil,
          status: :ok | :error,
          stream: nil | Enumerable.t()
        }

  defstruct [
    :cached_tokens,
    :cost_info,
    :function_calls,
    :input_tokens,
    :main_response,
    :metadata,
    :output_tokens,
    :previous_response,
    :provider,
    :provider_model,
    :raw,
    :reasoning_tokens,
    :response_id,
    :status,
    :stream
  ]

  @spec new(map()) :: t()
  def new(attrs \\ %{}) when is_map(attrs) do
    attrs = Map.put_new(attrs, :metadata, %{})
    struct!(__MODULE__, attrs)
  end
end