openai 0.46.0 → 0.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 319786b20e6239f01ec9d26047bae8fa9259e141f95baa7d24b22ff3b417aac8
-  data.tar.gz: 85a7e695dedbad2fbdc305dc2ee5e1843ef3793fcf50d2bfe3efd6be294cfa37
+  metadata.gz: 2e87f93df3497e32ada353e5de4be401dbbf9c79bd381d65e8429ecda93b1705
+  data.tar.gz: eb59d4b99289d74e75f3d09fb4236b8a385981554e61b20fb2011aa07b145fb5
 SHA512:
-  metadata.gz: bcf2cc4be6392d80121ff4371946fb56e255dbb6f75564251690db6f825155e35cafe7fbfd91f5937e275a458cd8bd8641b92b5c05ccbd242bbc9720b7cd01f3
-  data.tar.gz: 8d0417477c03208b215fb0ddb36947d73a6e25bd55243c2a137a09437920b52c814e22f5ea78113c42b59426bf5d929cdbfd03a3d5d4554ff8c698fd87b463d9
+  metadata.gz: 60aab96792238b95f55b3ac9057340c9455484dbbecf98464859994a3acb8f3d5d4f6553fbc5c96946e4e75e7d9801a011b5fad2620d7c0c78c7c3033c1d2a2a
+  data.tar.gz: 16a48a83c5950a2efe7fe1c9c5b39c34902e05ac838b1cbf047515677bcf77688153f30fec96fbe885c980b6058438cd35bb9699a7a6efd7ec71e9b61f05c162

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.47.0 (2026-02-10)
+
+Full Changelog: [v0.46.0...v0.47.0](https://github.com/openai/openai-ruby/compare/v0.46.0...v0.47.0)
+
+### Features
+
+* **api:** skills and hosted shell ([cf841cd](https://github.com/openai/openai-ruby/commit/cf841cd617c13c2800d2d71afe9e4ef04f18e5e5))
+
 ## 0.46.0 (2026-02-08)
 
 Full Changelog: [v0.45.0...v0.46.0](https://github.com/openai/openai-ruby/compare/v0.45.0...v0.46.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.46.0"
+gem "openai", "~> 0.47.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/client.rb

@@ -87,6 +87,9 @@ module OpenAI
     # @return [OpenAI::Resources::Containers]
     attr_reader :containers
 
+    # @return [OpenAI::Resources::Skills]
+    attr_reader :skills
+
     # @return [OpenAI::Resources::Videos]
     attr_reader :videos
 
@@ -173,6 +176,7 @@ module OpenAI
       @conversations = OpenAI::Resources::Conversations.new(client: self)
       @evals = OpenAI::Resources::Evals.new(client: self)
       @containers = OpenAI::Resources::Containers.new(client: self)
+      @skills = OpenAI::Resources::Skills.new(client: self)
       @videos = OpenAI::Resources::Videos.new(client: self)
     end
   end

data/lib/openai/models/deleted_skill.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Skills#delete
+    class DeletedSkill < OpenAI::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute deleted
+      #
+      #   @return [Boolean]
+      required :deleted, OpenAI::Internal::Type::Boolean
+
+      # @!attribute object
+      #
+      #   @return [Symbol, :"skill.deleted"]
+      required :object, const: :"skill.deleted"
+
+      # @!method initialize(id:, deleted:, object: :"skill.deleted")
+      #   @param id [String]
+      #   @param deleted [Boolean]
+      #   @param object [Symbol, :"skill.deleted"]
+    end
+  end
+end

data/lib/openai/models/image_edit_params.rb

@@ -14,7 +14,8 @@ module OpenAI
       #
       #   For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, and
       #   `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-      #   50MB. You can provide up to 16 images.
+      #   50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
+      #   input constraints as GPT image models.
       #
       #   For `dall-e-2`, you can only provide one image, and it should be a square `png`
       #   file less than 4MB.
@@ -60,9 +61,7 @@ module OpenAI
       optional :mask, OpenAI::Internal::Type::FileInput
 
       # @!attribute model
-      #   The model to use for image generation. Only `dall-e-2` and the GPT image models
-      #   are supported. Defaults to `dall-e-2` unless a parameter specific to the GPT
-      #   image models is used.
+      #   The model to use for image generation. Defaults to `gpt-image-1.5`.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageEditParams::Model }, nil?: true
@@ -101,9 +100,8 @@ module OpenAI
       optional :partial_images, Integer, nil?: true
 
       # @!attribute quality
-      #   The quality of the image that will be generated. `high`, `medium` and `low` are
-      #   only supported for the GPT image models. `dall-e-2` only supports `standard`
-      #   quality. Defaults to `auto`.
+      #   The quality of the image that will be generated for GPT image models. Defaults
+      #   to `auto`.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::Quality, nil]
       optional :quality, enum: -> { OpenAI::ImageEditParams::Quality }, nil?: true
@@ -111,8 +109,8 @@ module OpenAI
       # @!attribute response_format
       #   The format in which the generated images are returned. Must be one of `url` or
       #   `b64_json`. URLs are only valid for 60 minutes after the image has been
-      #   generated. This parameter is only supported for `dall-e-2`, as the GPT image
-      #   models always return base64-encoded images.
+      #   generated. This parameter is only supported for `dall-e-2` (default is `url` for
+      #   `dall-e-2`), as GPT image models always return base64-encoded images.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
       optional :response_format, enum: -> { OpenAI::ImageEditParams::ResponseFormat }, nil?: true
@@ -147,7 +145,7 @@ module OpenAI
       #
       #   @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 the GPT image models
+      #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. Defaults to `gpt-image-1.5`.
       #
       #   @param n [Integer, nil] The number of images to generate. Must be between 1 and 10.
       #
@@ -157,7 +155,7 @@ module OpenAI
       #
       #   @param partial_images [Integer, nil] The number of partial images to generate. This parameter is used for
       #
-      #   @param quality [Symbol, OpenAI::Models::ImageEditParams::Quality, nil] The quality of the image that will be generated. `high`, `medium` and `low` are
+      #   @param quality [Symbol, OpenAI::Models::ImageEditParams::Quality, nil] The quality of the image that will be generated for GPT image models. Defaults t
       #
       #   @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil] The format in which the generated images are returned. Must be one of `url` or `
       #
@@ -171,7 +169,8 @@ module OpenAI
       #
       # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, and
       # `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-      # 50MB. You can provide up to 16 images.
+      # 50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
+      # input constraints as GPT image models.
       #
       # For `dall-e-2`, you can only provide one image, and it should be a square `png`
       # file less than 4MB.
@@ -221,15 +220,13 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The model to use for image generation. Only `dall-e-2` and the GPT image models
-      # are supported. Defaults to `dall-e-2` unless a parameter specific to the GPT
-      # image models is used.
+      # The model to use for image generation. Defaults to `gpt-image-1.5`.
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        # The model to use for image generation. Only `dall-e-2` and the GPT image models are supported. Defaults to `dall-e-2` unless a parameter specific to the GPT image models is used.
+        # The model to use for image generation. Defaults to `gpt-image-1.5`.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants
@@ -250,9 +247,8 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The quality of the image that will be generated. `high`, `medium` and `low` are
-      # only supported for the GPT image models. `dall-e-2` only supports `standard`
-      # quality. Defaults to `auto`.
+      # The quality of the image that will be generated for GPT image models. Defaults
+      # to `auto`.
       module Quality
         extend OpenAI::Internal::Type::Enum
 
@@ -268,8 +264,8 @@ module OpenAI
 
       # The format in which the generated images are returned. Must be one of `url` or
       # `b64_json`. URLs are only valid for 60 minutes after the image has been
-      # generated. This parameter is only supported for `dall-e-2`, as the GPT image
-      # models always return base64-encoded images.
+      # generated. This parameter is only supported for `dall-e-2` (default is `url` for
+      # `dall-e-2`), as GPT image models always return base64-encoded images.
       module ResponseFormat
         extend OpenAI::Internal::Type::Enum
 

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

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ContainerAuto < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   Automatically creates a container for this request
+        #
+        #   @return [Symbol, :container_auto]
+        required :type, const: :container_auto
+
+        # @!attribute file_ids
+        #   An optional list of uploaded files to make available to your code.
+        #
+        #   @return [Array<String>, nil]
+        optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
+
+        # @!attribute memory_limit
+        #   The memory limit for the container.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ContainerAuto::MemoryLimit, nil]
+        optional :memory_limit, enum: -> { OpenAI::Responses::ContainerAuto::MemoryLimit }, nil?: true
+
+        # @!attribute network_policy
+        #   Network access policy for the container.
+        #
+        #   @return [OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist, nil]
+        optional :network_policy, union: -> { OpenAI::Responses::ContainerAuto::NetworkPolicy }
+
+        # @!attribute skills
+        #   An optional list of skills referenced by id or inline data.
+        #
+        #   @return [Array<OpenAI::Models::Responses::SkillReference, OpenAI::Models::Responses::InlineSkill>, nil]
+        optional :skills, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ContainerAuto::Skill] }
+
+        # @!method initialize(file_ids: nil, memory_limit: nil, network_policy: nil, skills: nil, type: :container_auto)
+        #   @param file_ids [Array<String>] An optional list of uploaded files to make available to your code.
+        #
+        #   @param memory_limit [Symbol, OpenAI::Models::Responses::ContainerAuto::MemoryLimit, nil] The memory limit for the container.
+        #
+        #   @param network_policy [OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist] Network access policy for the container.
+        #
+        #   @param skills [Array<OpenAI::Models::Responses::SkillReference, OpenAI::Models::Responses::InlineSkill>] An optional list of skills referenced by id or inline data.
+        #
+        #   @param type [Symbol, :container_auto] Automatically creates a container for this request
+
+        # The memory limit for the container.
+        #
+        # @see OpenAI::Models::Responses::ContainerAuto#memory_limit
+        module MemoryLimit
+          extend OpenAI::Internal::Type::Enum
+
+          MEMORY_LIMIT_1G = :"1g"
+          MEMORY_LIMIT_4G = :"4g"
+          MEMORY_LIMIT_16G = :"16g"
+          MEMORY_LIMIT_64G = :"64g"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Network access policy for the container.
+        #
+        # @see OpenAI::Models::Responses::ContainerAuto#network_policy
+        module NetworkPolicy
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :disabled, -> { OpenAI::Responses::ContainerNetworkPolicyDisabled }
+
+          variant :allowlist, -> { OpenAI::Responses::ContainerNetworkPolicyAllowlist }
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist)]
+        end
+
+        module Skill
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :skill_reference, -> { OpenAI::Responses::SkillReference }
+
+          variant :inline, -> { OpenAI::Responses::InlineSkill }
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::SkillReference, OpenAI::Models::Responses::InlineSkill)]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ContainerNetworkPolicyAllowlist < OpenAI::Internal::Type::BaseModel
+        # @!attribute allowed_domains
+        #   A list of allowed domains when type is `allowlist`.
+        #
+        #   @return [Array<String>]
+        required :allowed_domains, OpenAI::Internal::Type::ArrayOf[String]
+
+        # @!attribute type
+        #   Allow outbound network access only to specified domains. Always `allowlist`.
+        #
+        #   @return [Symbol, :allowlist]
+        required :type, const: :allowlist
+
+        # @!attribute domain_secrets
+        #   Optional domain-scoped secrets for allowlisted domains.
+        #
+        #   @return [Array<OpenAI::Models::Responses::ContainerNetworkPolicyDomainSecret>, nil]
+        optional :domain_secrets,
+                 -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ContainerNetworkPolicyDomainSecret] }
+
+        # @!method initialize(allowed_domains:, domain_secrets: nil, type: :allowlist)
+        #   @param allowed_domains [Array<String>] A list of allowed domains when type is `allowlist`.
+        #
+        #   @param domain_secrets [Array<OpenAI::Models::Responses::ContainerNetworkPolicyDomainSecret>] Optional domain-scoped secrets for allowlisted domains.
+        #
+        #   @param type [Symbol, :allowlist] Allow outbound network access only to specified domains. Always `allowlist`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ContainerNetworkPolicyDisabled < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   Disable outbound network access. Always `disabled`.
+        #
+        #   @return [Symbol, :disabled]
+        required :type, const: :disabled
+
+        # @!method initialize(type: :disabled)
+        #   @param type [Symbol, :disabled] Disable outbound network access. Always `disabled`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ContainerNetworkPolicyDomainSecret < OpenAI::Internal::Type::BaseModel
+        # @!attribute domain
+        #   The domain associated with the secret.
+        #
+        #   @return [String]
+        required :domain, String
+
+        # @!attribute name
+        #   The name of the secret to inject for the domain.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute value
+        #   The secret value to inject for the domain.
+        #
+        #   @return [String]
+        required :value, String
+
+        # @!method initialize(domain:, name:, value:)
+        #   @param domain [String] The domain associated with the secret.
+        #
+        #   @param name [String] The name of the secret to inject for the domain.
+        #
+        #   @param value [String] The secret value to inject for the domain.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ContainerReference < OpenAI::Internal::Type::BaseModel
+        # @!attribute container_id
+        #   The ID of the referenced container.
+        #
+        #   @return [String]
+        required :container_id, String
+
+        # @!attribute type
+        #   References a container created with the /v1/containers endpoint
+        #
+        #   @return [Symbol, :container_reference]
+        required :type, const: :container_reference
+
+        # @!method initialize(container_id:, type: :container_reference)
+        #   @param container_id [String] The ID of the referenced container.
+        #
+        #   @param type [Symbol, :container_reference] References a container created with the /v1/containers endpoint
+      end
+    end
+  end
+end

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

@@ -10,10 +10,33 @@ module OpenAI
         #   @return [Symbol, :shell]
         required :type, const: :shell
 
-        # @!method initialize(type: :shell)
+        # @!attribute environment
+        #
+        #   @return [OpenAI::Models::Responses::ContainerAuto, OpenAI::Models::Responses::LocalEnvironment, OpenAI::Models::Responses::ContainerReference, nil]
+        optional :environment, union: -> { OpenAI::Responses::FunctionShellTool::Environment }, nil?: true
+
+        # @!method initialize(environment: nil, type: :shell)
         #   A tool that allows the model to execute shell commands.
         #
+        #   @param environment [OpenAI::Models::Responses::ContainerAuto, OpenAI::Models::Responses::LocalEnvironment, OpenAI::Models::Responses::ContainerReference, nil]
+        #
         #   @param type [Symbol, :shell] The type of the shell tool. Always `shell`.
+
+        # @see OpenAI::Models::Responses::FunctionShellTool#environment
+        module Environment
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :container_auto, -> { OpenAI::Responses::ContainerAuto }
+
+          variant :local, -> { OpenAI::Responses::LocalEnvironment }
+
+          variant :container_reference, -> { OpenAI::Responses::ContainerReference }
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::ContainerAuto, OpenAI::Models::Responses::LocalEnvironment, OpenAI::Models::Responses::ContainerReference)]
+        end
       end
     end
   end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class InlineSkill < OpenAI::Internal::Type::BaseModel
+        # @!attribute description
+        #   The description of the skill.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute name
+        #   The name of the skill.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute source
+        #   Inline skill payload
+        #
+        #   @return [OpenAI::Models::Responses::InlineSkillSource]
+        required :source, -> { OpenAI::Responses::InlineSkillSource }
+
+        # @!attribute type
+        #   Defines an inline skill for this request.
+        #
+        #   @return [Symbol, :inline]
+        required :type, const: :inline
+
+        # @!method initialize(description:, name:, source:, type: :inline)
+        #   @param description [String] The description of the skill.
+        #
+        #   @param name [String] The name of the skill.
+        #
+        #   @param source [OpenAI::Models::Responses::InlineSkillSource] Inline skill payload
+        #
+        #   @param type [Symbol, :inline] Defines an inline skill for this request.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class InlineSkillSource < OpenAI::Internal::Type::BaseModel
+        # @!attribute data
+        #   Base64-encoded skill zip bundle.
+        #
+        #   @return [String]
+        required :data, String
+
+        # @!attribute media_type
+        #   The media type of the inline skill payload. Must be `application/zip`.
+        #
+        #   @return [Symbol, :"application/zip"]
+        required :media_type, const: :"application/zip"
+
+        # @!attribute type
+        #   The type of the inline skill source. Must be `base64`.
+        #
+        #   @return [Symbol, :base64]
+        required :type, const: :base64
+
+        # @!method initialize(data:, media_type: :"application/zip", type: :base64)
+        #   Inline skill payload
+        #
+        #   @param data [String] Base64-encoded skill zip bundle.
+        #
+        #   @param media_type [Symbol, :"application/zip"] The media type of the inline skill payload. Must be `application/zip`.
+        #
+        #   @param type [Symbol, :base64] The type of the inline skill source. Must be `base64`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class LocalEnvironment < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   Use a local computer environment.
+        #
+        #   @return [Symbol, :local]
+        required :type, const: :local
+
+        # @!attribute skills
+        #   An optional list of skills.
+        #
+        #   @return [Array<OpenAI::Models::Responses::LocalSkill>, nil]
+        optional :skills, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::LocalSkill] }
+
+        # @!method initialize(skills: nil, type: :local)
+        #   @param skills [Array<OpenAI::Models::Responses::LocalSkill>] An optional list of skills.
+        #
+        #   @param type [Symbol, :local] Use a local computer environment.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class LocalSkill < OpenAI::Internal::Type::BaseModel
+        # @!attribute description
+        #   The description of the skill.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute name
+        #   The name of the skill.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute path
+        #   The path to the directory containing the skill.
+        #
+        #   @return [String]
+        required :path, String
+
+        # @!method initialize(description:, name:, path:)
+        #   @param description [String] The description of the skill.
+        #
+        #   @param name [String] The name of the skill.
+        #
+        #   @param path [String] The path to the directory containing the skill.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseContainerReference < OpenAI::Internal::Type::BaseModel
+        # @!attribute container_id
+        #
+        #   @return [String]
+        required :container_id, String
+
+        # @!attribute type
+        #   The environment type. Always `container_reference`.
+        #
+        #   @return [Symbol, :container_reference]
+        required :type, const: :container_reference
+
+        # @!method initialize(container_id:, type: :container_reference)
+        #   Represents a container created with /v1/containers.
+        #
+        #   @param container_id [String]
+        #
+        #   @param type [Symbol, :container_reference] The environment type. Always `container_reference`.
+      end
+    end
+  end
+end

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

@@ -23,6 +23,14 @@ module OpenAI
         #   @return [String]
         required :call_id, String
 
+        # @!attribute environment
+        #   Represents the use of a local environment to perform shell actions.
+        #
+        #   @return [OpenAI::Models::Responses::ResponseLocalEnvironment, OpenAI::Models::Responses::ResponseContainerReference, nil]
+        required :environment,
+                 union: -> { OpenAI::Responses::ResponseFunctionShellToolCall::Environment },
+                 nil?: true
+
         # @!attribute status
         #   The status of the shell call. One of `in_progress`, `completed`, or
         #   `incomplete`.
@@ -42,7 +50,7 @@ module OpenAI
         #   @return [String, nil]
         optional :created_by, String
 
-        # @!method initialize(id:, action:, call_id:, status:, created_by: nil, type: :shell_call)
+        # @!method initialize(id:, action:, call_id:, environment:, status:, created_by: nil, type: :shell_call)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseFunctionShellToolCall} for more details.
         #
@@ -54,6 +62,8 @@ module OpenAI
         #
         #   @param call_id [String] The unique ID of the shell tool call generated by the model.
         #
+        #   @param environment [OpenAI::Models::Responses::ResponseLocalEnvironment, OpenAI::Models::Responses::ResponseContainerReference, nil] Represents the use of a local environment to perform shell actions.
+        #
         #   @param status [Symbol, OpenAI::Models::Responses::ResponseFunctionShellToolCall::Status] The status of the shell call. One of `in_progress`, `completed`, or `incomplete`
         #
         #   @param created_by [String] The ID of the entity that created this tool call.
@@ -89,6 +99,24 @@ module OpenAI
           #   @param timeout_ms [Integer, nil] Optional timeout in milliseconds for the commands.
         end
 
+        # Represents the use of a local environment to perform shell actions.
+        #
+        # @see OpenAI::Models::Responses::ResponseFunctionShellToolCall#environment
+        module Environment
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # Represents the use of a local environment to perform shell actions.
+          variant :local, -> { OpenAI::Responses::ResponseLocalEnvironment }
+
+          # Represents a container created with /v1/containers.
+          variant :container_reference, -> { OpenAI::Responses::ResponseContainerReference }
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::ResponseLocalEnvironment, OpenAI::Models::Responses::ResponseContainerReference)]
+        end
+
         # The status of the shell call. One of `in_progress`, `completed`, or
         # `incomplete`.
         #