openai 0.92.0 → 0.93.0

data/sig/openai/models/conversations/message.rbs

@@ -12,18 +12,46 @@ module OpenAI
         }
 
       class Message < OpenAI::Internal::Type::BaseModel
+        # The unique ID of the message.
         attr_accessor id: String
 
+        # The content of the message
         attr_accessor content: ::Array[OpenAI::Models::Conversations::Message::content]
 
+        # The role of the message. One of `unknown`, `user`, `assistant`, `system`,
+        # `critic`, `discriminator`, `developer`, or `tool`.
         attr_accessor role: OpenAI::Models::Conversations::Message::role
 
+        # The status of item. One of `in_progress`, `completed`, or `incomplete`.
+        # Populated when items are returned via API.
         attr_accessor status: OpenAI::Models::Conversations::Message::status
 
+        # The type of the message. Always set to `message`.
         attr_accessor type: :message
 
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
         attr_accessor phase: OpenAI::Models::Conversations::Message::phase?
 
+        # @param id
+        #   The unique ID of the message.
+        # @param content
+        #   The content of the message
+        # @param role
+        #   The role of the message. One of `unknown`, `user`, `assistant`, `system`,
+        #   `critic`, `discriminator`, `developer`, or `tool`.
+        # @param status
+        #   The status of item. One of `in_progress`, `completed`, or `incomplete`.
+        #   Populated when items are returned via API.
+        # @param phase
+        #   Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        #   final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        #   sending follow-up requests, preserve and resend phase on all assistant messages
+        #   — dropping it can degrade performance. Not used for user messages.
+        # @param type
+        #   The type of the message. Always set to `message`.
         def initialize: (
           id: String,
           content: ::Array[OpenAI::Models::Conversations::Message::content],
@@ -59,10 +87,16 @@ module OpenAI
           type reasoning_text = { text: String, ?type: :reasoning_text }
 
           class ReasoningText < OpenAI::Internal::Type::BaseModel
+            # The reasoning text from the model.
             attr_accessor text: String
 
+            # The type of the reasoning text. Always `reasoning_text`.
             attr_accessor type: :reasoning_text
 
+            # @param text
+            #   The reasoning text from the model.
+            # @param type
+            #   The type of the reasoning text. Always `reasoning_text`.
             def initialize: (text: String, ?type: :reasoning_text) -> void
 
             def to_hash: -> { text: String, ?type: :reasoning_text }

data/sig/openai/models/conversations/summary_text_content.rbs

@@ -4,10 +4,16 @@ module OpenAI
       type summary_text_content = { text: String, ?type: :summary_text }
 
       class SummaryTextContent < OpenAI::Internal::Type::BaseModel
+        # A summary of the reasoning output from the model so far.
         attr_accessor text: String
 
+        # The type of the object. Always `summary_text`.
         attr_accessor type: :summary_text
 
+        # @param text
+        #   A summary of the reasoning output from the model so far.
+        # @param type
+        #   The type of the object. Always `summary_text`.
         def initialize: (text: String, ?type: :summary_text) -> void
 
         def to_hash: -> { text: String, ?type: :summary_text }

data/sig/openai/models/create_embedding_response.rbs

@@ -9,14 +9,26 @@ module OpenAI
       }
 
     class CreateEmbeddingResponse < OpenAI::Internal::Type::BaseModel
+      # The list of embeddings generated by the model.
       attr_accessor data: ::Array[OpenAI::Embedding]
 
+      # The name of the model used to generate the embedding.
       attr_accessor model: String
 
+      # The object type, which is always "list".
       attr_accessor object: :list
 
+      # The usage information for the request.
       attr_accessor usage: OpenAI::CreateEmbeddingResponse::Usage
 
+      # @param data
+      #   The list of embeddings generated by the model.
+      # @param model
+      #   The name of the model used to generate the embedding.
+      # @param usage
+      #   The usage information for the request.
+      # @param object
+      #   The object type, which is always "list".
       def initialize: (
         data: ::Array[OpenAI::Embedding],
         model: String,
@@ -34,10 +46,16 @@ module OpenAI
       type usage = { prompt_tokens: Integer, total_tokens: Integer }
 
       class Usage < OpenAI::Internal::Type::BaseModel
+        # The number of tokens used by the prompt.
         attr_accessor prompt_tokens: Integer
 
+        # The total number of tokens used by the request.
         attr_accessor total_tokens: Integer
 
+        # @param prompt_tokens
+        #   The number of tokens used by the prompt.
+        # @param total_tokens
+        #   The total number of tokens used by the request.
         def initialize: (prompt_tokens: Integer, total_tokens: Integer) -> void
 
         def to_hash: -> { prompt_tokens: Integer, total_tokens: Integer }

data/sig/openai/models/custom_tool_input_format.rbs

@@ -10,8 +10,11 @@ module OpenAI
       type text = { ?type: :text }
 
       class Text < OpenAI::Internal::Type::BaseModel
+        # Unconstrained text format. Always `text`.
         attr_accessor type: :text
 
+        # @param type
+        #   Unconstrained text format. Always `text`.
         def initialize: (?type: :text) -> void
 
         def to_hash: -> { ?type: :text }
@@ -25,12 +28,21 @@ module OpenAI
         }
 
       class Grammar < OpenAI::Internal::Type::BaseModel
+        # The grammar definition.
         attr_accessor definition: String
 
+        # The syntax of the grammar definition. One of `lark` or `regex`.
         attr_accessor syntax: OpenAI::Models::CustomToolInputFormat::Grammar::syntax
 
+        # Grammar format. Always `grammar`.
         attr_accessor type: :grammar
 
+        # @param definition
+        #   The grammar definition.
+        # @param syntax
+        #   The syntax of the grammar definition. One of `lark` or `regex`.
+        # @param type
+        #   Grammar format. Always `grammar`.
         def initialize: (
           definition: String,
           syntax: OpenAI::Models::CustomToolInputFormat::Grammar::syntax,

data/sig/openai/models/embedding.rbs

@@ -4,12 +4,25 @@ module OpenAI
       { embedding: ::Array[Float], index: Integer, ?object: :embedding }
 
     class Embedding < OpenAI::Internal::Type::BaseModel
+      # The embedding vector, which is a list of floats. The length of vector depends on
+      # the model as listed in the
+      # [embedding guide](https://developers.openai.com/api/docs/guides/embeddings).
       attr_accessor embedding: ::Array[Float]
 
+      # The index of the embedding in the list of embeddings.
       attr_accessor index: Integer
 
+      # The object type, which is always "embedding".
       attr_accessor object: :embedding
 
+      # @param embedding
+      #   The embedding vector, which is a list of floats. The length of vector depends on
+      #   the model as listed in the
+      #   [embedding guide](https://developers.openai.com/api/docs/guides/embeddings).
+      # @param index
+      #   The index of the embedding in the list of embeddings.
+      # @param object
+      #   The object type, which is always "embedding".
       def initialize: (
         embedding: ::Array[Float],
         index: Integer,

data/sig/openai/models/embedding_create_params.rbs

@@ -14,24 +14,78 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # Input text to embed, encoded as a string or array of tokens. To embed multiple
+      # inputs in a single request, pass an array of strings or array of token arrays.
+      # The input must not exceed the max input tokens for the model (8192 tokens for
+      # all embedding models), cannot be an empty string, and any array must be 2048
+      # dimensions or less.
+      # [Example Python code](https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken)
+      # for counting tokens. In addition to the per-input token limit, all embedding
+      # models enforce a maximum of 300,000 tokens summed across all inputs in a single
+      # request.
       attr_accessor input: OpenAI::Models::EmbeddingCreateParams::input
 
+      # ID of the model to use. You can use the
+      # [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+      # API to see all of your available models, or see our
+      # [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+      # of them.
       attr_accessor model: OpenAI::Models::EmbeddingCreateParams::model
 
+      # The number of dimensions the resulting output embeddings should have. Only
+      # supported in `text-embedding-3` and later models.
       attr_reader dimensions: Integer?
 
+      # The number of dimensions the resulting output embeddings should have. Only
+      # supported in `text-embedding-3` and later models.
       def dimensions=: (Integer) -> Integer
 
+      # The format to return the embeddings in. Can be either `float` or
+      # [`base64`](https://pypi.org/project/pybase64/).
       attr_reader encoding_format: OpenAI::Models::EmbeddingCreateParams::encoding_format?
 
+      # The format to return the embeddings in. Can be either `float` or
+      # [`base64`](https://pypi.org/project/pybase64/).
       def encoding_format=: (
         OpenAI::Models::EmbeddingCreateParams::encoding_format
       ) -> OpenAI::Models::EmbeddingCreateParams::encoding_format
 
+      # A unique identifier representing your end-user, which can help OpenAI to monitor
+      # and detect abuse.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       attr_reader user: String?
 
+      # A unique identifier representing your end-user, which can help OpenAI to monitor
+      # and detect abuse.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def user=: (String) -> String
 
+      # @param input
+      #   Input text to embed, encoded as a string or array of tokens. To embed multiple
+      #   inputs in a single request, pass an array of strings or array of token arrays.
+      #   The input must not exceed the max input tokens for the model (8192 tokens for
+      #   all embedding models), cannot be an empty string, and any array must be 2048
+      #   dimensions or less.
+      #   [Example Python code](https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken)
+      #   for counting tokens. In addition to the per-input token limit, all embedding
+      #   models enforce a maximum of 300,000 tokens summed across all inputs in a single
+      #   request.
+      # @param model
+      #   ID of the model to use. You can use the
+      #   [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+      #   API to see all of your available models, or see our
+      #   [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+      #   of them.
+      # @param dimensions
+      #   The number of dimensions the resulting output embeddings should have. Only
+      #   supported in `text-embedding-3` and later models.
+      # @param encoding_format
+      #   The format to return the embeddings in. Can be either `float` or
+      #   [`base64`](https://pypi.org/project/pybase64/).
+      # @param user
+      #   A unique identifier representing your end-user, which can help OpenAI to monitor
+      #   and detect abuse.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def initialize: (
         input: OpenAI::Models::EmbeddingCreateParams::input,
         model: OpenAI::Models::EmbeddingCreateParams::model,

data/sig/openai/models/error_object.rbs

@@ -48,22 +48,34 @@ module OpenAI
         }
 
       class Misalignment < OpenAI::Internal::Type::BaseModel
+        # The public explanation for this block.
         attr_reader detailed_explanation: String?
 
+        # The public explanation for this block.
         def detailed_explanation=: (String) -> String
 
+        # An optional classification; clients must accept additional values.
         attr_reader error_type: OpenAI::Models::ErrorObject::Misalignment::error_type?
 
+        # An optional classification; clients must accept additional values.
         def error_type=: (
           OpenAI::Models::ErrorObject::Misalignment::error_type
         ) -> OpenAI::Models::ErrorObject::Misalignment::error_type
 
+        # An optional public continuation instruction.
         attr_reader steer: OpenAI::ErrorObject::Misalignment::Steer?
 
+        # An optional public continuation instruction.
         def steer=: (
           OpenAI::ErrorObject::Misalignment::Steer
         ) -> OpenAI::ErrorObject::Misalignment::Steer
 
+        # @param detailed_explanation
+        #   The public explanation for this block.
+        # @param error_type
+        #   An optional classification; clients must accept additional values.
+        # @param steer
+        #   An optional public continuation instruction.
         def initialize: (
           ?detailed_explanation: String,
           ?error_type: OpenAI::Models::ErrorObject::Misalignment::error_type,
@@ -97,8 +109,11 @@ module OpenAI
         type steer = { message: String }
 
         class Steer < OpenAI::Internal::Type::BaseModel
+          # The public continuation instruction.
           attr_accessor message: String
 
+          # @param message
+          #   The public continuation instruction.
           def initialize: (message: String) -> void
 
           def to_hash: -> { message: String }

data/sig/openai/models/eval_create_params.rbs

@@ -13,16 +13,47 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # The configuration for the data source used for the evaluation runs. Dictates the
+      # schema of the data used in the evaluation.
       attr_accessor data_source_config: OpenAI::Models::EvalCreateParams::data_source_config
 
+      # A list of graders for all eval runs in this group. Graders can reference
+      # variables in the data source using double curly braces notation, like
+      # `{{item.variable_name}}`. To reference the model's output, use the `sample`
+      # namespace (ie, `{{sample.output_text}}`).
       attr_accessor testing_criteria: ::Array[OpenAI::Models::EvalCreateParams::testing_criterion]
 
+      # Set of 16 key-value pairs that can be attached to an object. This can be useful
+      # for storing additional information about the object in a structured format, and
+      # querying for objects via API or the dashboard.
+      #
+      # Keys are strings with a maximum length of 64 characters. Values are strings with
+      # a maximum length of 512 characters.
       attr_accessor metadata: OpenAI::Models::metadata?
 
+      # The name of the evaluation.
       attr_reader name: String?
 
+      # The name of the evaluation.
       def name=: (String) -> String
 
+      # @param data_source_config
+      #   The configuration for the data source used for the evaluation runs. Dictates the
+      #   schema of the data used in the evaluation.
+      # @param testing_criteria
+      #   A list of graders for all eval runs in this group. Graders can reference
+      #   variables in the data source using double curly braces notation, like
+      #   `{{item.variable_name}}`. To reference the model's output, use the `sample`
+      #   namespace (ie, `{{sample.output_text}}`).
+      # @param metadata
+      #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+      #   for storing additional information about the object in a structured format, and
+      #   querying for objects via API or the dashboard.
+      #
+      #   Keys are strings with a maximum length of 64 characters. Values are strings with
+      #   a maximum length of 512 characters.
+      # @param name
+      #   The name of the evaluation.
       def initialize: (
         data_source_config: OpenAI::Models::EvalCreateParams::data_source_config,
         testing_criteria: ::Array[OpenAI::Models::EvalCreateParams::testing_criterion],
@@ -55,14 +86,27 @@ module OpenAI
           }
 
         class Custom < OpenAI::Internal::Type::BaseModel
+          # The json schema for each row in the data source.
           attr_accessor item_schema: ::Hash[Symbol, top]
 
+          # The type of data source. Always `custom`.
           attr_accessor type: :custom
 
+          # Whether the eval should expect you to populate the sample namespace (ie, by
+          # generating responses off of your data source)
           attr_reader include_sample_schema: bool?
 
+          # Whether the eval should expect you to populate the sample namespace (ie, by
+          # generating responses off of your data source)
           def include_sample_schema=: (bool) -> bool
 
+          # @param item_schema
+          #   The json schema for each row in the data source.
+          # @param include_sample_schema
+          #   Whether the eval should expect you to populate the sample namespace (ie, by
+          #   generating responses off of your data source)
+          # @param type
+          #   The type of data source. Always `custom`.
           def initialize: (
             item_schema: ::Hash[Symbol, top],
             ?include_sample_schema: bool,
@@ -79,12 +123,19 @@ module OpenAI
         type logs = { ?type: :logs, ?metadata: ::Hash[Symbol, top] }
 
         class Logs < OpenAI::Internal::Type::BaseModel
+          # The type of data source. Always `logs`.
           attr_accessor type: :logs
 
+          # Metadata filters for the logs data source.
           attr_reader metadata: ::Hash[Symbol, top]?
 
+          # Metadata filters for the logs data source.
           def metadata=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+          # @param metadata
+          #   Metadata filters for the logs data source.
+          # @param type
+          #   The type of data source. Always `logs`.
           def initialize: (?metadata: ::Hash[Symbol, top], ?type: :logs) -> void
 
           def to_hash: -> { ?type: :logs, ?metadata: ::Hash[Symbol, top] }
@@ -94,12 +145,19 @@ module OpenAI
           { ?type: :stored_completions, ?metadata: ::Hash[Symbol, top] }
 
         class StoredCompletions < OpenAI::Internal::Type::BaseModel
+          # The type of data source. Always `stored_completions`.
           attr_accessor type: :stored_completions
 
+          # Metadata filters for the stored completions data source.
           attr_reader metadata: ::Hash[Symbol, top]?
 
+          # Metadata filters for the stored completions data source.
           def metadata=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+          # @param metadata
+          #   Metadata filters for the stored completions data source.
+          # @param type
+          #   The type of data source. Always `stored_completions`.
           def initialize: (
             ?metadata: ::Hash[Symbol, top],
             ?type: :stored_completions
@@ -135,18 +193,38 @@ module OpenAI
           }
 
         class LabelModel < OpenAI::Internal::Type::BaseModel
+          # A list of chat messages forming the prompt or context. May include variable
+          # references to the `item` namespace, ie {{item.name}}.
           attr_accessor input: ::Array[OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::input]
 
+          # The labels to classify to each item in the evaluation.
           attr_accessor labels: ::Array[String]
 
+          # The model to use for the evaluation. Must support structured outputs.
           attr_accessor model: String
 
+          # The name of the grader.
           attr_accessor name: String
 
+          # The labels that indicate a passing result. Must be a subset of labels.
           attr_accessor passing_labels: ::Array[String]
 
+          # The object type, which is always `label_model`.
           attr_accessor type: :label_model
 
+          # @param input
+          #   A list of chat messages forming the prompt or context. May include variable
+          #   references to the `item` namespace, ie {{item.name}}.
+          # @param labels
+          #   The labels to classify to each item in the evaluation.
+          # @param model
+          #   The model to use for the evaluation. Must support structured outputs.
+          # @param name
+          #   The name of the grader.
+          # @param passing_labels
+          #   The labels that indicate a passing result. Must be a subset of labels.
+          # @param type
+          #   The object type, which is always `label_model`.
           def initialize: (
             input: ::Array[OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::input],
             labels: ::Array[String],
@@ -175,10 +253,16 @@ module OpenAI
             type simple_input_message = { content: String, role: String }
 
             class SimpleInputMessage < OpenAI::Internal::Type::BaseModel
+              # The content of the message.
               attr_accessor content: String
 
+              # The role of the message (e.g. "system", "assistant", "user").
               attr_accessor role: String
 
+              # @param content
+              #   The content of the message.
+              # @param role
+              #   The role of the message (e.g. "system", "assistant", "user").
               def initialize: (content: String, role: String) -> void
 
               def to_hash: -> { content: String, role: String }
@@ -192,16 +276,30 @@ module OpenAI
               }
 
             class EvalItem < OpenAI::Internal::Type::BaseModel
+              # Inputs to the model - can contain template strings. Supports text, output text,
+              # input images, and input audio, either as a single item or an array of items.
               attr_accessor content: OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::content
 
+              # The role of the message input. One of `user`, `assistant`, `system`, or
+              # `developer`.
               attr_accessor role: OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::role
 
+              # The type of the message input. Always `message`.
               attr_reader type: OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::type_?
 
+              # The type of the message input. Always `message`.
               def type=: (
                 OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::type_
               ) -> OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::type_
 
+              # @param content
+              #   Inputs to the model - can contain template strings. Supports text, output text,
+              #   input images, and input audio, either as a single item or an array of items.
+              # @param role
+              #   The role of the message input. One of `user`, `assistant`, `system`, or
+              #   `developer`.
+              # @param type
+              #   The type of the message input. Always `message`.
               def initialize: (
                 content: OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::content,
                 role: OpenAI::Models::EvalCreateParams::TestingCriterion::LabelModel::Input::EvalItem::role,
@@ -228,10 +326,16 @@ module OpenAI
                 type output_text = { text: String, ?type: :output_text }
 
                 class OutputText < OpenAI::Internal::Type::BaseModel
+                  # The text output from the model.
                   attr_accessor text: String
 
+                  # The type of the output text. Always `output_text`.
                   attr_accessor type: :output_text
 
+                  # @param text
+                  #   The text output from the model.
+                  # @param type
+                  #   The type of the output text. Always `output_text`.
                   def initialize: (text: String, ?type: :output_text) -> void
 
                   def to_hash: -> { text: String, ?type: :output_text }
@@ -241,14 +345,27 @@ module OpenAI
                   { image_url: String, ?type: :input_image, ?detail: String }
 
                 class InputImage < OpenAI::Internal::Type::BaseModel
+                  # The URL of the image input.
                   attr_accessor image_url: String
 
+                  # The type of the image input. Always `input_image`.
                   attr_accessor type: :input_image
 
+                  # The detail level of the image to be sent to the model. One of `high`, `low`, or
+                  # `auto`. Defaults to `auto`.
                   attr_reader detail: String?
 
+                  # The detail level of the image to be sent to the model. One of `high`, `low`, or
+                  # `auto`. Defaults to `auto`.
                   def detail=: (String) -> String
 
+                  # @param image_url
+                  #   The URL of the image input.
+                  # @param detail
+                  #   The detail level of the image to be sent to the model. One of `high`, `low`, or
+                  #   `auto`. Defaults to `auto`.
+                  # @param type
+                  #   The type of the image input. Always `input_image`.
                   def initialize: (
                     image_url: String,
                     ?detail: String,
@@ -304,10 +421,25 @@ module OpenAI
           }
 
         class TextSimilarity < OpenAI::Models::Graders::TextSimilarityGrader
+          # The threshold for the score.
           def pass_threshold: -> Float
 
+          # The threshold for the score.
           def pass_threshold=: (Float _) -> Float
 
+          # @param evaluation_metric
+          #   The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`, `gleu`,
+          #   `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
+          # @param input
+          #   The text being graded.
+          # @param name
+          #   The name of the grader.
+          # @param reference
+          #   The text being graded against.
+          # @param pass_threshold
+          #   The threshold for the score.
+          # @param type
+          #   The type of grader.
           def initialize: (
             evaluation_metric: OpenAI::Models::Graders::TextSimilarityGrader::evaluation_metric,
             input: String,
@@ -337,10 +469,22 @@ module OpenAI
           }
 
         class Python < OpenAI::Models::Graders::PythonGrader
+          # The threshold for the score.
           def pass_threshold: -> Float?
 
+          # The threshold for the score.
           def pass_threshold=: (Float _) -> Float
 
+          # @param name
+          #   The name of the grader.
+          # @param source
+          #   The source code of the python script.
+          # @param image_tag
+          #   The image tag to use for the python script.
+          # @param pass_threshold
+          #   The threshold for the score.
+          # @param type
+          #   The object type, which is always `python`.
           def initialize: (
             name: String,
             source: String,
@@ -370,10 +514,27 @@ module OpenAI
           }
 
         class ScoreModel < OpenAI::Models::Graders::ScoreModelGrader
+          # The threshold for the score.
           def pass_threshold: -> Float?
 
+          # The threshold for the score.
           def pass_threshold=: (Float _) -> Float
 
+          # @param input
+          #   The input messages evaluated by the grader. Supports text, output text, input
+          #   image, and input audio content blocks, and may include template strings.
+          # @param model
+          #   The model to use for the evaluation.
+          # @param name
+          #   The name of the grader.
+          # @param range
+          #   The range of the score. Defaults to `[0, 1]`.
+          # @param sampling_params
+          #   The sampling parameters for the model.
+          # @param pass_threshold
+          #   The threshold for the score.
+          # @param type
+          #   The object type, which is always `score_model`.
           def initialize: (
             input: ::Array[OpenAI::Graders::ScoreModelGrader::Input],
             model: String,