openai 0.86.0 → 0.88.0

data/lib/openai/models/beta/threads/run_create_params.rb

@@ -18,8 +18,8 @@ module OpenAI
 
           # @!attribute assistant_id
           #   The ID of the
-          #   [assistant](https://platform.openai.com/docs/api-reference/assistants) to use to
-          #   execute this run.
+          #   [assistant](https://developers.openai.com/api/docs/assistants/migration) to use
+          #   to execute this run.
           #
           #   @return [String]
           required :assistant_id, String
@@ -30,7 +30,7 @@ module OpenAI
           #   to fetch the file search result content.
           #
           #   See the
-          #   [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+          #   [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
           #   for more information.
           #
           #   @return [Array<Symbol, OpenAI::Models::Beta::Threads::Runs::RunStepInclude>, nil]
@@ -61,8 +61,8 @@ module OpenAI
 
           # @!attribute instructions
           #   Overrides the
-          #   [instructions](https://platform.openai.com/docs/api-reference/assistants/createAssistant)
-          #   of the assistant. This is useful for modifying the behavior on a per-run basis.
+          #   [instructions](https://developers.openai.com/api/docs/assistants/migration) of
+          #   the assistant. This is useful for modifying the behavior on a per-run basis.
           #
           #   @return [String, nil]
           optional :instructions, String, nil?: true
@@ -99,17 +99,18 @@ module OpenAI
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
           # @!attribute model
-          #   The ID of the [Model](https://platform.openai.com/docs/api-reference/models) to
-          #   be used to execute this run. If a value is provided here, it will override the
-          #   model associated with the assistant. If not, the model associated with the
-          #   assistant will be used.
+          #   The ID of the
+          #   [Model](https://developers.openai.com/api/reference/resources/models) to be used
+          #   to execute this run. If a value is provided here, it will override the model
+          #   associated with the assistant. If not, the model associated with the assistant
+          #   will be used.
           #
           #   @return [String, Symbol, OpenAI::Models::ChatModel, nil]
           optional :model, union: -> { OpenAI::Beta::Threads::RunCreateParams::Model }, nil?: true
 
           # @!attribute parallel_tool_calls
           #   Whether to enable
-          #   [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
+          #   [parallel function calling](https://developers.openai.com/api/docs/guides/function-calling#parallel-function-calling)
           #   during tool use.
           #
           #   @return [Boolean, nil]
@@ -120,7 +121,7 @@ module OpenAI
           #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
           #   reasoning effort can result in faster responses and fewer tokens used on
           #   reasoning in a response. Not all reasoning models support every value. See the
-          #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+          #   [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
           #   model-specific support.
           #
           #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
@@ -128,14 +129,14 @@ module OpenAI
 
           # @!attribute response_format
           #   Specifies the format that the model must output. Compatible with
-          #   [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
-          #   [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
-          #   and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+          #   [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+          #   [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+          #   all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
           #
           #   Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
           #   Outputs which ensures the model will match your supplied JSON schema. Learn more
           #   in the
-          #   [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+          #   [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
           #
           #   Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
           #   message the model generates is valid JSON.
@@ -206,44 +207,127 @@ module OpenAI
           )
 
           # @!method initialize(thread_id:, assistant_id:, include: nil, additional_instructions: nil, additional_messages: nil, instructions: nil, max_completion_tokens: nil, max_prompt_tokens: nil, metadata: nil, model: nil, parallel_tool_calls: nil, reasoning_effort: nil, response_format: nil, temperature: nil, tool_choice: nil, tools: nil, top_p: nil, truncation_strategy: nil, request_options: {})
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Threads::RunCreateParams} for more details.
-          #
           #   @param thread_id [String]
           #
-          #   @param assistant_id [String] The ID of the [assistant](https://platform.openai.com/docs/api-reference/assista
-          #
-          #   @param include [Array<Symbol, OpenAI::Models::Beta::Threads::Runs::RunStepInclude>] A list of additional fields to include in the response. Currently the only suppo
-          #
-          #   @param additional_instructions [String, nil] Appends additional instructions at the end of the instructions for the run. This
-          #
-          #   @param additional_messages [Array<OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage>, nil] Adds additional messages to the thread before creating the run.
-          #
-          #   @param instructions [String, nil] Overrides the [instructions](https://platform.openai.com/docs/api-reference/assi
-          #
-          #   @param max_completion_tokens [Integer, nil] The maximum number of completion tokens that may be used over the course of the
-          #
-          #   @param max_prompt_tokens [Integer, nil] The maximum number of prompt tokens that may be used over the course of the run.
-          #
-          #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
-          #
-          #   @param model [String, Symbol, OpenAI::Models::ChatModel, nil] The ID of the [Model](https://platform.openai.com/docs/api-reference/models) to
-          #
-          #   @param parallel_tool_calls [Boolean] Whether to enable [parallel function calling](https://platform.openai.com/docs/g
-          #
-          #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
-          #
-          #   @param response_format [Symbol, :auto, OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONObject, OpenAI::Models::ResponseFormatJSONSchema, nil] Specifies the format that the model must output. Compatible with [GPT-4o](https:
-          #
-          #   @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
-          #
-          #   @param tool_choice [Symbol, OpenAI::Models::Beta::AssistantToolChoiceOption::Auto, OpenAI::Models::Beta::AssistantToolChoice, nil] Controls which (if any) tool is called by the model.
-          #
-          #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::FileSearchTool, OpenAI::Models::Beta::FunctionTool>, nil] Override the tools the assistant can use for this run. This is useful for modify
-          #
-          #   @param top_p [Float, nil] An alternative to sampling with temperature, called nucleus sampling, where the
-          #
-          #   @param truncation_strategy [OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy, nil] Controls for how a thread will be truncated prior to the run. Use this to contro
+          #   @param assistant_id [String]
+          #     The ID of the
+          #     [assistant](https://developers.openai.com/api/docs/assistants/migration) to use
+          #     to execute this run.
+          #
+          #   @param include [Array<Symbol, OpenAI::Models::Beta::Threads::Runs::RunStepInclude>]
+          #     A list of additional fields to include in the response. Currently the only
+          #     supported value is `step_details.tool_calls[*].file_search.results[*].content`
+          #     to fetch the file search result content.
+          #
+          #     See the
+          #     [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
+          #     for more information.
+          #
+          #   @param additional_instructions [String, nil]
+          #     Appends additional instructions at the end of the instructions for the run. This
+          #     is useful for modifying the behavior on a per-run basis without overriding other
+          #     instructions.
+          #
+          #   @param additional_messages [Array<OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage>, nil]
+          #     Adds additional messages to the thread before creating the run.
+          #
+          #   @param instructions [String, nil]
+          #     Overrides the
+          #     [instructions](https://developers.openai.com/api/docs/assistants/migration) of
+          #     the assistant. This is useful for modifying the behavior on a per-run basis.
+          #
+          #   @param max_completion_tokens [Integer, nil]
+          #     The maximum number of completion tokens that may be used over the course of the
+          #     run. The run will make a best effort to use only the number of completion tokens
+          #     specified, across multiple turns of the run. If the run exceeds the number of
+          #     completion tokens specified, the run will end with status `incomplete`. See
+          #     `incomplete_details` for more info.
+          #
+          #   @param max_prompt_tokens [Integer, nil]
+          #     The maximum number of prompt tokens that may be used over the course of the run.
+          #     The run will make a best effort to use only the number of prompt tokens
+          #     specified, across multiple turns of the run. If the run exceeds the number of
+          #     prompt tokens specified, the run will end with status `incomplete`. See
+          #     `incomplete_details` for more info.
+          #
+          #   @param metadata [Hash{Symbol=>String}, nil]
+          #     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 model [String, Symbol, OpenAI::Models::ChatModel, nil]
+          #     The ID of the
+          #     [Model](https://developers.openai.com/api/reference/resources/models) to be used
+          #     to execute this run. If a value is provided here, it will override the model
+          #     associated with the assistant. If not, the model associated with the assistant
+          #     will be used.
+          #
+          #   @param parallel_tool_calls [Boolean]
+          #     Whether to enable
+          #     [parallel function calling](https://developers.openai.com/api/docs/guides/function-calling#parallel-function-calling)
+          #     during tool use.
+          #
+          #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil]
+          #     Constrains effort on reasoning for reasoning models. Currently supported values
+          #     are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+          #     reasoning effort can result in faster responses and fewer tokens used on
+          #     reasoning in a response. Not all reasoning models support every value. See the
+          #     [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
+          #     model-specific support.
+          #
+          #   @param response_format [Symbol, :auto, OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONObject, OpenAI::Models::ResponseFormatJSONSchema, nil]
+          #     Specifies the format that the model must output. Compatible with
+          #     [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+          #     [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+          #     all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+          #
+          #     Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
+          #     Outputs which ensures the model will match your supplied JSON schema. Learn more
+          #     in the
+          #     [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
+          #
+          #     Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
+          #     message the model generates is valid JSON.
+          #
+          #     **Important:** when using JSON mode, you **must** also instruct the model to
+          #     produce JSON yourself via a system or user message. Without this, the model may
+          #     generate an unending stream of whitespace until the generation reaches the token
+          #     limit, resulting in a long-running and seemingly "stuck" request. Also note that
+          #     the message content may be partially cut off if `finish_reason="length"`, which
+          #     indicates the generation exceeded `max_tokens` or the conversation exceeded the
+          #     max context length.
+          #
+          #   @param temperature [Float, nil]
+          #     What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+          #     make the output more random, while lower values like 0.2 will make it more
+          #     focused and deterministic.
+          #
+          #   @param tool_choice [Symbol, OpenAI::Models::Beta::AssistantToolChoiceOption::Auto, OpenAI::Models::Beta::AssistantToolChoice, nil]
+          #     Controls which (if any) tool is called by the model. `none` means the model will
+          #     not call any tools and instead generates a message. `auto` is the default value
+          #     and means the model can pick between generating a message or calling one or more
+          #     tools. `required` means the model must call one or more tools before responding
+          #     to the user. Specifying a particular tool like `{"type": "file_search"}` or
+          #     `{"type": "function", "function": {"name": "my_function"}}` forces the model to
+          #     call that tool.
+          #
+          #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::FileSearchTool, OpenAI::Models::Beta::FunctionTool>, nil]
+          #     Override the tools the assistant can use for this run. This is useful for
+          #     modifying the behavior on a per-run basis.
+          #
+          #   @param top_p [Float, nil]
+          #     An alternative to sampling with temperature, called nucleus sampling, where the
+          #     model considers the results of the tokens with top_p probability mass. So 0.1
+          #     means only the tokens comprising the top 10% probability mass are considered.
+          #
+          #     We generally recommend altering this or temperature but not both.
+          #
+          #   @param truncation_strategy [OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy, nil]
+          #     Controls for how a thread will be truncated prior to the run. Use this to
+          #     control the initial context window of the run.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -289,17 +373,27 @@ module OpenAI
             optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
             # @!method initialize(content:, role:, attachments: nil, metadata: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage} for more
-            #   details.
+            #   @param content [String, Array<OpenAI::Models::Beta::Threads::ImageFileContentBlock, OpenAI::Models::Beta::Threads::ImageURLContentBlock, OpenAI::Models::Beta::Threads::TextContentBlockParam>]
+            #     The text contents of the message.
+            #
+            #   @param role [Symbol, OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Role]
+            #     The role of the entity that is creating the message. Allowed values include:
             #
-            #   @param content [String, Array<OpenAI::Models::Beta::Threads::ImageFileContentBlock, OpenAI::Models::Beta::Threads::ImageURLContentBlock, OpenAI::Models::Beta::Threads::TextContentBlockParam>] The text contents of the message.
+            #     - `user`: Indicates the message is sent by an actual user and should be used in
+            #       most cases to represent user-generated messages.
+            #     - `assistant`: Indicates the message is generated by the assistant. Use this
+            #       value to insert messages from the assistant into the conversation.
             #
-            #   @param role [Symbol, OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Role] The role of the entity that is creating the message. Allowed values include:
+            #   @param attachments [Array<OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment>, nil]
+            #     A list of files attached to the message, and the tools they should be added to.
             #
-            #   @param attachments [Array<OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment>, nil] A list of files attached to the message, and the tools they should be added to.
+            #   @param metadata [Hash{Symbol=>String}, nil]
+            #     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.
             #
-            #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+            #     Keys are strings with a maximum length of 64 characters. Values are strings with
+            #     a maximum length of 512 characters.
 
             # The text contents of the message.
             #
@@ -310,7 +404,7 @@ module OpenAI
               # The text contents of the message.
               variant String
 
-              # An array of content parts with a defined type, each can be of type `text` or images can be passed with `image_url` or `image_file`. Image types are only supported on [Vision-compatible models](https://platform.openai.com/docs/models).
+              # An array of content parts with a defined type, each can be of type `text` or images can be passed with `image_url` or `image_file`. Image types are only supported on [Vision-compatible models](https://developers.openai.com/api/docs/models).
               variant(
                 -> {
                   OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Content::MessageContentPartParamArray
@@ -365,10 +459,11 @@ module OpenAI
               )
 
               # @!method initialize(file_id: nil, tools: nil)
-              #   @param file_id [String] The ID of the file to attach to the message.
+              #   @param file_id [String]
+              #     The ID of the file to attach to the message.
               #
-              #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch>] The tools to add this file to.
-
+              #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch>]
+              #     The tools to add this file to.
               module Tool
                 extend OpenAI::Internal::Type::Union
 
@@ -389,7 +484,8 @@ module OpenAI
                   required :type, const: :file_search
 
                   # @!method initialize(type: :file_search)
-                  #   @param type [Symbol, :file_search] The type of tool being defined: `file_search`
+                  #   @param type [Symbol, :file_search]
+                  #     The type of tool being defined: `file_search`
                 end
 
                 # @!method self.variants
@@ -398,16 +494,17 @@ module OpenAI
             end
           end
 
-          # The ID of the [Model](https://platform.openai.com/docs/api-reference/models) to
-          # be used to execute this run. If a value is provided here, it will override the
-          # model associated with the assistant. If not, the model associated with the
-          # assistant will be used.
+          # The ID of the
+          # [Model](https://developers.openai.com/api/reference/resources/models) to be used
+          # to execute this run. If a value is provided here, it will override the model
+          # associated with the assistant. If not, the model associated with the assistant
+          # will be used.
           module Model
             extend OpenAI::Internal::Type::Union
 
             variant String
 
-            # The ID of the [Model](https://platform.openai.com/docs/api-reference/models) to be used to execute this run. If a value is provided here, it will override the model associated with the assistant. If not, the model associated with the assistant will be used.
+            # The ID of the [Model](https://developers.openai.com/api/reference/resources/models) to be used to execute this run. If a value is provided here, it will override the model associated with the assistant. If not, the model associated with the assistant will be used.
             variant enum: -> { OpenAI::ChatModel }
 
             # @!method self.variants
@@ -432,16 +529,18 @@ module OpenAI
             optional :last_messages, Integer, nil?: true
 
             # @!method initialize(type:, last_messages: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy} for more
-            #   details.
-            #
             #   Controls for how a thread will be truncated prior to the run. Use this to
             #   control the initial context window of the run.
             #
-            #   @param type [Symbol, OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy::Type] The truncation strategy to use for the thread. The default is `auto`. If set to
+            #   @param type [Symbol, OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy::Type]
+            #     The truncation strategy to use for the thread. The default is `auto`. If set to
+            #     `last_messages`, the thread will be truncated to the n most recent messages in
+            #     the thread. When set to `auto`, messages in the middle of the thread will be
+            #     dropped to fit the context length of the model, `max_prompt_tokens`.
             #
-            #   @param last_messages [Integer, nil] The number of most recent messages from the thread when constructing the context
+            #   @param last_messages [Integer, nil]
+            #     The number of most recent messages from the thread when constructing the context
+            #     for the run.
 
             # The truncation strategy to use for the thread. The default is `auto`. If set to
             # `last_messages`, the thread will be truncated to the n most recent messages in

data/lib/openai/models/beta/threads/run_list_params.rb

@@ -47,18 +47,27 @@ module OpenAI
           optional :order, enum: -> { OpenAI::Beta::Threads::RunListParams::Order }
 
           # @!method initialize(thread_id:, after: nil, before: nil, limit: nil, order: nil, request_options: {})
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Threads::RunListParams} for more details.
-          #
           #   @param thread_id [String]
           #
-          #   @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+          #   @param after [String]
+          #     A cursor for use in pagination. `after` is an object ID that defines your place
+          #     in the list. For instance, if you make a list request and receive 100 objects,
+          #     ending with obj_foo, your subsequent call can include after=obj_foo in order to
+          #     fetch the next page of the list.
           #
-          #   @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place
+          #   @param before [String]
+          #     A cursor for use in pagination. `before` is an object ID that defines your place
+          #     in the list. For instance, if you make a list request and receive 100 objects,
+          #     starting with obj_foo, your subsequent call can include before=obj_foo in order
+          #     to fetch the previous page of the list.
           #
-          #   @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
+          #   @param limit [Integer]
+          #     A limit on the number of objects to be returned. Limit can range between 1 and
+          #     100, and the default is 20.
           #
-          #   @param order [Symbol, OpenAI::Models::Beta::Threads::RunListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+          #   @param order [Symbol, OpenAI::Models::Beta::Threads::RunListParams::Order]
+          #     Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+          #     order and `desc` for descending order.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/beta/threads/run_submit_tool_outputs_params.rb

@@ -35,7 +35,8 @@ module OpenAI
           #
           #   @param run_id [String]
           #
-          #   @param tool_outputs [Array<OpenAI::Models::Beta::Threads::RunSubmitToolOutputsParams::ToolOutput>] A list of tools for which the outputs are being submitted.
+          #   @param tool_outputs [Array<OpenAI::Models::Beta::Threads::RunSubmitToolOutputsParams::ToolOutput>]
+          #     A list of tools for which the outputs are being submitted.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -54,13 +55,12 @@ module OpenAI
             optional :tool_call_id, String
 
             # @!method initialize(output: nil, tool_call_id: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::Threads::RunSubmitToolOutputsParams::ToolOutput} for more
-            #   details.
+            #   @param output [String]
+            #     The output of the tool call to be submitted to continue the run.
             #
-            #   @param output [String] The output of the tool call to be submitted to continue the run.
-            #
-            #   @param tool_call_id [String] The ID of the tool call in the `required_action` object within the run object th
+            #   @param tool_call_id [String]
+            #     The ID of the tool call in the `required_action` object within the run object
+            #     the output is being submitted for.
           end
         end
       end

data/lib/openai/models/beta/threads/run_update_params.rb

@@ -31,14 +31,17 @@ module OpenAI
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
           # @!method initialize(thread_id:, run_id:, metadata: nil, request_options: {})
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Threads::RunUpdateParams} for more details.
-          #
           #   @param thread_id [String]
           #
           #   @param run_id [String]
           #
-          #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+          #   @param metadata [Hash{Symbol=>String}, nil]
+          #     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 request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
         end

data/lib/openai/models/beta/threads/runs/code_interpreter_logs.rb

@@ -27,11 +27,14 @@ module OpenAI
             # @!method initialize(index:, logs: nil, type: :logs)
             #   Text output from the Code Interpreter tool call as part of a run step.
             #
-            #   @param index [Integer] The index of the output in the outputs array.
+            #   @param index [Integer]
+            #     The index of the output in the outputs array.
             #
-            #   @param logs [String] The text output from the Code Interpreter tool call.
+            #   @param logs [String]
+            #     The text output from the Code Interpreter tool call.
             #
-            #   @param type [Symbol, :logs] Always `logs`.
+            #   @param type [Symbol, :logs]
+            #     Always `logs`.
           end
         end
       end

data/lib/openai/models/beta/threads/runs/code_interpreter_output_image.rb

@@ -24,27 +24,27 @@ module OpenAI
             optional :image, -> { OpenAI::Beta::Threads::Runs::CodeInterpreterOutputImage::Image }
 
             # @!method initialize(index:, image: nil, type: :image)
-            #   @param index [Integer] The index of the output in the outputs array.
+            #   @param index [Integer]
+            #     The index of the output in the outputs array.
             #
             #   @param image [OpenAI::Models::Beta::Threads::Runs::CodeInterpreterOutputImage::Image]
             #
-            #   @param type [Symbol, :image] Always `image`.
+            #   @param type [Symbol, :image]
+            #     Always `image`.
 
             # @see OpenAI::Models::Beta::Threads::Runs::CodeInterpreterOutputImage#image
             class Image < OpenAI::Internal::Type::BaseModel
               # @!attribute file_id
-              #   The [file](https://platform.openai.com/docs/api-reference/files) ID of the
-              #   image.
+              #   The [file](https://developers.openai.com/api/reference/resources/files) ID of
+              #   the image.
               #
               #   @return [String, nil]
               optional :file_id, String
 
               # @!method initialize(file_id: nil)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Beta::Threads::Runs::CodeInterpreterOutputImage::Image} for
-              #   more details.
-              #
-              #   @param file_id [String] The [file](https://platform.openai.com/docs/api-reference/files) ID of the image
+              #   @param file_id [String]
+              #     The [file](https://developers.openai.com/api/reference/resources/files) ID of
+              #     the image.
             end
           end
         end

data/lib/openai/models/beta/threads/runs/code_interpreter_tool_call.rb

@@ -26,16 +26,17 @@ module OpenAI
             required :type, const: :code_interpreter
 
             # @!method initialize(id:, code_interpreter:, type: :code_interpreter)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall} for more details.
-            #
             #   Details of the Code Interpreter tool call the run step was involved in.
             #
-            #   @param id [String] The ID of the tool call.
+            #   @param id [String]
+            #     The ID of the tool call.
             #
-            #   @param code_interpreter [OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter] The Code Interpreter tool call definition.
+            #   @param code_interpreter [OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter]
+            #     The Code Interpreter tool call definition.
             #
-            #   @param type [Symbol, :code_interpreter] The type of tool call. This is always going to be `code_interpreter` for this ty
+            #   @param type [Symbol, :code_interpreter]
+            #     The type of tool call. This is always going to be `code_interpreter` for this
+            #     type of tool call.
 
             # @see OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall#code_interpreter
             class CodeInterpreter < OpenAI::Internal::Type::BaseModel
@@ -61,15 +62,15 @@ module OpenAI
               )
 
               # @!method initialize(input:, outputs:)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter}
-              #   for more details.
-              #
               #   The Code Interpreter tool call definition.
               #
-              #   @param input [String] The input to the Code Interpreter tool call.
+              #   @param input [String]
+              #     The input to the Code Interpreter tool call.
               #
-              #   @param outputs [Array<OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Logs, OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Image>] The outputs from the Code Interpreter tool call. Code Interpreter can output one
+              #   @param outputs [Array<OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Logs, OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Image>]
+              #     The outputs from the Code Interpreter tool call. Code Interpreter can output one
+              #     or more items, including text (`logs`) or images (`image`). Each of these are
+              #     represented by a different object type.
 
               # Text output from the Code Interpreter tool call as part of a run step.
               module Output
@@ -104,9 +105,11 @@ module OpenAI
                   # @!method initialize(logs:, type: :logs)
                   #   Text output from the Code Interpreter tool call as part of a run step.
                   #
-                  #   @param logs [String] The text output from the Code Interpreter tool call.
+                  #   @param logs [String]
+                  #     The text output from the Code Interpreter tool call.
                   #
-                  #   @param type [Symbol, :logs] Always `logs`.
+                  #   @param type [Symbol, :logs]
+                  #     Always `logs`.
                 end
 
                 class Image < OpenAI::Internal::Type::BaseModel
@@ -127,23 +130,22 @@ module OpenAI
                   # @!method initialize(image:, type: :image)
                   #   @param image [OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Image::Image]
                   #
-                  #   @param type [Symbol, :image] Always `image`.
+                  #   @param type [Symbol, :image]
+                  #     Always `image`.
 
                   # @see OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Image#image
                   class Image < OpenAI::Internal::Type::BaseModel
                     # @!attribute file_id
-                    #   The [file](https://platform.openai.com/docs/api-reference/files) ID of the
-                    #   image.
+                    #   The [file](https://developers.openai.com/api/reference/resources/files) ID of
+                    #   the image.
                     #
                     #   @return [String]
                     required :file_id, String
 
                     # @!method initialize(file_id:)
-                    #   Some parameter documentations has been truncated, see
-                    #   {OpenAI::Models::Beta::Threads::Runs::CodeInterpreterToolCall::CodeInterpreter::Output::Image::Image}
-                    #   for more details.
-                    #
-                    #   @param file_id [String] The [file](https://platform.openai.com/docs/api-reference/files) ID of the image
+                    #   @param file_id [String]
+                    #     The [file](https://developers.openai.com/api/reference/resources/files) ID of
+                    #     the image.
                   end
                 end