openai 0.89.0 → 0.90.0

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

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Artifacts
+            # 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).
+            #
+            # @overload retrieve(artifact_id, session_id:, request_options: {})
+            #
+            # @param artifact_id [String]
+            #   The immutable session artifact ID.
+            #
+            # @param session_id [String]
+            #   The ID of the session that owns the artifact.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Beta::Agents::Sessions::SessionArtifact]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::ArtifactRetrieveParams
+            def retrieve(artifact_id, params)
+              parsed, options = OpenAI::Beta::Agents::Sessions::ArtifactRetrieveParams.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/artifacts/%2$s", session_id, artifact_id],
+                model: OpenAI::Beta::Agents::Sessions::SessionArtifact,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Lists immutable artifacts published by completed hosted session turns. See
+            # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
+            #
+            # @overload list(session_id, after: nil, environment_id: nil, limit: nil, order: nil, request_options: {})
+            #
+            # @param session_id [String]
+            #   The ID of the session.
+            #
+            # @param after [String, nil]
+            #   Return artifacts after this immutable artifact ID.
+            #
+            # @param environment_id [String, nil]
+            #   Restrict the listing to artifacts produced by this environment.
+            #
+            # @param limit [Integer, nil]
+            #   The maximum number of artifacts to return, between 1 and 100.
+            #
+            # @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams::Order]
+            #   Sort by creation time and ID. Defaults to descending.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::Agents::Sessions::SessionArtifact>]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams
+            def list(session_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Sessions::ArtifactListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/artifacts", session_id],
+                query: query,
+                page: OpenAI::Internal::CursorPage,
+                model: OpenAI::Beta::Agents::Sessions::SessionArtifact,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Deletes an immutable session artifact without deleting its live environment file
+            # or original Files API object. See
+            # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
+            #
+            # @overload delete(artifact_id, session_id:, request_options: {})
+            #
+            # @param artifact_id [String]
+            #   The immutable session artifact ID.
+            #
+            # @param session_id [String]
+            #   The ID of the session that owns the artifact.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Beta::Agents::Sessions::SessionArtifactDeleted]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::ArtifactDeleteParams
+            def delete(artifact_id, params)
+              parsed, options = OpenAI::Beta::Agents::Sessions::ArtifactDeleteParams.dump_request(params)
+              session_id = parsed.delete(:session_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+
+              @client.request(
+                method: :delete,
+                path: ["agents/sessions/%1$s/artifacts/%2$s", session_id, artifact_id],
+                model: OpenAI::Beta::Agents::Sessions::SessionArtifactDeleted,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Downloads immutable session artifact bytes after the execution environment
+            # expires. See
+            # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
+            #
+            # @overload content(artifact_id, session_id:, request_options: {})
+            #
+            # @param artifact_id [String]
+            #   The immutable session artifact ID.
+            #
+            # @param session_id [String]
+            #   The ID of the session that owns the artifact.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [StringIO]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::ArtifactContentParams
+            def content(artifact_id, params)
+              parsed, options = OpenAI::Beta::Agents::Sessions::ArtifactContentParams.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/artifacts/%2$s/content", session_id, artifact_id],
+                headers: {"accept" => "application/octet-stream"},
+                model: StringIO,
+                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/events.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Events
+            # Submits message, cancellation, or tool-result events to a managed agent session.
+            # See
+            # [session events](https://developers.openai.com/api/docs/guides/agents-api/sessions/events).
+            #
+            # @overload create(session_id, events:, idempotency_key: nil, request_options: {})
+            #
+            # @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>]
+            #   Body param: The input events to submit to the session.
+            #
+            # @param idempotency_key [String]
+            #   Header param: An optional client-generated key that makes retries of submitted
+            #   messages idempotent.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [nil]
+            #
+            # @see OpenAI::Models::Beta::Agents::Sessions::EventCreateParams
+            def create(session_id, params)
+              parsed, options = OpenAI::Beta::Agents::Sessions::EventCreateParams.dump_request(params)
+              header_params = {idempotency_key: "idempotency-key"}
+              @client.request(
+                method: :post,
+                path: ["agents/sessions/%1$s/events", session_id],
+                headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+                body: parsed.except(*header_params.keys),
+                model: NilClass,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+              )
+            end
+
+            # Streams live events for an agent session. See
+            # [session events](https://developers.openai.com/api/docs/guides/agents-api/sessions/events).
+            #
+            # @overload stream_streaming(session_id, request_options: {})
+            #
+            # @param session_id [String]
+            #   The ID of 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::Sessions::EventStreamParams
+            def stream_streaming(session_id, params = {})
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/events", session_id],
+                headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+                stream: OpenAI::Internal::Stream,
+                model: OpenAI::Beta::AgentSessionEvent,
+                security: {bearer_auth: true},
+                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+              )
+            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/items.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Items
+            # Lists items produced by the session's root agent, including its interactions
+            # with subagents. Each subagent has its own item history. See
+            # [inspecting agent output](https://developers.openai.com/api/docs/guides/agents-api/observability).
+            #
+            # @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::ItemListParams::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::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::ItemListParams
+            def list(session_id, params = {})
+              parsed, options = OpenAI::Beta::Agents::Sessions::ItemListParams.dump_request(params)
+              query = OpenAI::Internal::Util.encode_query_params(parsed)
+              @client.request(
+                method: :get,
+                path: ["agents/sessions/%1$s/items", session_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

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

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Subagents
+            class Items
+              # Lists this subagent's own items across all of its turns. 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::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::ItemListParams
+              def list(subagent_id, params)
+                parsed, options = OpenAI::Beta::Agents::Sessions::Subagents::ItemListParams.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/items", session_id, subagent_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

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