@type model() :: AI.Model.t()

@type msg_response() :: {:ok, :msg, binary(), usage()}

@type msgs() :: [map()]

@type response() ::
  msg_response()
  | tool_response()
  | {:error, map()}
  | {:error, :api_unavailable}
  | {:error, :context_length_exceeded}

@type response_format() :: nil | map()

@type tool_response() :: {:ok, :tool, [map()]}

@type tools() :: nil | [AI.Tools.tool_spec()]

@type usage() :: integer()