openai 0.88.0 → 0.90.0

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

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Subagents
+            class Turns
+              class Items
+                # Lists items belonging to one turn of this subagent. See
+                # [subagent workflows](https://developers.openai.com/api/docs/guides/agents-api/multi-agent).
+                #
+                # @overload list(turn_id, session_id:, subagent_id:, after: nil, limit: nil, order: nil, request_options: {})
+                #
+                # @param turn_id [String]
+                #   Path param: The ID of a turn belonging to this subagent.
+                #
+                # @param session_id [String]
+                #   Path param: The ID of the session.
+                #
+                # @param subagent_id [String]
+                #   Path param: The ID of the subagent in this session.
+                #
+                # @param after [String]
+                #   Query param: Return resources after this resource ID in the selected order.
+                #
+                # @param limit [Integer]
+                #   Query param: The maximum number of resources to return, between 1 and 100.
+                #   Defaults to 20.
+                #
+                # @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order]
+                #   Query param: 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::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>]
+                #
+                # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::Turns::ItemListParams
+                def list(turn_id, params)
+                  parsed, options = OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams.dump_request(
+                    params
+                  )
+                  session_id = parsed.delete(:session_id) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+
+                  subagent_id = parsed.delete(:subagent_id) do
+                    raise ArgumentError.new("missing required path argument #{_1}")
+                  end
+
+                  query = OpenAI::Internal::Util.encode_query_params(parsed)
+                  @client.request(
+                    method: :get,
+                    path: [
+                      "agents/sessions/%1$s/subagents/%2$s/turns/%3$s/items",
+                      session_id,
+                      subagent_id,
+                      turn_id
+                    ],
+                    query: query,
+                    page: OpenAI::Internal::CursorPage,
+                    model: OpenAI::Beta::AgentSessionItem,
+                    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
+  end
+end

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

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Subagents
+            class Turns
+              # @return [OpenAI::Resources::Beta::Agents::Sessions::Subagents::Turns::Items]
+              attr_reader :items
+
+              # Retrieves a turn belonging to this subagent. See
+              # [subagent workflows](https://developers.openai.com/api/docs/guides/agents-api/multi-agent).
+              #
+              # @overload retrieve(turn_id, session_id:, subagent_id:, request_options: {})
+              #
+              # @param turn_id [String]
+              #   The ID of a turn belonging to this subagent.
+              #
+              # @param session_id [String]
+              #   The ID of the session.
+              #
+              # @param subagent_id [String]
+              #   The ID of the subagent in this session.
+              #
+              # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [OpenAI::Models::Beta::Agents::Sessions::Turn]
+              #
+              # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::TurnRetrieveParams
+              def retrieve(turn_id, params)
+                parsed, options = OpenAI::Beta::Agents::Sessions::Subagents::TurnRetrieveParams.dump_request(params)
+                session_id = parsed.delete(:session_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+
+                subagent_id = parsed.delete(:subagent_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+
+                @client.request(
+                  method: :get,
+                  path: ["agents/sessions/%1$s/subagents/%2$s/turns/%3$s", session_id, subagent_id, turn_id],
+                  model: OpenAI::Beta::Agents::Sessions::Turn,
+                  security: {bearer_auth: true},
+                  options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                )
+              end
+
+              # Lists all turns of this subagent, including turns after a resume. See
+              # [subagent workflows](https://developers.openai.com/api/docs/guides/agents-api/multi-agent).
+              #
+              # @overload list(subagent_id, session_id:, after: nil, limit: nil, order: nil, request_options: {})
+              #
+              # @param subagent_id [String]
+              #   Path param: The ID of the subagent in this session.
+              #
+              # @param session_id [String]
+              #   Path param: The ID of the session.
+              #
+              # @param after [String]
+              #   Query param: Return resources after this resource ID in the selected order.
+              #
+              # @param limit [Integer]
+              #   Query param: The maximum number of resources to return, between 1 and 100.
+              #   Defaults to 20.
+              #
+              # @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::Subagents::TurnListParams::Order]
+              #   Query param: 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::Turn>]
+              #
+              # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::TurnListParams
+              def list(subagent_id, params)
+                parsed, options = OpenAI::Beta::Agents::Sessions::Subagents::TurnListParams.dump_request(params)
+                session_id = parsed.delete(:session_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+
+                query = OpenAI::Internal::Util.encode_query_params(parsed)
+                @client.request(
+                  method: :get,
+                  path: ["agents/sessions/%1$s/subagents/%2$s/turns", session_id, subagent_id],
+                  query: query,
+                  page: OpenAI::Internal::CursorPage,
+                  model: OpenAI::Beta::Agents::Sessions::Turn,
+                  security: {bearer_auth: true},
+                  options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                )
+              end
+
+              # @api private
+              #
+              # @param client [OpenAI::Client]
+              def initialize(client:)
+                @client = client
+                @items = OpenAI::Resources::Beta::Agents::Sessions::Subagents::Turns::Items.new(client: client)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Subagents
+            # @return [OpenAI::Resources::Beta::Agents::Sessions::Subagents::Items]
+            attr_reader :items
+
+            # @return [OpenAI::Resources::Beta::Agents::Sessions::Subagents::Turns]
+            attr_reader :turns
+
+            # Retrieves a subagent belonging to this session. See
+            # [subagent workflows](https://developers.openai.com/api/docs/guides/agents-api/multi-agent).
+            #
+            # @overload retrieve(subagent_id, session_id:, request_options: {})
+            #
+            # @param subagent_id [String]
+            #   The ID of the subagent in this session.
+            #
+            # @param session_id [String]
+            #   The ID of the session.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Beta::Subagent]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::SubagentRetrieveParams
+            def retrieve(subagent_id, params)
+              parsed, options = OpenAI::Beta::Agents::Sessions::SubagentRetrieveParams.dump_request(params)
+              session_id = parsed.delete(:session_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/subagents/%2$s", session_id, subagent_id],
+                model: OpenAI::Beta::Subagent,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Lists subagents in a session, including nested and closed subagents. See
+            # [subagent workflows](https://developers.openai.com/api/docs/guides/agents-api/multi-agent).
+            #
+            # @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::SubagentListParams::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::Subagent>]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::SubagentListParams
+            def list(session_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Sessions::SubagentListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/subagents", session_id],
+                query: query,
+                page: OpenAI::Internal::CursorPage,
+                model: OpenAI::Beta::Subagent,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # @api private
+            #
+            # @param client [OpenAI::Client]
+            def initialize(client:)
+              @client = client
+              @items = OpenAI::Resources::Beta::Agents::Sessions::Subagents::Items.new(client: client)
+              @turns = OpenAI::Resources::Beta::Agents::Sessions::Subagents::Turns.new(client: client)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Turns
+            # Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
+            # the turn does not belong to the session. See
+            # [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+            #
+            # @overload retrieve(turn_id, session_id:, request_options: {})
+            #
+            # @param turn_id [String]
+            #   The ID of the turn.
+            #
+            # @param session_id [String]
+            #   The ID of the session that owns the turn.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Beta::Agents::Sessions::Turn]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::TurnRetrieveParams
+            def retrieve(turn_id, params)
+              parsed, options = OpenAI::Beta::Agents::Sessions::TurnRetrieveParams.dump_request(params)
+              session_id = parsed.delete(:session_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/turns/%2$s", session_id, turn_id],
+                model: OpenAI::Beta::Agents::Sessions::Turn,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Lists turns by creation time and turn ID. The after cursor is exclusive in the
+            # selected order. See
+            # [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
+            #
+            # @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::TurnListParams::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::Turn>]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::TurnListParams
+            def list(session_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Sessions::TurnListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/turns", session_id],
+                query: query,
+                page: OpenAI::Internal::CursorPage,
+                model: OpenAI::Beta::Agents::Sessions::Turn,
+                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

@@ -0,0 +1,294 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Subagents]
+          attr_reader :subagents
+
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Artifacts]
+          attr_reader :artifacts
+
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Items]
+          attr_reader :items
+
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Events]
+          attr_reader :events
+
+          # @return [OpenAI::Resources::Beta::Agents::Sessions::Turns]
+          attr_reader :turns
+
+          # See {OpenAI::Resources::Beta::Agents::Sessions#create_streaming} for streaming
+          # counterpart.
+          #
+          # Creates a managed agent session, optionally submits initial input, and returns
+          # 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(environment:, agent: nil, agent_id: nil, input: 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.
+          #
+          # @param agent [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent]
+          #   Agent configuration. With `agent_id`, supplied fields override the saved agent
+          #   for this session. Without `agent_id`, `model` is required.
+          #
+          # @param agent_id [String]
+          #   The ID of a saved reusable agent. Omit `agent` to use its configuration
+          #   unchanged.
+          #
+          # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>, nil]
+          #   Initial input submitted when creating a session.
+          #
+          # @param metadata [Hash{Symbol=>String}, nil]
+          #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+          #   characters. Omission or null defaults to an empty map.
+          #
+          # @param vault_ids [Array<String>, nil]
+          #   The IDs of vaults made available to the session.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::AgentSession]
+          #
+          # @see OpenAI::Models::Beta::Agents::SessionCreateParams
+          def create(params)
+            parsed, options = OpenAI::Beta::Agents::SessionCreateParams.dump_request(params)
+            if parsed[:stream]
+              message = "Please use `#create_streaming` for the streaming use case."
+              raise ArgumentError.new(message)
+            end
+
+            @client.request(
+              method: :post,
+              path: "agents/sessions",
+              body: parsed,
+              model: OpenAI::Beta::AgentSession,
+              security: {bearer_auth: true},
+              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+            )
+          end
+
+          # See {OpenAI::Resources::Beta::Agents::Sessions#create} for non-streaming
+          # counterpart.
+          #
+          # Creates a managed agent session, optionally submits initial input, and returns
+          # 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: {})
+          #
+          # @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.
+          #
+          # @param agent [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent]
+          #   Agent configuration. With `agent_id`, supplied fields override the saved agent
+          #   for this session. Without `agent_id`, `model` is required.
+          #
+          # @param agent_id [String]
+          #   The ID of a saved reusable agent. Omit `agent` to use its configuration
+          #   unchanged.
+          #
+          # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>, nil]
+          #   Initial input submitted when creating a session.
+          #
+          # @param metadata [Hash{Symbol=>String}, nil]
+          #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+          #   characters. Omission or null defaults to an empty map.
+          #
+          # @param vault_ids [Array<String>, nil]
+          #   The IDs of vaults made available to the session.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, 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>]
+          #
+          # @see OpenAI::Models::Beta::Agents::SessionCreateParams
+          def create_streaming(params)
+            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
+
+            parsed.store(:stream, true)
+            @client.request(
+              method: :post,
+              path: "agents/sessions",
+              headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+              body: parsed,
+              stream: OpenAI::Internal::Stream,
+              model: OpenAI::Beta::AgentSessionEvent,
+              security: {bearer_auth: true},
+              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+            )
+          end
+
+          # Retrieves the current state of a managed agent session. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          #
+          # @overload retrieve(session_id, request_options: {})
+          #
+          # @param session_id [String]
+          #   The ID of the session.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::AgentSession]
+          #
+          # @see OpenAI::Models::Beta::Agents::SessionRetrieveParams
+          def retrieve(session_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["agents/sessions/%1$s", session_id],
+              model: OpenAI::Beta::AgentSession,
+              security: {bearer_auth: true},
+              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+            )
+          end
+
+          # Updates session metadata. Omitted fields are unchanged. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          #
+          # @overload update(session_id, metadata: nil, request_options: {})
+          #
+          # @param session_id [String]
+          #   The ID of the session.
+          #
+          # @param metadata [Hash{Symbol=>String}, nil]
+          #   Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
+          #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+          #   characters.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::AgentSession]
+          #
+          # @see OpenAI::Models::Beta::Agents::SessionUpdateParams
+          def update(session_id, params = {})
+            parsed, options = OpenAI::Beta::Agents::SessionUpdateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["agents/sessions/%1$s", session_id],
+              body: parsed,
+              model: OpenAI::Beta::AgentSession,
+              security: {bearer_auth: true},
+              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+            )
+          end
+
+          # Lists managed agent sessions using ID-based pagination and the requested sort
+          # order. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          #
+          # @overload list(after: nil, agent_id: nil, limit: nil, order: nil, request_options: {})
+          #
+          # @param after [String]
+          #   Return resources after this resource ID in the selected order.
+          #
+          # @param agent_id [String]
+          #   Only return sessions whose root agent has this ID. Omit to return sessions for
+          #   all agents.
+          #
+          # @param limit [Integer, nil]
+          #   The maximum number of resources to return.
+          #
+          # @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
+          #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+          #   `desc` for descending order. Defaults to `desc`.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSession>]
+          #
+          # @see OpenAI::Models::Beta::Agents::SessionListParams
+          def list(params = {})
+            parsed, options = OpenAI::Beta::Agents::SessionListParams.dump_request(params)
+            query = OpenAI::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "agents/sessions",
+              query: query,
+              page: OpenAI::Internal::CursorPage,
+              model: OpenAI::Beta::AgentSession,
+              security: {bearer_auth: true},
+              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+            )
+          end
+
+          # Removes a managed agent session from the public API and returns a deletion
+          # confirmation. Physical cleanup may continue asynchronously. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          #
+          # @overload delete(session_id, request_options: {})
+          #
+          # @param session_id [String]
+          #   The ID of the session.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::AgentSessionDeleted]
+          #
+          # @see OpenAI::Models::Beta::Agents::SessionDeleteParams
+          def delete(session_id, params = {})
+            @client.request(
+              method: :delete,
+              path: ["agents/sessions/%1$s", session_id],
+              model: OpenAI::Beta::AgentSessionDeleted,
+              security: {bearer_auth: true},
+              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+            )
+          end
+
+          # Submit input to an idle session and stream one turn through idle or failure.
+          # The caller must be the session's only input writer during iteration.
+          # Handlers run sequentially; failures submit a generic error without exception text.
+          # Input and each tool result use distinct retry-safe idempotency keys.
+          # A block closes the connection on every exit path without cancelling the turn.
+          #
+          # @param session_id [String]
+          # @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 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: {})
+            stream = OpenAI::Helpers::Agents::SessionStream.new(
+              sessions: self,
+              session_id: session_id,
+              input: input,
+              tool_handlers: tool_handlers,
+              idempotency_key: idempotency_key,
+              request_options: request_options
+            )
+            return stream unless block_given?
+
+            begin
+              yield stream
+            ensure
+              stream.close
+            end
+
+            stream
+          end
+
+          # @api private
+          #
+          # @param client [OpenAI::Client]
+          def initialize(client:)
+            @client = client
+            @subagents = OpenAI::Resources::Beta::Agents::Sessions::Subagents.new(client: client)
+            @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)
+            @turns = OpenAI::Resources::Beta::Agents::Sessions::Turns.new(client: client)
+          end
+        end
+      end
+    end
+  end
+end