openai 0.92.0 → 0.94.0

data/sig/openai/models/beta/beta_tool_choice_apply_patch.rbs

@@ -6,8 +6,11 @@ module OpenAI
       type beta_tool_choice_apply_patch = { ?type: :apply_patch }
 
       class BetaToolChoiceApplyPatch < OpenAI::Internal::Type::BaseModel
+        # The tool to call. Always `apply_patch`.
         attr_accessor type: :apply_patch
 
+        # @param type
+        #   The tool to call. Always `apply_patch`.
         def initialize: (?type: :apply_patch) -> void
 
         def to_hash: -> { ?type: :apply_patch }

data/sig/openai/models/beta/beta_tool_choice_custom.rbs

@@ -6,10 +6,16 @@ module OpenAI
       type beta_tool_choice_custom = { name: String, ?type: :custom }
 
       class BetaToolChoiceCustom < OpenAI::Internal::Type::BaseModel
+        # The name of the custom tool to call.
         attr_accessor name: String
 
+        # For custom tool calling, the type is always `custom`.
         attr_accessor type: :custom
 
+        # @param name
+        #   The name of the custom tool to call.
+        # @param type
+        #   For custom tool calling, the type is always `custom`.
         def initialize: (name: String, ?type: :custom) -> void
 
         def to_hash: -> { name: String, ?type: :custom }

data/sig/openai/models/beta/beta_tool_choice_function.rbs

@@ -6,10 +6,16 @@ module OpenAI
       type beta_tool_choice_function = { name: String, ?type: :function }
 
       class BetaToolChoiceFunction < OpenAI::Internal::Type::BaseModel
+        # The name of the function to call.
         attr_accessor name: String
 
+        # For function calling, the type is always `function`.
         attr_accessor type: :function
 
+        # @param name
+        #   The name of the function to call.
+        # @param type
+        #   For function calling, the type is always `function`.
         def initialize: (name: String, ?type: :function) -> void
 
         def to_hash: -> { name: String, ?type: :function }

data/sig/openai/models/beta/beta_tool_choice_mcp.rbs

@@ -7,12 +7,21 @@ module OpenAI
         { server_label: String, ?type: :mcp, ?name: String? }
 
       class BetaToolChoiceMcp < OpenAI::Internal::Type::BaseModel
+        # The label of the MCP server to use.
         attr_accessor server_label: String
 
+        # For MCP tools, the type is always `mcp`.
         attr_accessor type: :mcp
 
+        # The name of the tool to call on the server.
         attr_accessor name: String?
 
+        # @param server_label
+        #   The label of the MCP server to use.
+        # @param name
+        #   The name of the tool to call on the server.
+        # @param type
+        #   For MCP tools, the type is always `mcp`.
         def initialize: (
           server_label: String,
           ?name: String?,

data/sig/openai/models/beta/beta_tool_choice_shell.rbs

@@ -6,8 +6,11 @@ module OpenAI
       type beta_tool_choice_shell = { ?type: :shell }
 
       class BetaToolChoiceShell < OpenAI::Internal::Type::BaseModel
+        # The tool to call. Always `shell`.
         attr_accessor type: :shell
 
+        # @param type
+        #   The tool to call. Always `shell`.
         def initialize: (?type: :shell) -> void
 
         def to_hash: -> { ?type: :shell }

data/sig/openai/models/beta/beta_tool_choice_types.rbs

@@ -7,8 +7,33 @@ module OpenAI
         { type: OpenAI::Models::Beta::BetaToolChoiceTypes::type_ }
 
       class BetaToolChoiceTypes < OpenAI::Internal::Type::BaseModel
+        # 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:
+        #
+        # - `file_search`
+        # - `web_search_preview`
+        # - `computer`
+        # - `computer_use_preview`
+        # - `computer_use`
+        # - `code_interpreter`
+        # - `image_generation`
         attr_accessor type: OpenAI::Models::Beta::BetaToolChoiceTypes::type_
 
+        # @param 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:
+        #
+        #   - `file_search`
+        #   - `web_search_preview`
+        #   - `computer`
+        #   - `computer_use_preview`
+        #   - `computer_use`
+        #   - `code_interpreter`
+        #   - `image_generation`
         def initialize: (
           type: OpenAI::Models::Beta::BetaToolChoiceTypes::type_
         ) -> void

data/sig/openai/models/beta/beta_tool_search_tool.rbs

@@ -12,18 +12,31 @@ module OpenAI
         }
 
       class BetaToolSearchTool < OpenAI::Internal::Type::BaseModel
+        # The type of the tool. Always `tool_search`.
         attr_accessor type: :tool_search
 
+        # Description shown to the model for a client-executed tool search tool.
         attr_accessor description: String?
 
+        # Whether tool search is executed by the server or by the client.
         attr_reader execution: OpenAI::Models::Beta::BetaToolSearchTool::execution?
 
+        # Whether tool search is executed by the server or by the client.
         def execution=: (
           OpenAI::Models::Beta::BetaToolSearchTool::execution
         ) -> OpenAI::Models::Beta::BetaToolSearchTool::execution
 
+        # Parameter schema for a client-executed tool search tool.
         attr_accessor parameters: top?
 
+        # @param description
+        #   Description shown to the model for a client-executed tool search tool.
+        # @param execution
+        #   Whether tool search is executed by the server or by the client.
+        # @param parameters
+        #   Parameter schema for a client-executed tool search tool.
+        # @param type
+        #   The type of the tool. Always `tool_search`.
         def initialize: (
           ?description: String?,
           ?execution: OpenAI::Models::Beta::BetaToolSearchTool::execution,

data/sig/openai/models/beta/beta_web_search_preview_tool.rbs

@@ -12,6 +12,8 @@ module OpenAI
         }
 
       class BetaWebSearchPreviewTool < OpenAI::Internal::Type::BaseModel
+        # The type of the web search tool. One of `web_search_preview` or
+        # `web_search_preview_2025_03_11`.
         attr_accessor type: OpenAI::Models::Beta::BetaWebSearchPreviewTool::type_
 
         attr_reader search_content_types: ::Array[OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_content_type]?
@@ -20,14 +22,27 @@ module OpenAI
           ::Array[OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_content_type]
         ) -> ::Array[OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_content_type]
 
+        # 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.
         attr_reader search_context_size: OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_context_size?
 
+        # 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.
         def search_context_size=: (
           OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_context_size
         ) -> OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_context_size
 
+        # The user's location.
         attr_accessor user_location: OpenAI::Beta::BetaWebSearchPreviewTool::UserLocation?
 
+        # @param type
+        #   The type of the web search tool. One of `web_search_preview` or
+        #   `web_search_preview_2025_03_11`.
+        # @param search_context_size
+        #   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
+        #   The user's location.
         def initialize: (
           type: OpenAI::Models::Beta::BetaWebSearchPreviewTool::type_,
           ?search_content_types: ::Array[OpenAI::Models::Beta::BetaWebSearchPreviewTool::search_content_type],
@@ -86,16 +101,35 @@ module OpenAI
           }
 
         class UserLocation < OpenAI::Internal::Type::BaseModel
+          # The type of location approximation. Always `approximate`.
           attr_accessor type: :approximate
 
+          # Free text input for the city of the user, e.g. `San Francisco`.
           attr_accessor city: String?
 
+          # The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          # the user, e.g. `US`.
           attr_accessor country: String?
 
+          # Free text input for the region of the user, e.g. `California`.
           attr_accessor region: String?
 
+          # The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          # user, e.g. `America/Los_Angeles`.
           attr_accessor timezone: String?
 
+          # @param city
+          #   Free text input for the city of the user, e.g. `San Francisco`.
+          # @param country
+          #   The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          #   the user, e.g. `US`.
+          # @param region
+          #   Free text input for the region of the user, e.g. `California`.
+          # @param timezone
+          #   The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          #   user, e.g. `America/Los_Angeles`.
+          # @param type
+          #   The type of location approximation. Always `approximate`.
           def initialize: (
             ?city: String?,
             ?country: String?,

data/sig/openai/models/beta/beta_web_search_tool.rbs

@@ -13,22 +13,48 @@ module OpenAI
         }
 
       class BetaWebSearchTool < OpenAI::Internal::Type::BaseModel
+        # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         attr_accessor type: OpenAI::Models::Beta::BetaWebSearchTool::type_
 
+        # 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.
         attr_reader external_web_access: bool?
 
+        # 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.
         def external_web_access=: (bool) -> bool
 
+        # Filters for the search.
         attr_accessor filters: OpenAI::Beta::BetaWebSearchTool::Filters?
 
+        # 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.
         attr_reader search_context_size: OpenAI::Models::Beta::BetaWebSearchTool::search_context_size?
 
+        # 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.
         def search_context_size=: (
           OpenAI::Models::Beta::BetaWebSearchTool::search_context_size
         ) -> OpenAI::Models::Beta::BetaWebSearchTool::search_context_size
 
+        # The approximate location of the user.
         attr_accessor user_location: OpenAI::Beta::BetaWebSearchTool::UserLocation?
 
+        # @param type
+        #   The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+        # @param external_web_access
+        #   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
+        #   Filters for the search.
+        # @param search_context_size
+        #   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
+        #   The approximate location of the user.
         def initialize: (
           type: OpenAI::Models::Beta::BetaWebSearchTool::type_,
           ?external_web_access: bool,
@@ -59,8 +85,17 @@ module OpenAI
         type filters = { ?allowed_domains: ::Array[String]? }
 
         class Filters < OpenAI::Internal::Type::BaseModel
+          # 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"]`
           attr_accessor allowed_domains: ::Array[String]?
 
+          # @param allowed_domains
+          #   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"]`
           def initialize: (?allowed_domains: ::Array[String]?) -> void
 
           def to_hash: -> { ?allowed_domains: ::Array[String]? }
@@ -88,20 +123,40 @@ module OpenAI
           }
 
         class UserLocation < OpenAI::Internal::Type::BaseModel
+          # Free text input for the city of the user, e.g. `San Francisco`.
           attr_accessor city: String?
 
+          # The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          # the user, e.g. `US`.
           attr_accessor country: String?
 
+          # Free text input for the region of the user, e.g. `California`.
           attr_accessor region: String?
 
+          # The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          # user, e.g. `America/Los_Angeles`.
           attr_accessor timezone: String?
 
+          # The type of location approximation. Always `approximate`.
           attr_reader type: OpenAI::Models::Beta::BetaWebSearchTool::UserLocation::type_?
 
+          # The type of location approximation. Always `approximate`.
           def type=: (
             OpenAI::Models::Beta::BetaWebSearchTool::UserLocation::type_
           ) -> OpenAI::Models::Beta::BetaWebSearchTool::UserLocation::type_
 
+          # @param city
+          #   Free text input for the city of the user, e.g. `San Francisco`.
+          # @param country
+          #   The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          #   the user, e.g. `US`.
+          # @param region
+          #   Free text input for the region of the user, e.g. `California`.
+          # @param timezone
+          #   The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          #   user, e.g. `America/Los_Angeles`.
+          # @param type
+          #   The type of location approximation. Always `approximate`.
           def initialize: (
             ?city: String?,
             ?country: String?,

data/sig/openai/models/beta/chatkit/chat_session.rbs

@@ -17,26 +17,56 @@ module OpenAI
           }
 
         class ChatSession < OpenAI::Internal::Type::BaseModel
+          # Identifier for the ChatKit session.
           attr_accessor id: String
 
+          # Resolved ChatKit feature configuration for the session.
           attr_accessor chatkit_configuration: OpenAI::Beta::ChatKit::ChatSessionChatKitConfiguration
 
+          # Ephemeral client secret that authenticates session requests.
           attr_accessor client_secret: String
 
+          # Unix timestamp (in seconds) for when the session expires.
           attr_accessor expires_at: Integer
 
+          # Convenience copy of the per-minute request limit.
           attr_accessor max_requests_per_1_minute: Integer
 
+          # Type discriminator that is always `chatkit.session`.
           attr_accessor object: :"chatkit.session"
 
+          # Resolved rate limit values.
           attr_accessor rate_limits: OpenAI::Beta::ChatKit::ChatSessionRateLimits
 
+          # Current lifecycle state of the session.
           attr_accessor status: OpenAI::Models::Beta::ChatKit::chat_session_status
 
+          # User identifier associated with the session.
           attr_accessor user: String
 
+          # Workflow metadata for the session.
           attr_accessor workflow: OpenAI::Beta::ChatKitWorkflow
 
+          # @param id
+          #   Identifier for the ChatKit session.
+          # @param chatkit_configuration
+          #   Resolved ChatKit feature configuration for the session.
+          # @param client_secret
+          #   Ephemeral client secret that authenticates session requests.
+          # @param expires_at
+          #   Unix timestamp (in seconds) for when the session expires.
+          # @param max_requests_per_1_minute
+          #   Convenience copy of the per-minute request limit.
+          # @param rate_limits
+          #   Resolved rate limit values.
+          # @param status
+          #   Current lifecycle state of the session.
+          # @param user
+          #   User identifier associated with the session.
+          # @param workflow
+          #   Workflow metadata for the session.
+          # @param object
+          #   Type discriminator that is always `chatkit.session`.
           def initialize: (
             id: String,
             chatkit_configuration: OpenAI::Beta::ChatKit::ChatSessionChatKitConfiguration,

data/sig/openai/models/beta/chatkit/chat_session_automatic_thread_titling.rbs

@@ -5,8 +5,11 @@ module OpenAI
         type chat_session_automatic_thread_titling = { enabled: bool }
 
         class ChatSessionAutomaticThreadTitling < OpenAI::Internal::Type::BaseModel
+          # Whether automatic thread titling is enabled.
           attr_accessor enabled: bool
 
+          # @param enabled
+          #   Whether automatic thread titling is enabled.
           def initialize: (enabled: bool) -> void
 
           def to_hash: -> { enabled: bool }

data/sig/openai/models/beta/chatkit/chat_session_chatkit_configuration.rbs

@@ -10,12 +10,21 @@ module OpenAI
           }
 
         class ChatSessionChatKitConfiguration < OpenAI::Internal::Type::BaseModel
+          # Automatic thread titling preferences.
           attr_accessor automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionAutomaticThreadTitling
 
+          # Upload settings for the session.
           attr_accessor file_upload: OpenAI::Beta::ChatKit::ChatSessionFileUpload
 
+          # History retention configuration.
           attr_accessor history: OpenAI::Beta::ChatKit::ChatSessionHistory
 
+          # @param automatic_thread_titling
+          #   Automatic thread titling preferences.
+          # @param file_upload
+          #   Upload settings for the session.
+          # @param history
+          #   History retention configuration.
           def initialize: (
             automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionAutomaticThreadTitling,
             file_upload: OpenAI::Beta::ChatKit::ChatSessionFileUpload,

data/sig/openai/models/beta/chatkit/chat_session_chatkit_configuration_param.rbs

@@ -10,24 +10,45 @@ module OpenAI
           }
 
         class ChatSessionChatKitConfigurationParam < OpenAI::Internal::Type::BaseModel
+          # Configuration for automatic thread titling. When omitted, automatic thread
+          # titling is enabled by default.
           attr_reader automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::AutomaticThreadTitling?
 
+          # Configuration for automatic thread titling. When omitted, automatic thread
+          # titling is enabled by default.
           def automatic_thread_titling=: (
             OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::AutomaticThreadTitling
           ) -> OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::AutomaticThreadTitling
 
+          # Configuration for upload enablement and limits. When omitted, uploads are
+          # disabled by default (max_files 10, max_file_size 512 MB).
           attr_reader file_upload: OpenAI::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).
           def file_upload=: (
             OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::FileUpload
           ) -> OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::FileUpload
 
+          # Configuration for chat history retention. When omitted, history is enabled by
+          # default with no limit on recent_threads (null).
           attr_reader history: OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History?
 
+          # Configuration for chat history retention. When omitted, history is enabled by
+          # default with no limit on recent_threads (null).
           def history=: (
             OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History
           ) -> OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::History
 
+          # @param automatic_thread_titling
+          #   Configuration for automatic thread titling. When omitted, automatic thread
+          #   titling is enabled by default.
+          # @param file_upload
+          #   Configuration for upload enablement and limits. When omitted, uploads are
+          #   disabled by default (max_files 10, max_file_size 512 MB).
+          # @param history
+          #   Configuration for chat history retention. When omitted, history is enabled by
+          #   default with no limit on recent_threads (null).
           def initialize: (
             ?automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::AutomaticThreadTitling,
             ?file_upload: OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::FileUpload,
@@ -43,10 +64,14 @@ module OpenAI
           type automatic_thread_titling = { ?enabled: bool }
 
           class AutomaticThreadTitling < OpenAI::Internal::Type::BaseModel
+            # Enable automatic thread title generation. Defaults to true.
             attr_reader enabled: bool?
 
+            # Enable automatic thread title generation. Defaults to true.
             def enabled=: (bool) -> bool
 
+            # @param enabled
+            #   Enable automatic thread title generation. Defaults to true.
             def initialize: (?enabled: bool) -> void
 
             def to_hash: -> { ?enabled: bool }
@@ -56,18 +81,33 @@ module OpenAI
             { ?enabled: bool, ?max_file_size: Integer, ?max_files: Integer }
 
           class FileUpload < OpenAI::Internal::Type::BaseModel
+            # Enable uploads for this session. Defaults to false.
             attr_reader enabled: bool?
 
+            # Enable uploads for this session. Defaults to false.
             def enabled=: (bool) -> bool
 
+            # Maximum size in megabytes for each uploaded file. Defaults to 512 MB, which is
+            # the maximum allowable size.
             attr_reader max_file_size: Integer?
 
+            # Maximum size in megabytes for each uploaded file. Defaults to 512 MB, which is
+            # the maximum allowable size.
             def max_file_size=: (Integer) -> Integer
 
+            # Maximum number of files that can be uploaded to the session. Defaults to 10.
             attr_reader max_files: Integer?
 
+            # Maximum number of files that can be uploaded to the session. Defaults to 10.
             def max_files=: (Integer) -> Integer
 
+            # @param enabled
+            #   Enable uploads for this session. Defaults to false.
+            # @param max_file_size
+            #   Maximum size in megabytes for each uploaded file. Defaults to 512 MB, which is
+            #   the maximum allowable size.
+            # @param max_files
+            #   Maximum number of files that can be uploaded to the session. Defaults to 10.
             def initialize: (
               ?enabled: bool,
               ?max_file_size: Integer,
@@ -84,14 +124,25 @@ module OpenAI
           type history = { ?enabled: bool, ?recent_threads: Integer }
 
           class History < OpenAI::Internal::Type::BaseModel
+            # Enables chat users to access previous ChatKit threads. Defaults to true.
             attr_reader enabled: bool?
 
+            # Enables chat users to access previous ChatKit threads. Defaults to true.
             def enabled=: (bool) -> bool
 
+            # Number of recent ChatKit threads users have access to. Defaults to unlimited
+            # when unset.
             attr_reader recent_threads: Integer?
 
+            # Number of recent ChatKit threads users have access to. Defaults to unlimited
+            # when unset.
             def recent_threads=: (Integer) -> Integer
 
+            # @param enabled
+            #   Enables chat users to access previous ChatKit threads. Defaults to true.
+            # @param recent_threads
+            #   Number of recent ChatKit threads users have access to. Defaults to unlimited
+            #   when unset.
             def initialize: (?enabled: bool, ?recent_threads: Integer) -> void
 
             def to_hash: -> { ?enabled: bool, ?recent_threads: Integer }

data/sig/openai/models/beta/chatkit/chat_session_expires_after_param.rbs

@@ -6,10 +6,16 @@ module OpenAI
           { ?anchor: :created_at, seconds: Integer }
 
         class ChatSessionExpiresAfterParam < OpenAI::Internal::Type::BaseModel
+          # Base timestamp used to calculate expiration. Currently fixed to `created_at`.
           attr_accessor anchor: :created_at
 
+          # Number of seconds after the anchor when the session expires.
           attr_accessor seconds: Integer
 
+          # @param seconds
+          #   Number of seconds after the anchor when the session expires.
+          # @param anchor
+          #   Base timestamp used to calculate expiration. Currently fixed to `created_at`.
           def initialize: (seconds: Integer, ?anchor: :created_at) -> void
 
           def to_hash: -> { ?anchor: :created_at, seconds: Integer }

data/sig/openai/models/beta/chatkit/chat_session_file_upload.rbs

@@ -6,12 +6,21 @@ module OpenAI
           { enabled: bool, max_file_size: Integer?, max_files: Integer? }
 
         class ChatSessionFileUpload < OpenAI::Internal::Type::BaseModel
+          # Indicates if uploads are enabled for the session.
           attr_accessor enabled: bool
 
+          # Maximum upload size in megabytes.
           attr_accessor max_file_size: Integer?
 
+          # Maximum number of uploads allowed during the session.
           attr_accessor max_files: Integer?
 
+          # @param enabled
+          #   Indicates if uploads are enabled for the session.
+          # @param max_file_size
+          #   Maximum upload size in megabytes.
+          # @param max_files
+          #   Maximum number of uploads allowed during the session.
           def initialize: (
             enabled: bool,
             max_file_size: Integer?,

data/sig/openai/models/beta/chatkit/chat_session_history.rbs

@@ -5,10 +5,18 @@ module OpenAI
         type chat_session_history = { enabled: bool, recent_threads: Integer? }
 
         class ChatSessionHistory < OpenAI::Internal::Type::BaseModel
+          # Indicates if chat history is persisted for the session.
           attr_accessor enabled: bool
 
+          # Number of prior threads surfaced in history views. Defaults to null when all
+          # history is retained.
           attr_accessor recent_threads: Integer?
 
+          # @param enabled
+          #   Indicates if chat history is persisted for the session.
+          # @param recent_threads
+          #   Number of prior threads surfaced in history views. Defaults to null when all
+          #   history is retained.
           def initialize: (enabled: bool, recent_threads: Integer?) -> void
 
           def to_hash: -> { enabled: bool, recent_threads: Integer? }

data/sig/openai/models/beta/chatkit/chat_session_rate_limits.rbs

@@ -6,8 +6,11 @@ module OpenAI
           { :max_requests_per_1_minute => Integer }
 
         class ChatSessionRateLimits < OpenAI::Internal::Type::BaseModel
+          # Maximum allowed requests per one-minute window.
           attr_accessor max_requests_per_1_minute: Integer
 
+          # @param max_requests_per_1_minute
+          #   Maximum allowed requests per one-minute window.
           def initialize: (max_requests_per_1_minute: Integer) -> void
 
           def to_hash: -> { :max_requests_per_1_minute => Integer }

data/sig/openai/models/beta/chatkit/chat_session_rate_limits_param.rbs

@@ -6,10 +6,14 @@ module OpenAI
           { ?:max_requests_per_1_minute => Integer }
 
         class ChatSessionRateLimitsParam < OpenAI::Internal::Type::BaseModel
+          # Maximum number of requests allowed per minute for the session. Defaults to 10.
           attr_reader max_requests_per_1_minute: Integer?
 
+          # Maximum number of requests allowed per minute for the session. Defaults to 10.
           def max_requests_per_1_minute=: (Integer) -> Integer
 
+          # @param max_requests_per_1_minute
+          #   Maximum number of requests allowed per minute for the session. Defaults to 10.
           def initialize: (?max_requests_per_1_minute: Integer) -> void
 
           def to_hash: -> { ?:max_requests_per_1_minute => Integer }