@type prompt() :: String.t() | [map()]

@type t() :: %GEPA.LLM.Request{
  input: prompt() | nil,
  max_tokens: pos_integer() | nil,
  messages: [map()] | nil,
  metadata: map(),
  model: String.t() | nil,
  provider_opts: keyword(),
  schema: keyword() | map() | nil,
  session: term(),
  stream?: boolean(),
  system: String.t() | nil,
  temperature: float() | nil,
  timeout: pos_integer() | nil,
  tool_choice: :auto | :none | :required | {:tool, String.t()} | nil,
  tools: [term()],
  top_p: float() | nil
}