@type document_input() :: %{
  name: String.t(),
  content_type: String.t(),
  data: binary()
}

@type input() :: %{
  kind: :run | :suite,
  prompt_version: prompt_version_input(),
  variables: map(),
  documents: [document_input()],
  provider: provider_input() | nil,
  metadata: map() | nil
}

@type prompt_version_input() :: %{
  id: binary(),
  template: String.t(),
  version: integer()
}

@type provider_input() :: %{
  id: binary(),
  provider: atom(),
  model: String.t(),
  config: map() | nil
}

@type result() :: %{
  output: String.t(),
  input_tokens: non_neg_integer() | nil,
  output_tokens: non_neg_integer() | nil,
  latency_ms: non_neg_integer() | nil,
  cost_usd: float() | nil,
  metadata: map() | nil
}