openai 0.86.0 → 0.88.0

data/lib/openai/models/beta/beta_tool_choice_allowed.rb

@@ -41,16 +41,31 @@ module OpenAI
         required :type, const: :allowed_tools
 
         # @!method initialize(mode:, tools:, type: :allowed_tools)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaToolChoiceAllowed} for more details.
-        #
         #   Constrains the tools available to the model to a pre-defined set.
         #
-        #   @param mode [Symbol, OpenAI::Models::Beta::BetaToolChoiceAllowed::Mode] Constrains the tools available to the model to a pre-defined set.
+        #   @param mode [Symbol, OpenAI::Models::Beta::BetaToolChoiceAllowed::Mode]
+        #     Constrains the tools available to the model to a pre-defined set.
+        #
+        #     `auto` allows the model to pick from among the allowed tools and generate a
+        #     message.
+        #
+        #     `required` requires the model to call one or more of the allowed tools.
+        #
+        #   @param tools [Array<Hash{Symbol=>Object}>]
+        #     A list of tool definitions that the model should be allowed to call.
+        #
+        #     For the Responses API, the list of tool definitions might look like:
         #
-        #   @param tools [Array<Hash{Symbol=>Object}>] A list of tool definitions that the model should be allowed to call.
+        #     ```json
+        #     [
+        #       { "type": "function", "name": "get_weather" },
+        #       { "type": "mcp", "server_label": "deepwiki" },
+        #       { "type": "image_generation" }
+        #     ]
+        #     ```
         #
-        #   @param type [Symbol, :allowed_tools] Allowed tool configuration type. Always `allowed_tools`.
+        #   @param type [Symbol, :allowed_tools]
+        #     Allowed tool configuration type. Always `allowed_tools`.
 
         # Constrains the tools available to the model to a pre-defined set.
         #

data/lib/openai/models/beta/beta_tool_choice_apply_patch.rb

@@ -13,7 +13,8 @@ module OpenAI
         # @!method initialize(type: :apply_patch)
         #   Forces the model to call the apply_patch tool when executing a tool call.
         #
-        #   @param type [Symbol, :apply_patch] The tool to call. Always `apply_patch`.
+        #   @param type [Symbol, :apply_patch]
+        #     The tool to call. Always `apply_patch`.
       end
     end
 

data/lib/openai/models/beta/beta_tool_choice_custom.rb

@@ -19,9 +19,11 @@ module OpenAI
         # @!method initialize(name:, type: :custom)
         #   Use this option to force the model to call a specific custom tool.
         #
-        #   @param name [String] The name of the custom tool to call.
+        #   @param name [String]
+        #     The name of the custom tool to call.
         #
-        #   @param type [Symbol, :custom] For custom tool calling, the type is always `custom`.
+        #   @param type [Symbol, :custom]
+        #     For custom tool calling, the type is always `custom`.
       end
     end
 

data/lib/openai/models/beta/beta_tool_choice_function.rb

@@ -19,9 +19,11 @@ module OpenAI
         # @!method initialize(name:, type: :function)
         #   Use this option to force the model to call a specific function.
         #
-        #   @param name [String] The name of the function to call.
+        #   @param name [String]
+        #     The name of the function to call.
         #
-        #   @param type [Symbol, :function] For function calling, the type is always `function`.
+        #   @param type [Symbol, :function]
+        #     For function calling, the type is always `function`.
       end
     end
 

data/lib/openai/models/beta/beta_tool_choice_mcp.rb

@@ -23,17 +23,17 @@ module OpenAI
         optional :name, String, nil?: true
 
         # @!method initialize(server_label:, name: nil, type: :mcp)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaToolChoiceMcp} for more details.
-        #
         #   Use this option to force the model to call a specific tool on a remote MCP
         #   server.
         #
-        #   @param server_label [String] The label of the MCP server to use.
+        #   @param server_label [String]
+        #     The label of the MCP server to use.
         #
-        #   @param name [String, nil] The name of the tool to call on the server.
+        #   @param name [String, nil]
+        #     The name of the tool to call on the server.
         #
-        #   @param type [Symbol, :mcp] For MCP tools, the type is always `mcp`.
+        #   @param type [Symbol, :mcp]
+        #     For MCP tools, the type is always `mcp`.
       end
     end
 

data/lib/openai/models/beta/beta_tool_choice_shell.rb

@@ -13,7 +13,8 @@ module OpenAI
         # @!method initialize(type: :shell)
         #   Forces the model to call the shell tool when a tool call is required.
         #
-        #   @param type [Symbol, :shell] The tool to call. Always `shell`.
+        #   @param type [Symbol, :shell]
+        #     The tool to call. Always `shell`.
       end
     end
 

data/lib/openai/models/beta/beta_tool_choice_types.rb

@@ -6,7 +6,7 @@ module OpenAI
       class BetaToolChoiceTypes < OpenAI::Internal::Type::BaseModel
         # @!attribute type
         #   The type of hosted tool the model should to use. Learn more about
-        #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+        #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
         #
         #   Allowed values are:
         #
@@ -22,16 +22,25 @@ module OpenAI
         required :type, enum: -> { OpenAI::Beta::BetaToolChoiceTypes::Type }
 
         # @!method initialize(type:)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaToolChoiceTypes} for more details.
-        #
         #   Indicates that the model should use a built-in tool to generate a response.
-        #   [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+        #   [Learn more about built-in tools](https://developers.openai.com/api/docs/guides/tools).
+        #
+        #   @param type [Symbol, OpenAI::Models::Beta::BetaToolChoiceTypes::Type]
+        #     The type of hosted tool the model should to use. Learn more about
+        #     [built-in tools](https://developers.openai.com/api/docs/guides/tools).
+        #
+        #     Allowed values are:
         #
-        #   @param type [Symbol, OpenAI::Models::Beta::BetaToolChoiceTypes::Type] The type of hosted tool the model should to use. Learn more about
+        #     - `file_search`
+        #     - `web_search_preview`
+        #     - `computer`
+        #     - `computer_use_preview`
+        #     - `computer_use`
+        #     - `code_interpreter`
+        #     - `image_generation`
 
         # The type of hosted tool the model should to use. Learn more about
-        # [built-in tools](https://platform.openai.com/docs/guides/tools).
+        # [built-in tools](https://developers.openai.com/api/docs/guides/tools).
         #
         # Allowed values are:
         #

data/lib/openai/models/beta/beta_tool_search_tool.rb

@@ -31,13 +31,17 @@ module OpenAI
         # @!method initialize(description: nil, execution: nil, parameters: nil, type: :tool_search)
         #   Hosted or BYOT tool search configuration for deferred tools.
         #
-        #   @param description [String, nil] Description shown to the model for a client-executed tool search tool.
+        #   @param description [String, nil]
+        #     Description shown to the model for a client-executed tool search tool.
         #
-        #   @param execution [Symbol, OpenAI::Models::Beta::BetaToolSearchTool::Execution] Whether tool search is executed by the server or by the client.
+        #   @param execution [Symbol, OpenAI::Models::Beta::BetaToolSearchTool::Execution]
+        #     Whether tool search is executed by the server or by the client.
         #
-        #   @param parameters [Object, nil] Parameter schema for a client-executed tool search tool.
+        #   @param parameters [Object, nil]
+        #     Parameter schema for a client-executed tool search tool.
         #
-        #   @param type [Symbol, :tool_search] The type of the tool. Always `tool_search`.
+        #   @param type [Symbol, :tool_search]
+        #     The type of the tool. Always `tool_search`.
 
         # Whether tool search is executed by the server or by the client.
         #

data/lib/openai/models/beta/beta_web_search_preview_tool.rb

@@ -33,20 +33,22 @@ module OpenAI
         optional :user_location, -> { OpenAI::Beta::BetaWebSearchPreviewTool::UserLocation }, nil?: true
 
         # @!method initialize(type:, search_content_types: nil, search_context_size: nil, user_location: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaWebSearchPreviewTool} for more details.
-        #
         #   This tool searches the web for relevant results to use in a response. Learn more
         #   about the
-        #   [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+        #   [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
         #
-        #   @param type [Symbol, OpenAI::Models::Beta::BetaWebSearchPreviewTool::Type] The type of the web search tool. One of `web_search_preview` or `web_search_prev
+        #   @param type [Symbol, OpenAI::Models::Beta::BetaWebSearchPreviewTool::Type]
+        #     The type of the web search tool. One of `web_search_preview` or
+        #     `web_search_preview_2025_03_11`.
         #
         #   @param search_content_types [Array<Symbol, OpenAI::Models::Beta::BetaWebSearchPreviewTool::SearchContentType>]
         #
-        #   @param search_context_size [Symbol, OpenAI::Models::Beta::BetaWebSearchPreviewTool::SearchContextSize] High level guidance for the amount of context window space to use for the search
+        #   @param search_context_size [Symbol, OpenAI::Models::Beta::BetaWebSearchPreviewTool::SearchContextSize]
+        #     High level guidance for the amount of context window space to use for the
+        #     search. One of `low`, `medium`, or `high`. `medium` is the default.
         #
-        #   @param user_location [OpenAI::Models::Beta::BetaWebSearchPreviewTool::UserLocation, nil] The user's location.
+        #   @param user_location [OpenAI::Models::Beta::BetaWebSearchPreviewTool::UserLocation, nil]
+        #     The user's location.
 
         # The type of the web search tool. One of `web_search_preview` or
         # `web_search_preview_2025_03_11`.
@@ -122,20 +124,24 @@ module OpenAI
           optional :timezone, String, nil?: true
 
           # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: :approximate)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaWebSearchPreviewTool::UserLocation} for more details.
-          #
           #   The user's location.
           #
-          #   @param city [String, nil] Free text input for the city of the user, e.g. `San Francisco`.
+          #   @param city [String, nil]
+          #     Free text input for the city of the user, e.g. `San Francisco`.
           #
-          #   @param country [String, nil] The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of t
+          #   @param country [String, nil]
+          #     The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          #     the user, e.g. `US`.
           #
-          #   @param region [String, nil] Free text input for the region of the user, e.g. `California`.
+          #   @param region [String, nil]
+          #     Free text input for the region of the user, e.g. `California`.
           #
-          #   @param timezone [String, nil] The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user
+          #   @param timezone [String, nil]
+          #     The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          #     user, e.g. `America/Los_Angeles`.
           #
-          #   @param type [Symbol, :approximate] The type of location approximation. Always `approximate`.
+          #   @param type [Symbol, :approximate]
+          #     The type of location approximation. Always `approximate`.
         end
       end
     end

data/lib/openai/models/beta/beta_web_search_tool.rb

@@ -38,21 +38,26 @@ module OpenAI
         optional :user_location, -> { OpenAI::Beta::BetaWebSearchTool::UserLocation }, nil?: true
 
         # @!method initialize(type:, external_web_access: nil, filters: nil, search_context_size: nil, user_location: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaWebSearchTool} for more details.
-        #
         #   Search the Internet for sources related to the prompt. Learn more about the
-        #   [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+        #   [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
         #
-        #   @param type [Symbol, OpenAI::Models::Beta::BetaWebSearchTool::Type] The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+        #   @param type [Symbol, OpenAI::Models::Beta::BetaWebSearchTool::Type]
+        #     The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         #
-        #   @param external_web_access [Boolean] Allow live internet access for web search. Defaults to true when omitted. When f
+        #   @param external_web_access [Boolean]
+        #     Allow live internet access for web search. Defaults to true when omitted. When
+        #     false, the web search tool runs in offline/cache-only mode and will not fetch
+        #     new external content.
         #
-        #   @param filters [OpenAI::Models::Beta::BetaWebSearchTool::Filters, nil] Filters for the search.
+        #   @param filters [OpenAI::Models::Beta::BetaWebSearchTool::Filters, nil]
+        #     Filters for the search.
         #
-        #   @param search_context_size [Symbol, OpenAI::Models::Beta::BetaWebSearchTool::SearchContextSize] High level guidance for the amount of context window space to use for the search
+        #   @param search_context_size [Symbol, OpenAI::Models::Beta::BetaWebSearchTool::SearchContextSize]
+        #     High level guidance for the amount of context window space to use for the
+        #     search. One of `low`, `medium`, or `high`. `medium` is the default.
         #
-        #   @param user_location [OpenAI::Models::Beta::BetaWebSearchTool::UserLocation, nil] The approximate location of the user.
+        #   @param user_location [OpenAI::Models::Beta::BetaWebSearchTool::UserLocation, nil]
+        #     The approximate location of the user.
 
         # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         #
@@ -79,12 +84,13 @@ module OpenAI
           optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
           # @!method initialize(allowed_domains: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaWebSearchTool::Filters} for more details.
-          #
           #   Filters for the search.
           #
-          #   @param allowed_domains [Array<String>, nil] Allowed domains for the search. If not provided, all domains are allowed.
+          #   @param allowed_domains [Array<String>, nil]
+          #     Allowed domains for the search. If not provided, all domains are allowed.
+          #     Subdomains of the provided domains are allowed as well.
+          #
+          #     Example: `["pubmed.ncbi.nlm.nih.gov"]`
         end
 
         # High level guidance for the amount of context window space to use for the
@@ -137,20 +143,24 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Beta::BetaWebSearchTool::UserLocation::Type }
 
           # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaWebSearchTool::UserLocation} for more details.
-          #
           #   The approximate location of the user.
           #
-          #   @param city [String, nil] Free text input for the city of the user, e.g. `San Francisco`.
+          #   @param city [String, nil]
+          #     Free text input for the city of the user, e.g. `San Francisco`.
           #
-          #   @param country [String, nil] The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of t
+          #   @param country [String, nil]
+          #     The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          #     the user, e.g. `US`.
           #
-          #   @param region [String, nil] Free text input for the region of the user, e.g. `California`.
+          #   @param region [String, nil]
+          #     Free text input for the region of the user, e.g. `California`.
           #
-          #   @param timezone [String, nil] The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user
+          #   @param timezone [String, nil]
+          #     The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          #     user, e.g. `America/Los_Angeles`.
           #
-          #   @param type [Symbol, OpenAI::Models::Beta::BetaWebSearchTool::UserLocation::Type] The type of location approximation. Always `approximate`.
+          #   @param type [Symbol, OpenAI::Models::Beta::BetaWebSearchTool::UserLocation::Type]
+          #     The type of location approximation. Always `approximate`.
 
           # The type of location approximation. Always `approximate`.
           #

data/lib/openai/models/beta/chatkit/chat_session.rb

@@ -68,25 +68,35 @@ module OpenAI
           # @!method initialize(id:, chatkit_configuration:, client_secret:, expires_at:, max_requests_per_1_minute:, rate_limits:, status:, user:, workflow:, object: :"chatkit.session")
           #   Represents a ChatKit session and its resolved configuration.
           #
-          #   @param id [String] Identifier for the ChatKit session.
+          #   @param id [String]
+          #     Identifier for the ChatKit session.
           #
-          #   @param chatkit_configuration [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfiguration] Resolved ChatKit feature configuration for the session.
+          #   @param chatkit_configuration [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfiguration]
+          #     Resolved ChatKit feature configuration for the session.
           #
-          #   @param client_secret [String] Ephemeral client secret that authenticates session requests.
+          #   @param client_secret [String]
+          #     Ephemeral client secret that authenticates session requests.
           #
-          #   @param expires_at [Integer] Unix timestamp (in seconds) for when the session expires.
+          #   @param expires_at [Integer]
+          #     Unix timestamp (in seconds) for when the session expires.
           #
-          #   @param max_requests_per_1_minute [Integer] Convenience copy of the per-minute request limit.
+          #   @param max_requests_per_1_minute [Integer]
+          #     Convenience copy of the per-minute request limit.
           #
-          #   @param rate_limits [OpenAI::Models::Beta::ChatKit::ChatSessionRateLimits] Resolved rate limit values.
+          #   @param rate_limits [OpenAI::Models::Beta::ChatKit::ChatSessionRateLimits]
+          #     Resolved rate limit values.
           #
-          #   @param status [Symbol, OpenAI::Models::Beta::ChatKit::ChatSessionStatus] Current lifecycle state of the session.
+          #   @param status [Symbol, OpenAI::Models::Beta::ChatKit::ChatSessionStatus]
+          #     Current lifecycle state of the session.
           #
-          #   @param user [String] User identifier associated with the session.
+          #   @param user [String]
+          #     User identifier associated with the session.
           #
-          #   @param workflow [OpenAI::Models::Beta::ChatKitWorkflow] Workflow metadata for the session.
+          #   @param workflow [OpenAI::Models::Beta::ChatKitWorkflow]
+          #     Workflow metadata for the session.
           #
-          #   @param object [Symbol, :"chatkit.session"] Type discriminator that is always `chatkit.session`.
+          #   @param object [Symbol, :"chatkit.session"]
+          #     Type discriminator that is always `chatkit.session`.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_automatic_thread_titling.rb

@@ -14,7 +14,8 @@ module OpenAI
           # @!method initialize(enabled:)
           #   Automatic thread title preferences for the session.
           #
-          #   @param enabled [Boolean] Whether automatic thread titling is enabled.
+          #   @param enabled [Boolean]
+          #     Whether automatic thread titling is enabled.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_chatkit_configuration.rb

@@ -26,11 +26,14 @@ module OpenAI
           # @!method initialize(automatic_thread_titling:, file_upload:, history:)
           #   ChatKit configuration for the session.
           #
-          #   @param automatic_thread_titling [OpenAI::Models::Beta::ChatKit::ChatSessionAutomaticThreadTitling] Automatic thread titling preferences.
+          #   @param automatic_thread_titling [OpenAI::Models::Beta::ChatKit::ChatSessionAutomaticThreadTitling]
+          #     Automatic thread titling preferences.
           #
-          #   @param file_upload [OpenAI::Models::Beta::ChatKit::ChatSessionFileUpload] Upload settings for the session.
+          #   @param file_upload [OpenAI::Models::Beta::ChatKit::ChatSessionFileUpload]
+          #     Upload settings for the session.
           #
-          #   @param history [OpenAI::Models::Beta::ChatKit::ChatSessionHistory] History retention configuration.
+          #   @param history [OpenAI::Models::Beta::ChatKit::ChatSessionHistory]
+          #     History retention configuration.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_chatkit_configuration_param.rb

@@ -30,17 +30,19 @@ module OpenAI
           optional :history, -> { OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History }
 
           # @!method initialize(automatic_thread_titling: nil, file_upload: nil, history: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam} for more
-          #   details.
-          #
           #   Optional per-session configuration settings for ChatKit behavior.
           #
-          #   @param automatic_thread_titling [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::AutomaticThreadTitling] Configuration for automatic thread titling. When omitted, automatic thread titli
+          #   @param automatic_thread_titling [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::AutomaticThreadTitling]
+          #     Configuration for automatic thread titling. When omitted, automatic thread
+          #     titling is enabled by default.
           #
-          #   @param file_upload [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::FileUpload] Configuration for upload enablement and limits. When omitted, uploads are disabl
+          #   @param file_upload [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::FileUpload]
+          #     Configuration for upload enablement and limits. When omitted, uploads are
+          #     disabled by default (max_files 10, max_file_size 512 MB).
           #
-          #   @param history [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History] Configuration for chat history retention. When omitted, history is enabled by de
+          #   @param history [OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History]
+          #     Configuration for chat history retention. When omitted, history is enabled by
+          #     default with no limit on recent_threads (null).
 
           # @see OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam#automatic_thread_titling
           class AutomaticThreadTitling < OpenAI::Internal::Type::BaseModel
@@ -54,7 +56,8 @@ module OpenAI
             #   Configuration for automatic thread titling. When omitted, automatic thread
             #   titling is enabled by default.
             #
-            #   @param enabled [Boolean] Enable automatic thread title generation. Defaults to true.
+            #   @param enabled [Boolean]
+            #     Enable automatic thread title generation. Defaults to true.
           end
 
           # @see OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam#file_upload
@@ -79,18 +82,18 @@ module OpenAI
             optional :max_files, Integer
 
             # @!method initialize(enabled: nil, max_file_size: nil, max_files: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::FileUpload}
-            #   for more details.
-            #
             #   Configuration for upload enablement and limits. When omitted, uploads are
             #   disabled by default (max_files 10, max_file_size 512 MB).
             #
-            #   @param enabled [Boolean] Enable uploads for this session. Defaults to false.
+            #   @param enabled [Boolean]
+            #     Enable uploads for this session. Defaults to false.
             #
-            #   @param max_file_size [Integer] Maximum size in megabytes for each uploaded file. Defaults to 512 MB, which is t
+            #   @param max_file_size [Integer]
+            #     Maximum size in megabytes for each uploaded file. Defaults to 512 MB, which is
+            #     the maximum allowable size.
             #
-            #   @param max_files [Integer] Maximum number of files that can be uploaded to the session. Defaults to 10.
+            #   @param max_files [Integer]
+            #     Maximum number of files that can be uploaded to the session. Defaults to 10.
           end
 
           # @see OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam#history
@@ -109,16 +112,15 @@ module OpenAI
             optional :recent_threads, Integer
 
             # @!method initialize(enabled: nil, recent_threads: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History}
-            #   for more details.
-            #
             #   Configuration for chat history retention. When omitted, history is enabled by
             #   default with no limit on recent_threads (null).
             #
-            #   @param enabled [Boolean] Enables chat users to access previous ChatKit threads. Defaults to true.
+            #   @param enabled [Boolean]
+            #     Enables chat users to access previous ChatKit threads. Defaults to true.
             #
-            #   @param recent_threads [Integer] Number of recent ChatKit threads users have access to. Defaults to unlimited whe
+            #   @param recent_threads [Integer]
+            #     Number of recent ChatKit threads users have access to. Defaults to unlimited
+            #     when unset.
           end
         end
       end

data/lib/openai/models/beta/chatkit/chat_session_expires_after_param.rb

@@ -20,9 +20,11 @@ module OpenAI
           # @!method initialize(seconds:, anchor: :created_at)
           #   Controls when the session expires relative to an anchor timestamp.
           #
-          #   @param seconds [Integer] Number of seconds after the anchor when the session expires.
+          #   @param seconds [Integer]
+          #     Number of seconds after the anchor when the session expires.
           #
-          #   @param anchor [Symbol, :created_at] Base timestamp used to calculate expiration. Currently fixed to `created_at`.
+          #   @param anchor [Symbol, :created_at]
+          #     Base timestamp used to calculate expiration. Currently fixed to `created_at`.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_file_upload.rb

@@ -26,11 +26,14 @@ module OpenAI
           # @!method initialize(enabled:, max_file_size:, max_files:)
           #   Upload permissions and limits applied to the session.
           #
-          #   @param enabled [Boolean] Indicates if uploads are enabled for the session.
+          #   @param enabled [Boolean]
+          #     Indicates if uploads are enabled for the session.
           #
-          #   @param max_file_size [Integer, nil] Maximum upload size in megabytes.
+          #   @param max_file_size [Integer, nil]
+          #     Maximum upload size in megabytes.
           #
-          #   @param max_files [Integer, nil] Maximum number of uploads allowed during the session.
+          #   @param max_files [Integer, nil]
+          #     Maximum number of uploads allowed during the session.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_history.rb

@@ -19,14 +19,14 @@ module OpenAI
           required :recent_threads, Integer, nil?: true
 
           # @!method initialize(enabled:, recent_threads:)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::ChatKit::ChatSessionHistory} for more details.
-          #
           #   History retention preferences returned for the session.
           #
-          #   @param enabled [Boolean] Indicates if chat history is persisted for the session.
+          #   @param enabled [Boolean]
+          #     Indicates if chat history is persisted for the session.
           #
-          #   @param recent_threads [Integer, nil] Number of prior threads surfaced in history views. Defaults to null when all his
+          #   @param recent_threads [Integer, nil]
+          #     Number of prior threads surfaced in history views. Defaults to null when all
+          #     history is retained.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_rate_limits.rb

@@ -14,7 +14,8 @@ module OpenAI
           # @!method initialize(max_requests_per_1_minute:)
           #   Active per-minute request limit for the session.
           #
-          #   @param max_requests_per_1_minute [Integer] Maximum allowed requests per one-minute window.
+          #   @param max_requests_per_1_minute [Integer]
+          #     Maximum allowed requests per one-minute window.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_rate_limits_param.rb

@@ -14,7 +14,8 @@ module OpenAI
           # @!method initialize(max_requests_per_1_minute: nil)
           #   Controls request rate limits for the session.
           #
-          #   @param max_requests_per_1_minute [Integer] Maximum number of requests allowed per minute for the session. Defaults to 10.
+          #   @param max_requests_per_1_minute [Integer]
+          #     Maximum number of requests allowed per minute for the session. Defaults to 10.
         end
       end
     end

data/lib/openai/models/beta/chatkit/chat_session_workflow_param.rb

@@ -37,19 +37,21 @@ module OpenAI
           optional :version, String
 
           # @!method initialize(id:, state_variables: nil, tracing: nil, version: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::ChatKit::ChatSessionWorkflowParam} for more details.
-          #
           #   Workflow reference and overrides applied to the chat session.
           #
-          #   @param id [String] Identifier for the workflow invoked by the session.
+          #   @param id [String]
+          #     Identifier for the workflow invoked by the session.
           #
-          #   @param state_variables [Hash{Symbol=>String, Boolean, Float}] State variables forwarded to the workflow. Keys may be up to 64 characters, valu
+          #   @param state_variables [Hash{Symbol=>String, Boolean, Float}]
+          #     State variables forwarded to the workflow. Keys may be up to 64 characters,
+          #     values must be primitive types, and the map defaults to an empty object.
           #
-          #   @param tracing [OpenAI::Models::Beta::ChatKit::ChatSessionWorkflowParam::Tracing] Optional tracing overrides for the workflow invocation. When omitted, tracing is
+          #   @param tracing [OpenAI::Models::Beta::ChatKit::ChatSessionWorkflowParam::Tracing]
+          #     Optional tracing overrides for the workflow invocation. When omitted, tracing is
+          #     enabled by default.
           #
-          #   @param version [String] Specific workflow version to run. Defaults to the latest deployed version.
-
+          #   @param version [String]
+          #     Specific workflow version to run. Defaults to the latest deployed version.
           module StateVariable
             extend OpenAI::Internal::Type::Union
 
@@ -75,7 +77,8 @@ module OpenAI
             #   Optional tracing overrides for the workflow invocation. When omitted, tracing is
             #   enabled by default.
             #
-            #   @param enabled [Boolean] Whether tracing is enabled during the session. Defaults to true.
+            #   @param enabled [Boolean]
+            #     Whether tracing is enabled during the session. Defaults to true.
           end
         end
       end

data/lib/openai/models/beta/chatkit/chatkit_attachment.rb

@@ -38,15 +38,20 @@ module OpenAI
           # @!method initialize(id:, mime_type:, name:, preview_url:, type:)
           #   Attachment metadata included on thread items.
           #
-          #   @param id [String] Identifier for the attachment.
+          #   @param id [String]
+          #     Identifier for the attachment.
           #
-          #   @param mime_type [String] MIME type of the attachment.
+          #   @param mime_type [String]
+          #     MIME type of the attachment.
           #
-          #   @param name [String] Original display name for the attachment.
+          #   @param name [String]
+          #     Original display name for the attachment.
           #
-          #   @param preview_url [String, nil] Preview URL for rendering the attachment inline.
+          #   @param preview_url [String, nil]
+          #     Preview URL for rendering the attachment inline.
           #
-          #   @param type [Symbol, OpenAI::Models::Beta::ChatKit::ChatKitAttachment::Type] Attachment discriminator.
+          #   @param type [Symbol, OpenAI::Models::Beta::ChatKit::ChatKitAttachment::Type]
+          #     Attachment discriminator.
 
           # Attachment discriminator.
           #