openai 0.56.0 → 0.58.0

data/lib/openai/models/responses/response_output_item.rb

@@ -20,6 +20,8 @@ module OpenAI
         # [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more information.
         variant :function_call, -> { OpenAI::Responses::ResponseFunctionToolCall }
 
+        variant :function_call_output, -> { OpenAI::Responses::ResponseFunctionToolCallOutputItem }
+
         # The results of a web search tool call. See the
         # [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more information.
         variant :web_search_call, -> { OpenAI::Responses::ResponseFunctionWebSearch }
@@ -28,6 +30,8 @@ module OpenAI
         # [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more information.
         variant :computer_call, -> { OpenAI::Responses::ResponseComputerToolCall }
 
+        variant :computer_call_output, -> { OpenAI::Responses::ResponseComputerToolCallOutputItem }
+
         # A description of the chain of thought used by a reasoning model while generating
         # a response. Be sure to include these items in your `input` to the Responses API
         # for subsequent turns of a conversation if you are manually
@@ -50,6 +54,9 @@ module OpenAI
         # A tool call to run a command on the local shell.
         variant :local_shell_call, -> { OpenAI::Responses::ResponseOutputItem::LocalShellCall }
 
+        # The output of a local shell tool call.
+        variant :local_shell_call_output, -> { OpenAI::Responses::ResponseOutputItem::LocalShellCallOutput }
+
         # A tool call that executes one or more shell commands in a managed environment.
         variant :shell_call, -> { OpenAI::Responses::ResponseFunctionShellToolCall }
 
@@ -71,9 +78,15 @@ module OpenAI
         # A request for human approval of a tool invocation.
         variant :mcp_approval_request, -> { OpenAI::Responses::ResponseOutputItem::McpApprovalRequest }
 
+        # A response to an MCP approval request.
+        variant :mcp_approval_response, -> { OpenAI::Responses::ResponseOutputItem::McpApprovalResponse }
+
         # A call to a custom tool created by the model.
         variant :custom_tool_call, -> { OpenAI::Responses::ResponseCustomToolCall }
 
+        # The output of a custom tool call from your code, being sent back to the model.
+        variant :custom_tool_call_output, -> { OpenAI::Responses::ResponseCustomToolCallOutputItem }
+
         class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
           # @!attribute id
           #   The unique ID of the image generation call.
@@ -247,6 +260,63 @@ module OpenAI
           end
         end
 
+        class LocalShellCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the local shell tool call generated by the model.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute output
+          #   A JSON string of the output of the local shell tool call.
+          #
+          #   @return [String]
+          required :output, String
+
+          # @!attribute type
+          #   The type of the local shell tool call output. Always `local_shell_call_output`.
+          #
+          #   @return [Symbol, :local_shell_call_output]
+          required :type, const: :local_shell_call_output
+
+          # @!attribute status
+          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput::Status, nil]
+          optional :status,
+                   enum: -> { OpenAI::Responses::ResponseOutputItem::LocalShellCallOutput::Status },
+                   nil?: true
+
+          # @!method initialize(id:, output:, status: nil, type: :local_shell_call_output)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput} for more
+          #   details.
+          #
+          #   The output of a local shell tool call.
+          #
+          #   @param id [String] The unique ID of the local shell tool call generated by the model.
+          #
+          #   @param output [String] A JSON string of the output of the local shell tool call.
+          #
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput::Status, nil] The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #
+          #   @param type [Symbol, :local_shell_call_output] The type of the local shell tool call output. Always `local_shell_call_output`.
+
+          # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #
+          # @see OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         class McpCall < OpenAI::Internal::Type::BaseModel
           # @!attribute id
           #   The unique ID of the tool call.
@@ -486,8 +556,57 @@ module OpenAI
           #   @param type [Symbol, :mcp_approval_request] The type of the item. Always `mcp_approval_request`.
         end
 
+        class McpApprovalResponse < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the approval response
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute approval_request_id
+          #   The ID of the approval request being answered.
+          #
+          #   @return [String]
+          required :approval_request_id, String
+
+          # @!attribute approve
+          #   Whether the request was approved.
+          #
+          #   @return [Boolean]
+          required :approve, OpenAI::Internal::Type::Boolean
+
+          # @!attribute type
+          #   The type of the item. Always `mcp_approval_response`.
+          #
+          #   @return [Symbol, :mcp_approval_response]
+          required :type, const: :mcp_approval_response
+
+          # @!attribute reason
+          #   Optional reason for the decision.
+          #
+          #   @return [String, nil]
+          optional :reason, String, nil?: true
+
+          # @!method initialize(id:, approval_request_id:, approve:, reason: nil, type: :mcp_approval_response)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse} for more
+          #   details.
+          #
+          #   A response to an MCP approval request.
+          #
+          #   @param id [String] The unique ID of the approval response
+          #
+          #   @param approval_request_id [String] The ID of the approval request being answered.
+          #
+          #   @param approve [Boolean] Whether the request was approved.
+          #
+          #   @param reason [String, nil] Optional reason for the decision.
+          #
+          #   @param type [Symbol, :mcp_approval_response] The type of the item. Always `mcp_approval_response`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall)]
+        #   @return [Array(OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem)]
       end
     end
   end

data/lib/openai/models/responses/response_output_item_added_event.rb

@@ -7,7 +7,7 @@ module OpenAI
         # @!attribute item
         #   The output item that was added.
         #
-        #   @return [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall]
+        #   @return [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem]
         required :item, union: -> { OpenAI::Responses::ResponseOutputItem }
 
         # @!attribute output_index
@@ -34,7 +34,7 @@ module OpenAI
         #
         #   Emitted when a new output item is added.
         #
-        #   @param item [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall] The output item that was added.
+        #   @param item [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem] The output item that was added.
         #
         #   @param output_index [Integer] The index of the output item that was added.
         #

data/lib/openai/models/responses/response_output_item_done_event.rb

@@ -7,7 +7,7 @@ module OpenAI
         # @!attribute item
         #   The output item that was marked done.
         #
-        #   @return [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall]
+        #   @return [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem]
         required :item, union: -> { OpenAI::Responses::ResponseOutputItem }
 
         # @!attribute output_index
@@ -34,7 +34,7 @@ module OpenAI
         #
         #   Emitted when an output item is marked done.
         #
-        #   @param item [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall] The output item that was marked done.
+        #   @param item [OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem] The output item that was marked done.
         #
         #   @param output_index [Integer] The index of the output item that was marked done.
         #

data/lib/openai/models/vector_stores/file_batch_create_params.rb

@@ -38,8 +38,9 @@ module OpenAI
         #   A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
         #   the vector store should use. Useful for tools like `file_search` that can access
         #   files. If `attributes` or `chunking_strategy` are provided, they will be applied
-        #   to all files in the batch. The maximum batch size is 2000 files. Mutually
-        #   exclusive with `files`.
+        #   to all files in the batch. The maximum batch size is 2000 files. This endpoint
+        #   is recommended for multi-file ingestion and helps reduce per-vector-store write
+        #   request pressure. Mutually exclusive with `files`.
         #
         #   @return [Array<String>, nil]
         optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
@@ -48,8 +49,9 @@ module OpenAI
         #   A list of objects that each include a `file_id` plus optional `attributes` or
         #   `chunking_strategy`. Use this when you need to override metadata for specific
         #   files. The global `attributes` or `chunking_strategy` will be ignored and must
-        #   be specified for each file. The maximum batch size is 2000 files. Mutually
-        #   exclusive with `file_ids`.
+        #   be specified for each file. The maximum batch size is 2000 files. This endpoint
+        #   is recommended for multi-file ingestion and helps reduce per-vector-store write
+        #   request pressure. Mutually exclusive with `file_ids`.
         #
         #   @return [Array<OpenAI::Models::VectorStores::FileBatchCreateParams::File>, nil]
         optional :files, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::VectorStores::FileBatchCreateParams::File] }
@@ -87,7 +89,9 @@ module OpenAI
           # @!attribute file_id
           #   A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           #   vector store should use. Useful for tools like `file_search` that can access
-          #   files.
+          #   files. For multi-file ingestion, we recommend
+          #   [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          #   to minimize per-vector-store write requests.
           #
           #   @return [String]
           required :file_id, String

data/lib/openai/models/vector_stores/file_create_params.rb

@@ -16,7 +16,9 @@ module OpenAI
         # @!attribute file_id
         #   A [File](https://platform.openai.com/docs/api-reference/files) ID that the
         #   vector store should use. Useful for tools like `file_search` that can access
-        #   files.
+        #   files. For multi-file ingestion, we recommend
+        #   [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+        #   to minimize per-vector-store write requests.
         #
         #   @return [String]
         required :file_id, String

data/lib/openai/models.rb

@@ -207,6 +207,8 @@ module OpenAI
 
   ModerationTextInput = OpenAI::Models::ModerationTextInput
 
+  OAuthErrorCode = OpenAI::Models::OAuthErrorCode
+
   OtherFileChunkingStrategyObject = OpenAI::Models::OtherFileChunkingStrategyObject
 
   Realtime = OpenAI::Models::Realtime

data/lib/openai/resources/conversations/items.rb

@@ -52,7 +52,7 @@ module OpenAI
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput]
+        # @return [OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput]
         #
         # @see OpenAI::Models::Conversations::ItemRetrieveParams
         def retrieve(item_id, params)
@@ -90,7 +90,7 @@ module OpenAI
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [OpenAI::Internal::ConversationCursorPage<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>]
+        # @return [OpenAI::Internal::ConversationCursorPage<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>]
         #
         # @see OpenAI::Models::Conversations::ItemListParams
         def list(conversation_id, params = {})

data/lib/openai/resources/realtime/calls.rb

@@ -32,7 +32,7 @@ module OpenAI
         #
         # @param tools [Array<OpenAI::Models::Realtime::RealtimeFunctionTool, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp>] Tools available to the model.
         #
-        # @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil] Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces
+        # @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil] Realtime API can write session traces to the [Traces Dashboard](https://platform
         #
         # @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] When the number of tokens in a conversation exceeds the model's input token limi
         #

data/lib/openai/resources/responses/input_items.rb

@@ -23,7 +23,7 @@ module OpenAI
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Responses::ResponseInputMessageItem, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseItem::LocalShellCall, OpenAI::Models::Responses::ResponseItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseItem::McpListTools, OpenAI::Models::Responses::ResponseItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseItem::McpCall>]
+        # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Responses::ResponseInputMessageItem, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseItem::LocalShellCall, OpenAI::Models::Responses::ResponseItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseItem::McpListTools, OpenAI::Models::Responses::ResponseItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallItem, OpenAI::Models::Responses::ResponseCustomToolCallOutputItem>]
         #
         # @see OpenAI::Models::Responses::InputItemListParams
         def list(response_id, params = {})

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.56.0"
+  VERSION = "0.58.0"
 end

data/lib/openai.rb

@@ -29,6 +29,13 @@ require "connection_pool"
 
 # Package files.
 require_relative "openai/version"
+require_relative "openai/auth/workload_identity"
+require_relative "openai/auth/subject_token_provider"
+require_relative "openai/auth/token_type"
+require_relative "openai/auth/workload_identity_auth"
+require_relative "openai/auth/subject_token_providers/k8s_service_account_token_provider"
+require_relative "openai/auth/subject_token_providers/azure_managed_identity_token_provider"
+require_relative "openai/auth/subject_token_providers/gcp_id_token_provider"
 require_relative "openai/internal/util"
 require_relative "openai/internal/type/converter"
 require_relative "openai/internal/type/unknown"
@@ -74,6 +81,8 @@ require_relative "openai/models/graders/python_grader"
 require_relative "openai/models/graders/text_similarity_grader"
 require_relative "openai/models/fine_tuning/fine_tuning_job_wandb_integration_object"
 require_relative "openai/models/realtime/realtime_session_create_request"
+require_relative "openai/models/responses/response_custom_tool_call"
+require_relative "openai/models/responses/response_custom_tool_call_output"
 require_relative "openai/models/responses/response_function_tool_call"
 require_relative "openai/models/all_models"
 require_relative "openai/models/audio/speech_create_params"
@@ -419,6 +428,7 @@ require_relative "openai/models/moderation_image_url_input"
 require_relative "openai/models/moderation_model"
 require_relative "openai/models/moderation_multi_modal_input"
 require_relative "openai/models/moderation_text_input"
+require_relative "openai/models/oauth_error_code"
 require_relative "openai/models/other_file_chunking_strategy_object"
 require_relative "openai/models/realtime/audio_transcription"
 require_relative "openai/models/realtime/call_accept_params"
@@ -588,10 +598,10 @@ require_relative "openai/models/responses/response_content_part_done_event"
 require_relative "openai/models/responses/response_conversation_param"
 require_relative "openai/models/responses/response_created_event"
 require_relative "openai/models/responses/response_create_params"
-require_relative "openai/models/responses/response_custom_tool_call"
 require_relative "openai/models/responses/response_custom_tool_call_input_delta_event"
 require_relative "openai/models/responses/response_custom_tool_call_input_done_event"
-require_relative "openai/models/responses/response_custom_tool_call_output"
+require_relative "openai/models/responses/response_custom_tool_call_item"
+require_relative "openai/models/responses/response_custom_tool_call_output_item"
 require_relative "openai/models/responses/response_delete_params"
 require_relative "openai/models/responses/response_error"
 require_relative "openai/models/responses/response_error_event"

data/rbi/openai/auth.rbi

@@ -0,0 +1,55 @@
+# typed: strong
+
+module OpenAI
+  module Auth
+    module TokenType
+      JWT = T.let(:jwt, Symbol)
+      ID = T.let(:id, Symbol)
+    end
+
+    module SubjectTokenProvider
+      sig { returns(Symbol) }
+      def token_type
+      end
+
+      sig { returns(String) }
+      def get_token
+      end
+    end
+
+    class WorkloadIdentity
+      sig { returns(String) }
+      attr_reader :client_id
+
+      sig { returns(String) }
+      attr_reader :identity_provider_id
+
+      sig { returns(String) }
+      attr_reader :service_account_id
+
+      sig { returns(SubjectTokenProvider) }
+      attr_reader :provider
+
+      sig { returns(Integer) }
+      attr_reader :refresh_buffer_seconds
+
+      sig do
+        params(
+          client_id: T.any(String, Symbol),
+          identity_provider_id: T.any(String, Symbol),
+          service_account_id: T.any(String, Symbol),
+          provider: SubjectTokenProvider,
+          refresh_buffer_seconds: Integer
+        ).void
+      end
+      def initialize(
+        client_id:,
+        identity_provider_id:,
+        service_account_id:,
+        provider:,
+        refresh_buffer_seconds: 1200
+      )
+      end
+    end
+  end
+end

data/rbi/openai/internal/util.rbi

@@ -148,12 +148,20 @@ module OpenAI
         end
       end
 
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = T.let(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/, Regexp)
+
       class << self
         # @api private
         sig { params(uri: URI::Generic).returns(String) }
         def uri_origin(uri)
         end
 
+        # @api private
+        sig { params(path: T.any(String, Integer)).returns(String) }
+        def encode_path(path)
+        end
+
         # @api private
         sig { params(path: T.any(String, T::Array[String])).returns(String) }
         def interpolate_path(path)

data/rbi/openai/models/conversations/conversation_item.rbi

@@ -25,6 +25,7 @@ module OpenAI
               OpenAI::Responses::ResponseToolSearchCall,
               OpenAI::Responses::ResponseToolSearchOutputItem,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Responses::ResponseCompactionItem,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
               OpenAI::Conversations::ConversationItem::LocalShellCall,
               OpenAI::Conversations::ConversationItem::LocalShellCallOutput,

data/rbi/openai/models/conversations/conversation_item_list.rbi

@@ -53,6 +53,7 @@ module OpenAI
                   OpenAI::Responses::ResponseToolSearchCall::OrHash,
                   OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
+                  OpenAI::Responses::ResponseCompactionItem::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                   OpenAI::Conversations::ConversationItem::LocalShellCall::OrHash,
                   OpenAI::Conversations::ConversationItem::LocalShellCallOutput::OrHash,

data/rbi/openai/models/conversations/message.rbi

@@ -33,6 +33,17 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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.
+        sig do
+          returns(
+            T.nilable(OpenAI::Conversations::Message::Phase::TaggedSymbol)
+          )
+        end
+        attr_accessor :phase
+
         # A message to or from the model.
         sig do
           params(
@@ -53,6 +64,7 @@ module OpenAI
               ],
             role: OpenAI::Conversations::Message::Role::OrSymbol,
             status: OpenAI::Conversations::Message::Status::OrSymbol,
+            phase: T.nilable(OpenAI::Conversations::Message::Phase::OrSymbol),
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -67,6 +79,11 @@ module OpenAI
           # The status of item. One of `in_progress`, `completed`, or `incomplete`.
           # Populated when items are returned via API.
           status:,
+          # 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.
+          phase: nil,
           # The type of the message. Always set to `message`.
           type: :message
         )
@@ -80,7 +97,9 @@ module OpenAI
                 T::Array[OpenAI::Conversations::Message::Content::Variants],
               role: OpenAI::Conversations::Message::Role::TaggedSymbol,
               status: OpenAI::Conversations::Message::Status::TaggedSymbol,
-              type: Symbol
+              type: Symbol,
+              phase:
+                T.nilable(OpenAI::Conversations::Message::Phase::TaggedSymbol)
             }
           )
         end
@@ -226,6 +245,39 @@ module OpenAI
           def self.values
           end
         end
+
+        # 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.
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Conversations::Message::Phase)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          COMMENTARY =
+            T.let(
+              :commentary,
+              OpenAI::Conversations::Message::Phase::TaggedSymbol
+            )
+          FINAL_ANSWER =
+            T.let(
+              :final_answer,
+              OpenAI::Conversations::Message::Phase::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Conversations::Message::Phase::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/models/oauth_error_code.rbi

@@ -0,0 +1,24 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module OAuthErrorCode
+      extend OpenAI::Internal::Type::Union
+
+      Variants =
+        T.type_alias { T.any(OpenAI::OAuthErrorCode::TaggedSymbol, String) }
+
+      sig { override.returns(T::Array[OpenAI::OAuthErrorCode::Variants]) }
+      def self.variants
+      end
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::OAuthErrorCode) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      INVALID_GRANT =
+        T.let(:invalid_grant, OpenAI::OAuthErrorCode::TaggedSymbol)
+      INVALID_SUBJECT_TOKEN =
+        T.let(:invalid_subject_token, OpenAI::OAuthErrorCode::TaggedSymbol)
+    end
+  end
+end

data/rbi/openai/models/realtime/realtime_session_create_request.rbi

@@ -193,8 +193,9 @@ module OpenAI
         attr_writer :tools
 
         # Realtime API can write session traces to the
-        # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-        # tracing is enabled for a session, the configuration cannot be modified.
+        # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+        # disable tracing. Once tracing is enabled for a session, the configuration cannot
+        # be modified.
         #
         # `auto` will create a trace for the session with default values for the workflow
         # name, group id, and metadata.
@@ -339,8 +340,9 @@ module OpenAI
           # Tools available to the model.
           tools: nil,
           # Realtime API can write session traces to the
-          # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-          # tracing is enabled for a session, the configuration cannot be modified.
+          # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+          # disable tracing. Once tracing is enabled for a session, the configuration cannot
+          # be modified.
           #
           # `auto` will create a trace for the session with default values for the workflow
           # name, group id, and metadata.