openai 0.96.0 → 0.98.0

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

@@ -24,6 +24,9 @@ module OpenAI
         # Web search.
         variant :web_search, -> { OpenAI::Beta::PersistedAgentTool::WebSearch }
 
+        # Browser use in an OpenAI-hosted session.
+        variant :computer_use, -> { OpenAI::Beta::PersistedAgentTool::ComputerUse }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute defer_loading
           #   Whether the function is deferred and discovered through tool search.
@@ -321,8 +324,31 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          # @!attribute include_screenshots
+          #   Whether computer tool outputs include screenshots.
+          #
+          #   @return [Boolean]
+          required :include_screenshots, OpenAI::Internal::Type::Boolean
+
+          # @!attribute type
+          #   The type of the object. Always `computer_use`.
+          #
+          #   @return [Symbol, :computer_use]
+          required :type, const: :computer_use
+
+          # @!method initialize(include_screenshots:, type: :computer_use)
+          #   Browser use in an OpenAI-hosted session.
+          #
+          #   @param include_screenshots [Boolean]
+          #     Whether computer tool outputs include screenshots.
+          #
+          #   @param type [Symbol, :computer_use]
+          #     The type of the object. Always `computer_use`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch, OpenAI::Models::Beta::PersistedAgentTool::ComputerUse)]
       end
     end
   end

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

@@ -24,6 +24,9 @@ module OpenAI
         # Web search.
         variant :web_search, -> { OpenAI::Beta::PersistedAgentToolParam::WebSearch }
 
+        # Browser use in an OpenAI-hosted session.
+        variant :computer_use, -> { OpenAI::Beta::PersistedAgentToolParam::ComputerUse }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute description
           #   A description of what the function does.
@@ -347,8 +350,31 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `computer_use`.
+          #
+          #   @return [Symbol, :computer_use]
+          required :type, const: :computer_use
+
+          # @!attribute include_screenshots
+          #   Whether computer tool outputs include screenshots. Defaults to `false`.
+          #
+          #   @return [Boolean, nil]
+          optional :include_screenshots, OpenAI::Internal::Type::Boolean
+
+          # @!method initialize(include_screenshots: nil, type: :computer_use)
+          #   Browser use in an OpenAI-hosted session.
+          #
+          #   @param include_screenshots [Boolean]
+          #     Whether computer tool outputs include screenshots. Defaults to `false`.
+          #
+          #   @param type [Symbol, :computer_use]
+          #     The type of the object. Always `computer_use`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse)]
       end
     end
   end

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

@@ -46,6 +46,9 @@ module OpenAI
           # The request exceeds the available rate limit.
           RATE_LIMIT_EXCEEDED = :rate_limit_exceeded
 
+          # Flex processing is temporarily unavailable.
+          FLEX_UNAVAILABLE = :flex_unavailable
+
           # The model service is temporarily overloaded.
           SERVER_OVERLOADED = :server_overloaded
 

data/lib/openai/models/chat/chat_completion_content_part_image.rb

@@ -73,6 +73,7 @@ module OpenAI
             AUTO = :auto
             LOW = :low
             HIGH = :high
+            ORIGINAL = :original
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/openai/models/live/fork_server_event.rb

@@ -67,7 +67,7 @@ module OpenAI
         # A SIP DTMF keypress received from the caller. Delivered only to sideband observers.
         variant :"transport.dtmf.received", -> { OpenAI::Live::ForkServerEvent::TransportDtmfReceived }
 
-        # A SIP DTMF keypress successfully sent by the hosted tool. Delivered only to sideband observers; this is not a client command.
+        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
         variant :"transport.dtmf.send", -> { OpenAI::Live::ForkServerEvent::TransportDtmfSend }
 
         # The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
@@ -148,12 +148,23 @@ module OpenAI
           #   @return [Symbol, :"transport.dtmf.send"]
           required :type, const: :"transport.dtmf.send"
 
-          # @!method initialize(event:, event_id:, type: :"transport.dtmf.send")
-          #   A SIP DTMF keypress successfully sent by the hosted tool. Delivered only to
+          # @!attribute client_event_id
+          #   The event_id of the client command, when supplied.
+          #
+          #   @return [String, nil]
+          optional :client_event_id, String
+
+          # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.send")
+          #   A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to
           #   sideband observers; this is not a client command.
           #
           #   @param event [String]
+          #
           #   @param event_id [String]
+          #
+          #   @param client_event_id [String]
+          #     The event_id of the client command, when supplied.
+          #
           #   @param type [Symbol, :"transport.dtmf.send"]
         end
 

data/lib/openai/models/live/server_event.rb

@@ -67,7 +67,7 @@ module OpenAI
         # A SIP DTMF keypress received from the caller. Delivered only to sideband observers.
         variant :"transport.dtmf.received", -> { OpenAI::Live::ServerEvent::TransportDtmfReceived }
 
-        # A SIP DTMF keypress successfully sent by the hosted tool. Delivered only to sideband observers; this is not a client command.
+        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
         variant :"transport.dtmf.send", -> { OpenAI::Live::ServerEvent::TransportDtmfSend }
 
         # The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
@@ -148,12 +148,23 @@ module OpenAI
           #   @return [Symbol, :"transport.dtmf.send"]
           required :type, const: :"transport.dtmf.send"
 
-          # @!method initialize(event:, event_id:, type: :"transport.dtmf.send")
-          #   A SIP DTMF keypress successfully sent by the hosted tool. Delivered only to
+          # @!attribute client_event_id
+          #   The event_id of the client command, when supplied.
+          #
+          #   @return [String, nil]
+          optional :client_event_id, String
+
+          # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.send")
+          #   A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to
           #   sideband observers; this is not a client command.
           #
           #   @param event [String]
+          #
           #   @param event_id [String]
+          #
+          #   @param client_event_id [String]
+          #     The event_id of the client command, when supplied.
+          #
           #   @param type [Symbol, :"transport.dtmf.send"]
         end
 

data/lib/openai/models/realtime/translations/client_secret_create_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Realtime
+      module Translations
+        # @see OpenAI::Resources::Realtime::Translations::ClientSecrets#create
+        class ClientSecretCreateParams < OpenAI::Models::Realtime::RealtimeTranslationClientSecretCreateRequest
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!method initialize(session:, expires_after: nil, request_options: {})
+          #   @param session [OpenAI::Models::Realtime::RealtimeTranslationSessionCreateRequest]
+          #     Realtime translation session configuration. Translation sessions stream source
+          #     audio in and translated audio plus transcript deltas out continuously.
+          #
+          #   @param expires_after [OpenAI::Models::Realtime::RealtimeTranslationClientSecretCreateRequest::ExpiresAfter]
+          #     Configuration for the client secret expiration. Expiration refers to the time
+          #     after which a client secret will no longer be valid for creating sessions. The
+          #     session itself may continue after that time once started. A secret can be used
+          #     to create multiple sessions until it expires.
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

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

@@ -87,7 +87,7 @@ module OpenAI
             required :filename, String
 
             # @!attribute index
-            #   The index of the file in the list of files.
+            #   The index in the output text at which to insert the file citation.
             #
             #   @return [Integer]
             required :index, Integer
@@ -108,7 +108,7 @@ module OpenAI
             #     The filename of the file cited.
             #
             #   @param index [Integer]
-            #     The index of the file in the list of files.
+            #     The index in the output text at which to insert the file citation.
             #
             #   @param type [Symbol, :file_citation]
             #     The type of the file citation. Always `file_citation`.

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

@@ -117,7 +117,7 @@ module OpenAI
             required :filename, String
 
             # @!attribute index
-            #   The index of the file in the list of files.
+            #   The index in the output text at which to insert the file citation.
             #
             #   @return [Integer]
             required :index, Integer
@@ -138,7 +138,7 @@ module OpenAI
             #     The filename of the file cited.
             #
             #   @param index [Integer]
-            #     The index of the file in the list of files.
+            #     The index in the output text at which to insert the file citation.
             #
             #   @param type [Symbol, :file_citation]
             #     The type of the file citation. Always `file_citation`.

data/lib/openai/resources/beta/agents/environments/files.rb

@@ -1,11 +1,42 @@
 # frozen_string_literal: true
 
+require_relative "../../../../helpers/beta/agents/files"
+
 module OpenAI
   module Resources
     class Beta
       class Agents
         class Environments
           class Files
+            # Upload selected local files for a new hosted environment (beta).
+            # @return [OpenAI::Helpers::Beta::Agents::PreparedFiles]
+            def prepare(files, request_options: {})
+              OpenAI::Helpers::Beta::Agents::FilePreparation
+                .new(client: @client, environment_files: self)
+                .prepare(files, request_options: request_options)
+            end
+
+            # Upload an explicitly selected directory snapshot (beta).
+            # @return [OpenAI::Helpers::Beta::Agents::PreparedFiles]
+            def prepare_directory(directory, destination:, include:, request_options: {})
+              OpenAI::Helpers::Beta::Agents::FilePreparation
+                .new(client: @client, environment_files: self)
+                .prepare_directory(
+                  directory,
+                  destination: destination,
+                  include: include,
+                  request_options: request_options
+                )
+            end
+
+            # Upload and stage a local file in an existing environment (beta).
+            # @return [OpenAI::Helpers::Beta::Agents::PreparedFiles]
+            def upload(environment_id, file:, path:, request_options: {})
+              OpenAI::Helpers::Beta::Agents::FilePreparation
+                .new(client: @client, environment_files: self)
+                .upload(environment_id, file: file, path: path, request_options: request_options)
+            end
+
             # Copies inline bytes or a Files API file into a connected execution environment.
             # See
             # [environment files](https://developers.openai.com/api/docs/guides/agents-api/environments/files).

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -10,12 +10,16 @@ module OpenAI
             # commands or environment values. See
             # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
             #
-            # @overload create(capability_directories: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
+            # @overload create(capability_directories: nil, desktop: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
             #
             # @param capability_directories [Array<String>, nil]
             #   Directories that contain capabilities exposed to the agent. Defaults to an empty
             #   list.
             #
+            # @param desktop [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Desktop, nil]
+            #   Desktop provisioning. Omission or null inherits the template setting, or
+            #   defaults to disabled.
+            #
             # @param env [Hash{Symbol=>String}, nil]
             #   Environment variables made available to the agent.
             #
@@ -87,7 +91,7 @@ module OpenAI
             # values. See
             # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
             #
-            # @overload update(environment_template_id, capability_directories: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
+            # @overload update(environment_template_id, capability_directories: nil, desktop: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
             #
             # @param environment_template_id [String]
             #   The ID of the reusable environment template.
@@ -95,6 +99,9 @@ module OpenAI
             # @param capability_directories [Array<String>, nil]
             #   Directories that expose capabilities to the agent.
             #
+            # @param desktop [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Desktop, nil]
+            #   Replacement desktop configuration, or null to disable the desktop.
+            #
             # @param env [Hash{Symbol=>String}, nil]
             #   Replacement confidential environment values.
             #

data/lib/openai/resources/beta/agents/sessions/artifacts.rb

@@ -1,11 +1,19 @@
 # frozen_string_literal: true
 
+require_relative "../../../../helpers/beta/agents/artifacts"
+
 module OpenAI
   module Resources
     class Beta
       class Agents
         class Sessions
           class Artifacts
+            # Access artifacts from exactly this completed turn (beta).
+            # @return [OpenAI::Helpers::Beta::Agents::ResultArtifacts]
+            def for_result(result)
+              OpenAI::Helpers::Beta::Agents::ResultArtifacts.new(artifacts: self, client: @client, result: result)
+            end
+
             # Retrieves immutable metadata for one durable session artifact. See
             # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
             #

data/lib/openai/resources/beta/agents/sessions/events.rb

@@ -6,11 +6,12 @@ module OpenAI
       class Agents
         class Sessions
           class Events
-            # Submits message, cancellation, or tool-result events to a managed agent session.
-            # Cancellation can recover a still-open turn whose backend execution has ended by
-            # marking it cancelled and abandoning unpublished outputs. Saved results,
-            # published files, and existing terminal outcomes are preserved. HTTP 202 confirms
-            # acceptance, not durable completion. See
+            # Submits message, cancellation, tool-result, or computer-use approval-response
+            # events to a managed agent session. Cancellation can recover a still-open turn
+            # whose backend execution has ended by marking it cancelled and abandoning
+            # unpublished outputs. Saved results, published files, and existing terminal
+            # outcomes are preserved. HTTP 202 confirms acceptance, not durable completion.
+            # See
             # [session events](https://developers.openai.com/api/docs/guides/agents-api/sessions/events).
             #
             # @overload create(session_id, events:, idempotency_key: nil, request_options: {})
@@ -18,7 +19,7 @@ module OpenAI
             # @param session_id [String]
             #   Path param: The ID of the session.
             #
-            # @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
+            # @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
             #   Body param: The input events to submit to the session.
             #
             # @param idempotency_key [String]

data/lib/openai/resources/beta/agents/sessions/items.rb

@@ -26,7 +26,7 @@ module OpenAI
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
             #
             # @see OpenAI::Models::Beta::Agents::Sessions::ItemListParams
             def list(session_id, params = {})

data/lib/openai/resources/beta/agents/sessions/subagents/items.rb

@@ -30,7 +30,7 @@ module OpenAI
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #
-              # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+              # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
               #
               # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::ItemListParams
               def list(subagent_id, params)

data/lib/openai/resources/beta/agents/sessions/subagents/turns/items.rb

@@ -34,7 +34,7 @@ module OpenAI
                 #
                 # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
                 #
-                # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+                # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
                 #
                 # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::Turns::ItemListParams
                 def list(turn_id, params)

data/lib/openai/resources/beta/agents/sessions/traces.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Traces
+            # Lists published root-turn traces as OTLP JSON, ordered by turn creation time and
+            # ID. Unpublished traces are skipped. Each page returns data available when read;
+            # it does not wait for late traces. Trace reads and the JSON response are limited
+            # to 16 MiB per request. If the limit is exceeded, request fewer traces.
+            #
+            # @overload list(session_id, after: nil, limit: nil, order: nil, request_options: {})
+            #
+            # @param session_id [String]
+            #   The ID of the session.
+            #
+            # @param after [String]
+            #   Return resources after this resource ID in the selected order.
+            #
+            # @param limit [Integer]
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
+            #
+            # @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::TraceListParams::Order]
+            #   The order in which resources are returned. Defaults to `desc`.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::Agents::Sessions::SessionTrace>]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::TraceListParams
+            def list(session_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Sessions::TraceListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/traces", session_id],
+                query: query,
+                page: OpenAI::Internal::CursorPage,
+                model: OpenAI::Beta::Agents::Sessions::SessionTrace,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [OpenAI::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/beta/agents/sessions.rb

@@ -17,6 +17,9 @@ module OpenAI
           # @return [OpenAI::Resources::Beta::Agents::Sessions::Events]
           attr_reader :events
 
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Traces]
+          attr_reader :traces
+
           # @return [OpenAI::Resources::Beta::Agents::Sessions::Turns]
           attr_reader :turns
 
@@ -82,7 +85,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, vault_ids: nil, request_options: {})
+          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, metadata: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -108,29 +111,36 @@ module OpenAI
           # @param vault_ids [Array<String>, nil]
           #   The IDs of vaults made available to the session.
           #
+          # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: configure and parse a structured answer.
+          #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
+          # @return [OpenAI::Helpers::Beta::Agents::CreationStream]
           #
           # @see OpenAI::Models::Beta::Agents::SessionCreateParams
           def create_streaming(params)
+            params = params.to_h.transform_keys { _1.is_a?(String) ? _1.to_sym : _1 }
+            output_type = params.delete(:output_type)
+            parser = OpenAI::Helpers::Beta::Agents::OutputParser.new(output_type) unless output_type.nil?
             parsed, options = OpenAI::Beta::Agents::SessionCreateParams.dump_request(params)
             unless parsed.fetch(:stream, true)
               message = "Please use `#create` for the non-streaming use case."
               raise ArgumentError.new(message)
             end
 
+            parser&.prepare_request(parsed)
             parsed.store(:stream, true)
-            @client.request(
+            stream = @client.request(
               method: :post,
               path: "agents/sessions",
               headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
               body: parsed,
-              stream: OpenAI::Internal::Stream,
+              stream: OpenAI::Helpers::Beta::Agents::CreationStream,
               model: OpenAI::Beta::AgentSessionEvent,
               security: {bearer_auth: true},
               options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
             )
+            stream.configure_output_parser(parser)
           end
 
           # Retrieves the current state of a managed agent session. See
@@ -265,16 +275,18 @@ module OpenAI
           # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>]
           # @param tool_handlers [Hash{String=>Proc}]
           # @param idempotency_key [String, nil] Applies only to the input submission.
+          # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: parse output without changing session configuration.
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           # @yieldparam stream [OpenAI::Helpers::Agents::SessionStream]
           # @return [OpenAI::Helpers::Agents::SessionStream]
-          def stream(session_id, input:, tool_handlers: {}, idempotency_key: nil, request_options: {})
+          def stream(session_id, input:, tool_handlers: {}, idempotency_key: nil, output_type: nil, request_options: {})
             stream = OpenAI::Helpers::Agents::SessionStream.new(
               sessions: self,
               session_id: session_id,
               input: input,
               tool_handlers: tool_handlers,
               idempotency_key: idempotency_key,
+              output_type: output_type,
               request_options: request_options
             )
             return stream unless block_given?
@@ -297,6 +309,7 @@ module OpenAI
             @artifacts = OpenAI::Resources::Beta::Agents::Sessions::Artifacts.new(client: client)
             @items = OpenAI::Resources::Beta::Agents::Sessions::Items.new(client: client)
             @events = OpenAI::Resources::Beta::Agents::Sessions::Events.new(client: client)
+            @traces = OpenAI::Resources::Beta::Agents::Sessions::Traces.new(client: client)
             @turns = OpenAI::Resources::Beta::Agents::Sessions::Turns.new(client: client)
           end
         end

data/lib/openai/resources/beta/agents.rb

@@ -46,7 +46,7 @@ module OpenAI
         #   Configuration for generated text. Defaults to the `text` format and medium
         #   verbosity.
         #
-        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch>, nil]
+        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
         #   Tools available to the agent. Defaults to an empty list.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -125,7 +125,7 @@ module OpenAI
         # @param text [OpenAI::Models::Beta::AgentTextParam, nil]
         #   Configuration for text generated by the agent.
         #
-        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch>, nil]
+        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
         #   Tools available to the agent.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/openai/resources/evals/runs.rb

@@ -172,7 +172,7 @@ module OpenAI
 
           @client.request(
             method: :post,
-            path: ["evals/%1$s/runs/%2$s", eval_id, run_id],
+            path: ["evals/%1$s/runs/%2$s/cancel", eval_id, run_id],
             model: OpenAI::Models::Evals::RunCancelResponse,
             security: {bearer_auth: true},
             options: options