openai 0.87.0 → 0.89.0

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

@@ -23,11 +23,14 @@ module OpenAI
         required :value, String
 
         # @!method initialize(domain:, name:, value:)
-        #   @param domain [String] The domain associated with the secret.
+        #   @param domain [String]
+        #     The domain associated with the secret.
         #
-        #   @param name [String] The name of the secret to inject for the domain.
+        #   @param name [String]
+        #     The name of the secret to inject for the domain.
         #
-        #   @param value [String] The secret value to inject for the domain.
+        #   @param value [String]
+        #     The secret value to inject for the domain.
       end
     end
 

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

@@ -17,9 +17,11 @@ module OpenAI
         required :type, const: :container_reference
 
         # @!method initialize(container_id:, type: :container_reference)
-        #   @param container_id [String] The ID of the referenced container.
+        #   @param container_id [String]
+        #     The ID of the referenced container.
         #
-        #   @param type [Symbol, :container_reference] References a container created with the /v1/containers endpoint
+        #   @param type [Symbol, :container_reference]
+        #     References a container created with the /v1/containers endpoint
       end
     end
 

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

@@ -52,26 +52,30 @@ module OpenAI
         optional :format_, union: -> { OpenAI::Beta::BetaCustomTool::Format }, api_name: :format
 
         # @!method initialize(name:, allowed_callers: nil, async: nil, defer_loading: nil, description: nil, format_: nil, type: :custom)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaCustomTool} for more details.
-        #
         #   A custom tool that processes input using a specified format. Learn more about
-        #   [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+        #   [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
         #
-        #   @param name [String] The name of the custom tool, used to identify it in tool calls.
+        #   @param name [String]
+        #     The name of the custom tool, used to identify it in tool calls.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaCustomTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaCustomTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
-        #   @param async [Boolean] Whether the tool response can be returned asynchronously versus immediately retu
+        #   @param async [Boolean]
+        #     Whether the tool response can be returned asynchronously versus immediately
+        #     returned on next response creation.
         #
-        #   @param defer_loading [Boolean] Whether this tool should be deferred and discovered via tool search.
+        #   @param defer_loading [Boolean]
+        #     Whether this tool should be deferred and discovered via tool search.
         #
-        #   @param description [String] Optional description of the custom tool, used to provide more context.
+        #   @param description [String]
+        #     Optional description of the custom tool, used to provide more context.
         #
-        #   @param format_ [OpenAI::Models::Beta::BetaCustomTool::Format::Text, OpenAI::Models::Beta::BetaCustomTool::Format::Grammar] The input format for the custom tool. Default is unconstrained text.
+        #   @param format_ [OpenAI::Models::Beta::BetaCustomTool::Format::Text, OpenAI::Models::Beta::BetaCustomTool::Format::Grammar]
+        #     The input format for the custom tool. Default is unconstrained text.
         #
-        #   @param type [Symbol, :custom] The type of the custom tool. Always `custom`.
-
+        #   @param type [Symbol, :custom]
+        #     The type of the custom tool. Always `custom`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 
@@ -106,7 +110,8 @@ module OpenAI
             # @!method initialize(type: :text)
             #   Unconstrained free-form text.
             #
-            #   @param type [Symbol, :text] Unconstrained text format. Always `text`.
+            #   @param type [Symbol, :text]
+            #     Unconstrained text format. Always `text`.
           end
 
           class Grammar < OpenAI::Internal::Type::BaseModel
@@ -131,11 +136,14 @@ module OpenAI
             # @!method initialize(definition:, syntax:, type: :grammar)
             #   A grammar defined by the user.
             #
-            #   @param definition [String] The grammar definition.
+            #   @param definition [String]
+            #     The grammar definition.
             #
-            #   @param syntax [Symbol, OpenAI::Models::Beta::BetaCustomTool::Format::Grammar::Syntax] The syntax of the grammar definition. One of `lark` or `regex`.
+            #   @param syntax [Symbol, OpenAI::Models::Beta::BetaCustomTool::Format::Grammar::Syntax]
+            #     The syntax of the grammar definition. One of `lark` or `regex`.
             #
-            #   @param type [Symbol, :grammar] Grammar format. Always `grammar`.
+            #   @param type [Symbol, :grammar]
+            #     Grammar format. Always `grammar`.
 
             # The syntax of the grammar definition. One of `lark` or `regex`.
             #

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

@@ -34,22 +34,28 @@ module OpenAI
         optional :type, enum: -> { OpenAI::Beta::BetaEasyInputMessage::Type }
 
         # @!method initialize(content:, role:, phase: nil, type: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaEasyInputMessage} for more details.
-        #
         #   A message input to the model with a role indicating instruction following
         #   hierarchy. Instructions given with the `developer` or `system` role take
         #   precedence over instructions given with the `user` role. Messages with the
         #   `assistant` role are presumed to have been generated by the model in previous
         #   interactions.
         #
-        #   @param content [String, Array<OpenAI::Models::Beta::BetaResponseInputText, OpenAI::Models::Beta::BetaResponseInputImage, OpenAI::Models::Beta::BetaResponseInputFile>] Text, image, or audio input to the model, used to generate a response.
+        #   @param content [String, Array<OpenAI::Models::Beta::BetaResponseInputText, OpenAI::Models::Beta::BetaResponseInputImage, OpenAI::Models::Beta::BetaResponseInputFile>]
+        #     Text, image, or audio input to the model, used to generate a response. Can also
+        #     contain previous assistant responses.
         #
-        #   @param role [Symbol, OpenAI::Models::Beta::BetaEasyInputMessage::Role] The role of the message input. One of `user`, `assistant`, `system`, or
+        #   @param role [Symbol, OpenAI::Models::Beta::BetaEasyInputMessage::Role]
+        #     The role of the message input. One of `user`, `assistant`, `system`, or
+        #     `developer`.
         #
-        #   @param phase [Symbol, OpenAI::Models::Beta::BetaEasyInputMessage::Phase, nil] Labels an `assistant` message as intermediate commentary (`commentary`) or the f
+        #   @param phase [Symbol, OpenAI::Models::Beta::BetaEasyInputMessage::Phase, nil]
+        #     Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        #     final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        #     sending follow-up requests, preserve and resend phase on all assistant messages
+        #     — dropping it can degrade performance. Not used for user messages.
         #
-        #   @param type [Symbol, OpenAI::Models::Beta::BetaEasyInputMessage::Type] The type of the message input. Always `message`.
+        #   @param type [Symbol, OpenAI::Models::Beta::BetaEasyInputMessage::Type]
+        #     The type of the message input. Always `message`.
 
         # Text, image, or audio input to the model, used to generate a response. Can also
         # contain previous assistant responses.

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

@@ -36,22 +36,25 @@ module OpenAI
         optional :ranking_options, -> { OpenAI::Beta::BetaFileSearchTool::RankingOptions }
 
         # @!method initialize(vector_store_ids:, filters: nil, max_num_results: nil, ranking_options: nil, type: :file_search)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaFileSearchTool} for more details.
-        #
         #   A tool that searches for relevant content from uploaded files. Learn more about
         #   the
-        #   [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+        #   [file search tool](https://developers.openai.com/api/docs/guides/tools-file-search).
         #
-        #   @param vector_store_ids [Array<String>] The IDs of the vector stores to search.
+        #   @param vector_store_ids [Array<String>]
+        #     The IDs of the vector stores to search.
         #
-        #   @param filters [OpenAI::Models::Beta::BetaFileSearchTool::Filters::ComparisonFilter, OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter, nil] A filter to apply.
+        #   @param filters [OpenAI::Models::Beta::BetaFileSearchTool::Filters::ComparisonFilter, OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter, nil]
+        #     A filter to apply.
         #
-        #   @param max_num_results [Integer] The maximum number of results to return. This number should be between 1 and 50
+        #   @param max_num_results [Integer]
+        #     The maximum number of results to return. This number should be between 1 and 50
+        #     inclusive.
         #
-        #   @param ranking_options [OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions] Ranking options for search.
+        #   @param ranking_options [OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions]
+        #     Ranking options for search.
         #
-        #   @param type [Symbol, :file_search] The type of the file search tool. Always `file_search`.
+        #   @param type [Symbol, :file_search]
+        #     The type of the file search tool. Always `file_search`.
 
         # A filter to apply.
         #
@@ -96,18 +99,28 @@ module OpenAI
             required :value, union: -> { OpenAI::Beta::BetaFileSearchTool::Filters::ComparisonFilter::Value }
 
             # @!method initialize(key:, type:, value:)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaFileSearchTool::Filters::ComparisonFilter} for more
-            #   details.
-            #
             #   A filter used to compare a specified attribute key to a given value using a
             #   defined comparison operation.
             #
-            #   @param key [String] The key to compare against the value.
+            #   @param key [String]
+            #     The key to compare against the value.
             #
-            #   @param type [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::Filters::ComparisonFilter::Type] Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `
+            #   @param type [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::Filters::ComparisonFilter::Type]
+            #     Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
+            #     `nin`.
             #
-            #   @param value [String, Float, Boolean, Array<String, Float>] The value to compare against the attribute key; supports string, number, or bool
+            #     - `eq`: equals
+            #     - `ne`: not equal
+            #     - `gt`: greater than
+            #     - `gte`: greater than or equal
+            #     - `lt`: less than
+            #     - `lte`: less than or equal
+            #     - `in`: in
+            #     - `nin`: not in
+            #
+            #   @param value [String, Float, Boolean, Array<String, Float>]
+            #     The value to compare against the attribute key; supports string, number, or
+            #     boolean types.
 
             # Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
             # `nin`.
@@ -200,15 +213,14 @@ module OpenAI
             required :type, enum: -> { OpenAI::Beta::BetaFileSearchTool::Filters::CompoundFilter::Type }
 
             # @!method initialize(filters:, type:)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter} for more
-            #   details.
-            #
             #   Combine multiple filters using `and` or `or`.
             #
-            #   @param filters [Array<OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Filter::ComparisonFilter, Object>] Array of filters to combine. Items can be `ComparisonFilter` or `CompoundFilter`
+            #   @param filters [Array<OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Filter::ComparisonFilter, Object>]
+            #     Array of filters to combine. Items can be `ComparisonFilter` or
+            #     `CompoundFilter`.
             #
-            #   @param type [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Type] Type of operation: `and` or `or`.
+            #   @param type [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Type]
+            #     Type of operation: `and` or `or`.
 
             # A filter used to compare a specified attribute key to a given value using a
             # defined comparison operation.
@@ -261,18 +273,28 @@ module OpenAI
                 )
 
                 # @!method initialize(key:, type:, value:)
-                #   Some parameter documentations has been truncated, see
-                #   {OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Filter::ComparisonFilter}
-                #   for more details.
-                #
                 #   A filter used to compare a specified attribute key to a given value using a
                 #   defined comparison operation.
                 #
-                #   @param key [String] The key to compare against the value.
+                #   @param key [String]
+                #     The key to compare against the value.
+                #
+                #   @param type [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Filter::ComparisonFilter::Type]
+                #     Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
+                #     `nin`.
                 #
-                #   @param type [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::Filters::CompoundFilter::Filter::ComparisonFilter::Type] Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `
+                #     - `eq`: equals
+                #     - `ne`: not equal
+                #     - `gt`: greater than
+                #     - `gte`: greater than or equal
+                #     - `lt`: less than
+                #     - `lte`: less than or equal
+                #     - `in`: in
+                #     - `nin`: not in
                 #
-                #   @param value [String, Float, Boolean, Array<String, Float>] The value to compare against the attribute key; supports string, number, or bool
+                #   @param value [String, Float, Boolean, Array<String, Float>]
+                #     The value to compare against the attribute key; supports string, number, or
+                #     boolean types.
 
                 # Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
                 # `nin`.
@@ -391,16 +413,19 @@ module OpenAI
           optional :score_threshold, Float
 
           # @!method initialize(hybrid_search: nil, ranker: nil, score_threshold: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions} for more details.
-          #
           #   Ranking options for search.
           #
-          #   @param hybrid_search [OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions::HybridSearch] Weights that control how reciprocal rank fusion balances semantic embedding matc
+          #   @param hybrid_search [OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions::HybridSearch]
+          #     Weights that control how reciprocal rank fusion balances semantic embedding
+          #     matches versus sparse keyword matches when hybrid search is enabled.
           #
-          #   @param ranker [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions::Ranker] The ranker to use for the file search.
+          #   @param ranker [Symbol, OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions::Ranker]
+          #     The ranker to use for the file search.
           #
-          #   @param score_threshold [Float] The score threshold for the file search, a number between 0 and 1. Numbers close
+          #   @param score_threshold [Float]
+          #     The score threshold for the file search, a number between 0 and 1. Numbers
+          #     closer to 1 will attempt to return only the most relevant results, but may
+          #     return fewer results.
 
           # @see OpenAI::Models::Beta::BetaFileSearchTool::RankingOptions#hybrid_search
           class HybridSearch < OpenAI::Internal::Type::BaseModel
@@ -420,9 +445,11 @@ module OpenAI
             #   Weights that control how reciprocal rank fusion balances semantic embedding
             #   matches versus sparse keyword matches when hybrid search is enabled.
             #
-            #   @param embedding_weight [Float] The weight of the embedding in the reciprocal ranking fusion.
+            #   @param embedding_weight [Float]
+            #     The weight of the embedding in the reciprocal ranking fusion.
             #
-            #   @param text_weight [Float] The weight of the text in the reciprocal ranking fusion.
+            #   @param text_weight [Float]
+            #     The weight of the text in the reciprocal ranking fusion.
           end
 
           # The ranker to use for the file search.

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

@@ -30,12 +30,13 @@ module OpenAI
         # @!method initialize(allowed_callers: nil, environment: nil, type: :shell)
         #   A tool that allows the model to execute shell commands.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaFunctionShellTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaFunctionShellTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
         #   @param environment [OpenAI::Models::Beta::BetaContainerAuto, OpenAI::Models::Beta::BetaLocalEnvironment, OpenAI::Models::Beta::BetaContainerReference, nil]
         #
-        #   @param type [Symbol, :shell] The type of the shell tool. Always `shell`.
-
+        #   @param type [Symbol, :shell]
+        #     The type of the shell tool. Always `shell`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 

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

@@ -64,31 +64,37 @@ module OpenAI
         optional :output_schema, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown], nil?: true
 
         # @!method initialize(name:, parameters:, strict:, allowed_callers: nil, async: nil, defer_loading: nil, description: nil, output_schema: nil, type: :function)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaFunctionTool} for more details.
-        #
         #   Defines a function in your own code the model can choose to call. Learn more
         #   about
-        #   [function calling](https://platform.openai.com/docs/guides/function-calling).
+        #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
         #
-        #   @param name [String] The name of the function to call.
+        #   @param name [String]
+        #     The name of the function to call.
         #
-        #   @param parameters [Hash{Symbol=>Object}, nil] A JSON schema object describing the parameters of the function.
+        #   @param parameters [Hash{Symbol=>Object}, nil]
+        #     A JSON schema object describing the parameters of the function.
         #
-        #   @param strict [Boolean, nil] Whether strict parameter validation is enforced for this function tool.
+        #   @param strict [Boolean, nil]
+        #     Whether strict parameter validation is enforced for this function tool.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaFunctionTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaFunctionTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
         #   @param async [Boolean]
         #
-        #   @param defer_loading [Boolean] Whether this function is deferred and loaded via tool search.
+        #   @param defer_loading [Boolean]
+        #     Whether this function is deferred and loaded via tool search.
         #
-        #   @param description [String, nil] A description of the function. Used by the model to determine whether or not to
+        #   @param description [String, nil]
+        #     A description of the function. Used by the model to determine whether or not to
+        #     call the function.
         #
-        #   @param output_schema [Hash{Symbol=>Object}, nil] A JSON schema object describing the JSON value encoded in string outputs for thi
+        #   @param output_schema [Hash{Symbol=>Object}, nil]
+        #     A JSON schema object describing the JSON value encoded in string outputs for
+        #     this function.
         #
-        #   @param type [Symbol, :function] The type of the function tool. Always `function`.
-
+        #   @param type [Symbol, :function]
+        #     The type of the function tool. Always `function`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 

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

@@ -29,13 +29,17 @@ module OpenAI
         required :type, const: :inline
 
         # @!method initialize(description:, name:, source:, type: :inline)
-        #   @param description [String] The description of the skill.
+        #   @param description [String]
+        #     The description of the skill.
         #
-        #   @param name [String] The name of the skill.
+        #   @param name [String]
+        #     The name of the skill.
         #
-        #   @param source [OpenAI::Models::Beta::BetaInlineSkillSource] Inline skill payload
+        #   @param source [OpenAI::Models::Beta::BetaInlineSkillSource]
+        #     Inline skill payload
         #
-        #   @param type [Symbol, :inline] Defines an inline skill for this request.
+        #   @param type [Symbol, :inline]
+        #     Defines an inline skill for this request.
       end
     end
 

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

@@ -25,11 +25,14 @@ module OpenAI
         # @!method initialize(data:, media_type: :"application/zip", type: :base64)
         #   Inline skill payload
         #
-        #   @param data [String] Base64-encoded skill zip bundle.
+        #   @param data [String]
+        #     Base64-encoded skill zip bundle.
         #
-        #   @param media_type [Symbol, :"application/zip"] The media type of the inline skill payload. Must be `application/zip`.
+        #   @param media_type [Symbol, :"application/zip"]
+        #     The media type of the inline skill payload. Must be `application/zip`.
         #
-        #   @param type [Symbol, :base64] The type of the inline skill source. Must be `base64`.
+        #   @param type [Symbol, :base64]
+        #     The type of the inline skill source. Must be `base64`.
       end
     end
 

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

@@ -17,9 +17,11 @@ module OpenAI
         optional :skills, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::BetaLocalSkill] }
 
         # @!method initialize(skills: nil, type: :local)
-        #   @param skills [Array<OpenAI::Models::Beta::BetaLocalSkill>] An optional list of skills.
+        #   @param skills [Array<OpenAI::Models::Beta::BetaLocalSkill>]
+        #     An optional list of skills.
         #
-        #   @param type [Symbol, :local] Use a local computer environment.
+        #   @param type [Symbol, :local]
+        #     Use a local computer environment.
       end
     end
 

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

@@ -23,11 +23,14 @@ module OpenAI
         required :path, String
 
         # @!method initialize(description:, name:, path:)
-        #   @param description [String] The description of the skill.
+        #   @param description [String]
+        #     The description of the skill.
         #
-        #   @param name [String] The name of the skill.
+        #   @param name [String]
+        #     The name of the skill.
         #
-        #   @param path [String] The path to the directory containing the skill.
+        #   @param path [String]
+        #     The path to the directory containing the skill.
       end
     end
 

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

@@ -31,13 +31,17 @@ module OpenAI
         # @!method initialize(description:, name:, tools:, type: :namespace)
         #   Groups function/custom tools under a shared namespace.
         #
-        #   @param description [String] A description of the namespace shown to the model.
+        #   @param description [String]
+        #     A description of the namespace shown to the model.
         #
-        #   @param name [String] The namespace name used in tool calls (for example, `crm`).
+        #   @param name [String]
+        #     The namespace name used in tool calls (for example, `crm`).
         #
-        #   @param tools [Array<OpenAI::Models::Beta::BetaNamespaceTool::Tool::Function, OpenAI::Models::Beta::BetaCustomTool>] The function/custom tools available inside this namespace.
+        #   @param tools [Array<OpenAI::Models::Beta::BetaNamespaceTool::Tool::Function, OpenAI::Models::Beta::BetaCustomTool>]
+        #     The function/custom tools available inside this namespace.
         #
-        #   @param type [Symbol, :namespace] The type of the tool. Always `namespace`.
+        #   @param type [Symbol, :namespace]
+        #     The type of the tool. Always `namespace`.
 
         # A function or custom tool that belongs to a namespace.
         module Tool
@@ -47,7 +51,7 @@ module OpenAI
 
           variant :function, -> { OpenAI::Beta::BetaNamespaceTool::Tool::Function }
 
-          # A custom tool that processes input using a specified format. Learn more about   [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+          # A custom tool that processes input using a specified format. Learn more about   [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
           variant :custom, -> { OpenAI::Beta::BetaCustomTool }
 
           class Function < OpenAI::Internal::Type::BaseModel
@@ -116,24 +120,30 @@ module OpenAI
             optional :strict, OpenAI::Internal::Type::Boolean, nil?: true
 
             # @!method initialize(name:, allowed_callers: nil, async: nil, defer_loading: nil, description: nil, output_schema: nil, parameters: nil, strict: nil, type: :function)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaNamespaceTool::Tool::Function} for more details.
-            #
             #   @param name [String]
             #
-            #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaNamespaceTool::Tool::Function::AllowedCaller>, nil] The tool invocation context(s).
+            #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaNamespaceTool::Tool::Function::AllowedCaller>, nil]
+            #     The tool invocation context(s).
             #
-            #   @param async [Boolean] Whether the tool response can be returned asynchronously versus immediately retu
+            #   @param async [Boolean]
+            #     Whether the tool response can be returned asynchronously versus immediately
+            #     returned on next response creation.
             #
-            #   @param defer_loading [Boolean] Whether this function should be deferred and discovered via tool search.
+            #   @param defer_loading [Boolean]
+            #     Whether this function should be deferred and discovered via tool search.
             #
             #   @param description [String, nil]
             #
-            #   @param output_schema [Hash{Symbol=>Object}, nil] A JSON Schema describing the JSON value encoded in string outputs for this funct
+            #   @param output_schema [Hash{Symbol=>Object}, nil]
+            #     A JSON Schema describing the JSON value encoded in string outputs for this
+            #     function tool. This does not describe content-array outputs.
             #
             #   @param parameters [Object, nil]
             #
-            #   @param strict [Boolean, nil] Whether to enforce strict parameter validation. If omitted, Responses attempts t
+            #   @param strict [Boolean, nil]
+            #     Whether to enforce strict parameter validation. If omitted, Responses attempts
+            #     to use strict validation when the schema is compatible, and falls back to
+            #     non-strict validation otherwise.
             #
             #   @param type [Symbol, :function]