@type create_completion_params() :: %{
  :model => String.t(),
  :messages => [message()],
  optional(:temperature) => float(),
  optional(:top_p) => float(),
  optional(:n) => integer(),
  optional(:stream) => boolean(),
  optional(:stop) => String.t() | [String.t()],
  optional(:max_tokens) => integer(),
  optional(:presence_penalty) => float(),
  optional(:frequency_penalty) => float(),
  optional(:logit_bias) => %{required(String.t()) => float()},
  optional(:response_format) => response_format(),
  optional(:tools) => [tool()],
  optional(:tool_choice) => String.t() | tool_choice(),
  optional(:user) => String.t()
}

@type message() :: %{role: String.t(), content: String.t()}

@type response_format() :: %{:type => String.t(), optional(:json_schema) => map()}

@type tool() :: %{type: String.t(), function: tool_function()}

@type tool_choice() :: %{type: String.t(), function: tool_function()}

@type tool_choice_function() :: %{name: String.t()}

@type tool_function() :: %{
  :name => String.t(),
  optional(:description) => String.t(),
  optional(:parameters) => map()
}