openai 0.3.0 → 0.4.1

data/lib/openai/resources/fine_tuning/jobs.rb

@@ -0,0 +1,221 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class FineTuning
+      class Jobs
+        # @return [OpenAI::Resources::FineTuning::Jobs::Checkpoints]
+        attr_reader :checkpoints
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobCreateParams} for more details.
+        #
+        # Creates a fine-tuning job which begins the process of creating a new model from
+        # a given dataset.
+        #
+        # Response includes details of the enqueued job including job status and the name
+        # of the fine-tuned models once complete.
+        #
+        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/fine-tuning)
+        #
+        # @overload create(model:, training_file:, hyperparameters: nil, integrations: nil, metadata: nil, method_: nil, seed: nil, suffix: nil, validation_file: nil, request_options: {})
+        #
+        # @param model [String, Symbol, OpenAI::Models::FineTuning::JobCreateParams::Model] The name of the model to fine-tune. You can select one of the
+        #
+        # @param training_file [String] The ID of an uploaded file that contains training data.
+        #
+        # @param hyperparameters [OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters] The hyperparameters used for the fine-tuning job.
+        #
+        # @param integrations [Array<OpenAI::Models::FineTuning::JobCreateParams::Integration>, nil] A list of integrations to enable for your fine-tuning job.
+        #
+        # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #
+        # @param method_ [OpenAI::Models::FineTuning::JobCreateParams::Method] The method used for fine-tuning.
+        #
+        # @param seed [Integer, nil] The seed controls the reproducibility of the job. Passing in the same seed and j
+        #
+        # @param suffix [String, nil] A string of up to 64 characters that will be added to your fine-tuned model name
+        #
+        # @param validation_file [String, nil] The ID of an uploaded file that contains validation data.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::FineTuning::FineTuningJob]
+        #
+        # @see OpenAI::Models::FineTuning::JobCreateParams
+        def create(params)
+          parsed, options = OpenAI::FineTuning::JobCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "fine_tuning/jobs",
+            body: parsed,
+            model: OpenAI::FineTuning::FineTuningJob,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobRetrieveParams} for more details.
+        #
+        # Get info about a fine-tuning job.
+        #
+        # [Learn more about fine-tuning](https://platform.openai.com/docs/guides/fine-tuning)
+        #
+        # @overload retrieve(fine_tuning_job_id, request_options: {})
+        #
+        # @param fine_tuning_job_id [String] The ID of the fine-tuning job.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::FineTuning::FineTuningJob]
+        #
+        # @see OpenAI::Models::FineTuning::JobRetrieveParams
+        def retrieve(fine_tuning_job_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["fine_tuning/jobs/%1$s", fine_tuning_job_id],
+            model: OpenAI::FineTuning::FineTuningJob,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobListParams} for more details.
+        #
+        # List your organization's fine-tuning jobs
+        #
+        # @overload list(after: nil, limit: nil, metadata: nil, request_options: {})
+        #
+        # @param after [String] Identifier for the last job from the previous pagination request.
+        #
+        # @param limit [Integer] Number of fine-tuning jobs to retrieve.
+        #
+        # @param metadata [Hash{Symbol=>String}, nil] Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Alternative
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Internal::CursorPage<OpenAI::Models::FineTuning::FineTuningJob>]
+        #
+        # @see OpenAI::Models::FineTuning::JobListParams
+        def list(params = {})
+          parsed, options = OpenAI::FineTuning::JobListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: "fine_tuning/jobs",
+            query: parsed,
+            page: OpenAI::Internal::CursorPage,
+            model: OpenAI::FineTuning::FineTuningJob,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobCancelParams} for more details.
+        #
+        # Immediately cancel a fine-tune job.
+        #
+        # @overload cancel(fine_tuning_job_id, request_options: {})
+        #
+        # @param fine_tuning_job_id [String] The ID of the fine-tuning job to cancel.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::FineTuning::FineTuningJob]
+        #
+        # @see OpenAI::Models::FineTuning::JobCancelParams
+        def cancel(fine_tuning_job_id, params = {})
+          @client.request(
+            method: :post,
+            path: ["fine_tuning/jobs/%1$s/cancel", fine_tuning_job_id],
+            model: OpenAI::FineTuning::FineTuningJob,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobListEventsParams} for more details.
+        #
+        # Get status updates for a fine-tuning job.
+        #
+        # @overload list_events(fine_tuning_job_id, after: nil, limit: nil, request_options: {})
+        #
+        # @param fine_tuning_job_id [String] The ID of the fine-tuning job to get events for.
+        #
+        # @param after [String] Identifier for the last event from the previous pagination request.
+        #
+        # @param limit [Integer] Number of events to retrieve.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Internal::CursorPage<OpenAI::Models::FineTuning::FineTuningJobEvent>]
+        #
+        # @see OpenAI::Models::FineTuning::JobListEventsParams
+        def list_events(fine_tuning_job_id, params = {})
+          parsed, options = OpenAI::FineTuning::JobListEventsParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["fine_tuning/jobs/%1$s/events", fine_tuning_job_id],
+            query: parsed,
+            page: OpenAI::Internal::CursorPage,
+            model: OpenAI::FineTuning::FineTuningJobEvent,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobPauseParams} for more details.
+        #
+        # Pause a fine-tune job.
+        #
+        # @overload pause(fine_tuning_job_id, request_options: {})
+        #
+        # @param fine_tuning_job_id [String] The ID of the fine-tuning job to pause.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::FineTuning::FineTuningJob]
+        #
+        # @see OpenAI::Models::FineTuning::JobPauseParams
+        def pause(fine_tuning_job_id, params = {})
+          @client.request(
+            method: :post,
+            path: ["fine_tuning/jobs/%1$s/pause", fine_tuning_job_id],
+            model: OpenAI::FineTuning::FineTuningJob,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::FineTuning::JobResumeParams} for more details.
+        #
+        # Resume a fine-tune job.
+        #
+        # @overload resume(fine_tuning_job_id, request_options: {})
+        #
+        # @param fine_tuning_job_id [String] The ID of the fine-tuning job to resume.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::FineTuning::FineTuningJob]
+        #
+        # @see OpenAI::Models::FineTuning::JobResumeParams
+        def resume(fine_tuning_job_id, params = {})
+          @client.request(
+            method: :post,
+            path: ["fine_tuning/jobs/%1$s/resume", fine_tuning_job_id],
+            model: OpenAI::FineTuning::FineTuningJob,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+          @checkpoints = OpenAI::Resources::FineTuning::Jobs::Checkpoints.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/fine_tuning/methods.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class FineTuning
+      class Methods
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/fine_tuning.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class FineTuning
+      # @return [OpenAI::Resources::FineTuning::Methods]
+      attr_reader :methods_
+
+      # @return [OpenAI::Resources::FineTuning::Jobs]
+      attr_reader :jobs
+
+      # @return [OpenAI::Resources::FineTuning::Checkpoints]
+      attr_reader :checkpoints
+
+      # @return [OpenAI::Resources::FineTuning::Alpha]
+      attr_reader :alpha
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+        @methods_ = OpenAI::Resources::FineTuning::Methods.new(client: client)
+        @jobs = OpenAI::Resources::FineTuning::Jobs.new(client: client)
+        @checkpoints = OpenAI::Resources::FineTuning::Checkpoints.new(client: client)
+        @alpha = OpenAI::Resources::FineTuning::Alpha.new(client: client)
+      end
+    end
+  end
+end

data/lib/openai/resources/graders/grader_models.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Graders
+      class GraderModels
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/graders.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Graders
+      # @return [OpenAI::Resources::Graders::GraderModels]
+      attr_reader :grader_models
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+        @grader_models = OpenAI::Resources::Graders::GraderModels.new(client: client)
+      end
+    end
+  end
+end

data/lib/openai/resources/images.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Images
+      # Some parameter documentations has been truncated, see
+      # {OpenAI::Models::ImageCreateVariationParams} for more details.
+      #
+      # Creates a variation of a given image. This endpoint only supports `dall-e-2`.
+      #
+      # @overload create_variation(image:, model: nil, n: nil, response_format: nil, size: nil, user: nil, request_options: {})
+      #
+      # @param image [Pathname, StringIO, IO, String, OpenAI::FilePart] The image to use as the basis for the variation(s). Must be a valid PNG file, le
+      #
+      # @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. Only `dall-e-2` is supported at this time
+      #
+      # @param n [Integer, nil] The number of images to generate. Must be between 1 and 10.
+      #
+      # @param response_format [Symbol, OpenAI::Models::ImageCreateVariationParams::ResponseFormat, nil] The format in which the generated images are returned. Must be one of `url` or `
+      #
+      # @param size [Symbol, OpenAI::Models::ImageCreateVariationParams::Size, nil] The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x
+      #
+      # @param user [String] A unique identifier representing your end-user, which can help OpenAI to monitor
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::ImagesResponse]
+      #
+      # @see OpenAI::Models::ImageCreateVariationParams
+      def create_variation(params)
+        parsed, options = OpenAI::ImageCreateVariationParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "images/variations",
+          headers: {"content-type" => "multipart/form-data"},
+          body: parsed,
+          model: OpenAI::ImagesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {OpenAI::Models::ImageEditParams} for more details.
+      #
+      # Creates an edited or extended image given one or more source images and a
+      # prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
+      #
+      # @overload edit(image:, prompt:, background: nil, mask: nil, model: nil, n: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
+      #
+      # @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>] The image(s) to edit. Must be a supported image file or an array of images.
+      #
+      # @param prompt [String] A text description of the desired image(s). The maximum length is 1000 character
+      #
+      # @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil] Allows to set transparency for the background of the generated image(s).
+      #
+      # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart] An additional image whose fully transparent areas (e.g. where alpha is zero) ind
+      #
+      # @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. Only `dall-e-2` and `gpt-image-1` are sup
+      #
+      # @param n [Integer, nil] The number of images to generate. Must be between 1 and 10.
+      #
+      # @param quality [Symbol, OpenAI::Models::ImageEditParams::Quality, nil] The quality of the image that will be generated. `high`, `medium` and `low` are
+      #
+      # @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil] The format in which the generated images are returned. Must be one of `url` or `
+      #
+      # @param size [Symbol, OpenAI::Models::ImageEditParams::Size, nil] The size of the generated images. Must be one of `1024x1024`, `1536x1024` (lands
+      #
+      # @param user [String] A unique identifier representing your end-user, which can help OpenAI to monitor
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::ImagesResponse]
+      #
+      # @see OpenAI::Models::ImageEditParams
+      def edit(params)
+        parsed, options = OpenAI::ImageEditParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "images/edits",
+          headers: {"content-type" => "multipart/form-data"},
+          body: parsed,
+          model: OpenAI::ImagesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {OpenAI::Models::ImageGenerateParams} for more details.
+      #
+      # Creates an image given a prompt.
+      # [Learn more](https://platform.openai.com/docs/guides/images).
+      #
+      # @overload generate(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      #
+      # @param prompt [String] A text description of the desired image(s). The maximum length is 32000 characte
+      #
+      # @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil] Allows to set transparency for the background of the generated image(s).
+      #
+      # @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or `gpt-im
+      #
+      # @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil] Control the content-moderation level for images generated by `gpt-image-1`. Must
+      #
+      # @param n [Integer, nil] The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
+      #
+      # @param output_compression [Integer, nil] The compression level (0-100%) for the generated images. This parameter is only
+      #
+      # @param output_format [Symbol, OpenAI::Models::ImageGenerateParams::OutputFormat, nil] The format in which the generated images are returned. This parameter is only su
+      #
+      # @param quality [Symbol, OpenAI::Models::ImageGenerateParams::Quality, nil] The quality of the image that will be generated.
+      #
+      # @param response_format [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil] The format in which generated images with `dall-e-2` and `dall-e-3` are returned
+      #
+      # @param size [Symbol, OpenAI::Models::ImageGenerateParams::Size, nil] The size of the generated images. Must be one of `1024x1024`, `1536x1024` (lands
+      #
+      # @param style [Symbol, OpenAI::Models::ImageGenerateParams::Style, nil] The style of the generated images. This parameter is only supported for `dall-e-
+      #
+      # @param user [String] A unique identifier representing your end-user, which can help OpenAI to monitor
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::ImagesResponse]
+      #
+      # @see OpenAI::Models::ImageGenerateParams
+      def generate(params)
+        parsed, options = OpenAI::ImageGenerateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "images/generations",
+          body: parsed,
+          model: OpenAI::ImagesResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/openai/resources/models.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Models
+      # Retrieves a model instance, providing basic information about the model such as
+      # the owner and permissioning.
+      #
+      # @overload retrieve(model, request_options: {})
+      #
+      # @param model [String] The ID of the model to use for this request
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::Model]
+      #
+      # @see OpenAI::Models::ModelRetrieveParams
+      def retrieve(model, params = {})
+        @client.request(
+          method: :get,
+          path: ["models/%1$s", model],
+          model: OpenAI::Model,
+          options: params[:request_options]
+        )
+      end
+
+      # Lists the currently available models, and provides basic information about each
+      # one such as the owner and availability.
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Internal::Page<OpenAI::Models::Model>]
+      #
+      # @see OpenAI::Models::ModelListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "models",
+          page: OpenAI::Internal::Page,
+          model: OpenAI::Model,
+          options: params[:request_options]
+        )
+      end
+
+      # Delete a fine-tuned model. You must have the Owner role in your organization to
+      # delete a model.
+      #
+      # @overload delete(model, request_options: {})
+      #
+      # @param model [String] The model to delete
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::ModelDeleted]
+      #
+      # @see OpenAI::Models::ModelDeleteParams
+      def delete(model, params = {})
+        @client.request(
+          method: :delete,
+          path: ["models/%1$s", model],
+          model: OpenAI::ModelDeleted,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/openai/resources/moderations.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Moderations
+      # Some parameter documentations has been truncated, see
+      # {OpenAI::Models::ModerationCreateParams} for more details.
+      #
+      # Classifies if text and/or image inputs are potentially harmful. Learn more in
+      # the [moderation guide](https://platform.openai.com/docs/guides/moderation).
+      #
+      # @overload create(input:, model: nil, request_options: {})
+      #
+      # @param input [String, Array<String>, Array<OpenAI::Models::ModerationImageURLInput, OpenAI::Models::ModerationTextInput>] Input (or inputs) to classify. Can be a single string, an array of strings, or
+      #
+      # @param model [String, Symbol, OpenAI::Models::ModerationModel] The content moderation model you would like to use. Learn more in
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::ModerationCreateResponse]
+      #
+      # @see OpenAI::Models::ModerationCreateParams
+      def create(params)
+        parsed, options = OpenAI::ModerationCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "moderations",
+          body: parsed,
+          model: OpenAI::Models::ModerationCreateResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Responses
+      class InputItems
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::Responses::InputItemListParams} for more details.
+        #
+        # Returns a list of input items for a given response.
+        #
+        # @overload list(response_id, after: nil, before: nil, include: nil, limit: nil, order: nil, request_options: {})
+        #
+        # @param response_id [String] The ID of the response to retrieve input items for.
+        #
+        # @param after [String] An item ID to list items after, used in pagination.
+        #
+        # @param before [String] An item ID to list items before, used in pagination.
+        #
+        # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Additional fields to include in the response. See the `include`
+        #
+        # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between
+        #
+        # @param order [Symbol, OpenAI::Models::Responses::InputItemListParams::Order] The order to return the input items in. Default is `desc`.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Responses::ResponseInputMessageItem, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseItem::LocalShellCall, OpenAI::Models::Responses::ResponseItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseItem::McpListTools, OpenAI::Models::Responses::ResponseItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseItem::McpCall>]
+        #
+        # @see OpenAI::Models::Responses::InputItemListParams
+        def list(response_id, params = {})
+          parsed, options = OpenAI::Responses::InputItemListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["responses/%1$s/input_items", response_id],
+            query: parsed,
+            page: OpenAI::Internal::CursorPage,
+            model: OpenAI::Responses::ResponseItem,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end