openai 0.100.0 → 0.101.0

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

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ToolSearchOutputNamespaceTool < OpenAI::Internal::Type::BaseModel
+        # @!attribute description
+        #   A description of the namespace shown to the model.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute name
+        #   The namespace name used in tool calls (for example, `crm`).
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute tools
+        #   The function/custom tools loaded inside this namespace.
+        #
+        #   @return [Array<OpenAI::Models::Responses::ToolSearchOutputNamespaceTool::Tool::Function, OpenAI::Models::Responses::CustomTool>]
+        required(
+          :tools,
+          -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool] }
+        )
+
+        # @!attribute type
+        #   The type of the tool. Always `namespace`.
+        #
+        #   @return [Symbol, :namespace]
+        required :type, const: :namespace
+
+        # @!method initialize(description:, name:, tools:, type: :namespace)
+        #   Groups function/custom tools under a shared namespace.
+        #
+        #   @param description [String]
+        #     A description of the namespace shown to the model.
+        #
+        #   @param name [String]
+        #     The namespace name used in tool calls (for example, `crm`).
+        #
+        #   @param tools [Array<OpenAI::Models::Responses::ToolSearchOutputNamespaceTool::Tool::Function, OpenAI::Models::Responses::CustomTool>]
+        #     The function/custom tools loaded inside this namespace.
+        #
+        #   @param type [Symbol, :namespace]
+        #     The type of the tool. Always `namespace`.
+
+        # A function or custom tool loaded into a namespace by tool search.
+        module Tool
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :function, -> { OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function }
+
+          # A custom tool that processes input using a specified format. Learn more about   [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
+          variant :custom, -> { OpenAI::Responses::CustomTool }
+
+          class Function < OpenAI::Internal::Type::BaseModel
+            # @!attribute name
+            #   The name of the loaded function tool.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :function]
+            required :type, const: :function
+
+            # @!attribute allowed_callers
+            #   The tool invocation context(s).
+            #
+            #   @return [Array<Symbol, OpenAI::Models::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller>, nil]
+            optional(
+              :allowed_callers,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[
+                  enum: OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller
+                ]
+              },
+              nil?: true
+            )
+
+            # @!attribute async
+            #   Whether the tool response can be returned asynchronously versus immediately
+            #   returned on next response creation.
+            #
+            #   @return [Boolean, nil]
+            optional :async, OpenAI::Internal::Type::Boolean
+
+            # @!attribute defer_loading
+            #   Whether this function should be deferred and discovered via tool search.
+            #
+            #   @return [Boolean, nil]
+            optional :defer_loading, OpenAI::Internal::Type::Boolean
+
+            # @!attribute description
+            #
+            #   @return [String, nil]
+            optional :description, String, nil?: true
+
+            # @!attribute output_schema
+            #   A JSON Schema describing the JSON value encoded in string outputs for this
+            #   function tool. This does not describe content-array outputs.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional(
+              :output_schema,
+              OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown],
+              nil?: true
+            )
+
+            # @!attribute parameters
+            #
+            #   @return [Object, nil]
+            optional :parameters, OpenAI::Internal::Type::Unknown, nil?: true
+
+            # @!attribute strict
+            #   Whether to enforce strict parameter validation. If omitted, Responses attempts
+            #   to use strict validation when the schema is compatible, and falls back to
+            #   non-strict validation otherwise.
+            #
+            #   @return [Boolean, nil]
+            optional :strict, OpenAI::Internal::Type::Boolean, nil?: true
+
+            # @!method initialize(name:, allowed_callers: nil, async: nil, defer_loading: nil, description: nil, output_schema: nil, parameters: nil, strict: nil, type: :function)
+            #   @param name [String]
+            #     The name of the loaded function tool.
+            #
+            #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller>, nil]
+            #     The tool invocation context(s).
+            #
+            #   @param async [Boolean]
+            #     Whether the tool response can be returned asynchronously versus immediately
+            #     returned on next response creation.
+            #
+            #   @param defer_loading [Boolean]
+            #     Whether this function should be deferred and discovered via tool search.
+            #
+            #   @param description [String, nil]
+            #
+            #   @param output_schema [Hash{Symbol=>Object}, nil]
+            #     A JSON Schema describing the JSON value encoded in string outputs for this
+            #     function tool. This does not describe content-array outputs.
+            #
+            #   @param parameters [Object, nil]
+            #
+            #   @param strict [Boolean, nil]
+            #     Whether to enforce strict parameter validation. If omitted, Responses attempts
+            #     to use strict validation when the schema is compatible, and falls back to
+            #     non-strict validation otherwise.
+            #
+            #   @param type [Symbol, :function]
+
+            module AllowedCaller
+              extend OpenAI::Internal::Type::Enum
+
+              DIRECT = :direct
+              PROGRAMMATIC = :programmatic
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::ToolSearchOutputNamespaceTool::Tool::Function, OpenAI::Models::Responses::CustomTool)]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models.rb

@@ -113,6 +113,18 @@ module OpenAI
 
   CustomToolInputFormat = OpenAI::Models::CustomToolInputFormat
 
+  Decision = OpenAI::Models::Decision
+
+  DecisionCreateParams = OpenAI::Models::DecisionCreateParams
+
+  DecisionInputImage = OpenAI::Models::DecisionInputImage
+
+  DecisionInputMessage = OpenAI::Models::DecisionInputMessage
+
+  DecisionInputPart = OpenAI::Models::DecisionInputPart
+
+  DecisionInputText = OpenAI::Models::DecisionInputText
+
   DeletedSkill = OpenAI::Models::DeletedSkill
 
   Embedding = OpenAI::Models::Embedding

data/lib/openai/resources/decisions.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Decisions
+      # Evaluate ordered classification and scoring questions against shared input.
+      # Answers are returned in question order.
+      #
+      # Supply input as a string or user messages containing text and inline images.
+      # Only user messages with `input_text` and `input_image` parts are supported;
+      # non-user roles, function calls, files, audio, and item references are not
+      # supported. Images require a data URL, not an external URL or file ID. At most
+      # 128 images are allowed across the request.
+      #
+      # Each question can return a refusal instead of a scored answer. A refusal has
+      # type `refusal` and the corresponding question name, or null if unnamed.
+      #
+      # @overload create(input:, model:, questions:, safety_identifier: nil, request_options: {})
+      #
+      # @param input [String, Array<OpenAI::Models::DecisionInputMessage>]
+      #   Shared evidence, as a string or an array of user messages containing text and
+      #   inline images. Non-user roles, function calls, function-call outputs, files,
+      #   audio, and item references are not supported. At most 128 image parts are
+      #   allowed across all messages in one request.
+      #
+      # @param model [String]
+      #
+      # @param questions [Array<OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score>]
+      #
+      # @param safety_identifier [String, nil]
+      #   Opaque caller-provided end-user identifier, scoped by the verified org. Match
+      #   Responses' limit; this is never the authenticated user identity.
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::Decision]
+      #
+      # @see OpenAI::Models::DecisionCreateParams
+      def create(params)
+        parsed, options = OpenAI::DecisionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "decisions",
+          body: parsed,
+          model: OpenAI::Decision,
+          security: {bearer_auth: true},
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.100.0"
+  VERSION = "0.101.0"
 end

data/lib/openai.rb

@@ -719,6 +719,7 @@ require_relative "openai/models/beta/beta_tool_choice_mcp"
 require_relative "openai/models/beta/beta_tool_choice_options"
 require_relative "openai/models/beta/beta_tool_choice_shell"
 require_relative "openai/models/beta/beta_tool_choice_types"
+require_relative "openai/models/beta/beta_tool_search_output_namespace_tool"
 require_relative "openai/models/beta/beta_tool_search_tool"
 require_relative "openai/models/beta/beta_web_search_preview_tool"
 require_relative "openai/models/beta/beta_web_search_tool"
@@ -954,6 +955,12 @@ require_relative "openai/models/conversations/summary_text_content"
 require_relative "openai/models/conversations/text_content"
 require_relative "openai/models/create_embedding_response"
 require_relative "openai/models/custom_tool_input_format"
+require_relative "openai/models/decision"
+require_relative "openai/models/decision_create_params"
+require_relative "openai/models/decision_input_image"
+require_relative "openai/models/decision_input_message"
+require_relative "openai/models/decision_input_part"
+require_relative "openai/models/decision_input_text"
 require_relative "openai/models/deleted_skill"
 require_relative "openai/models/embedding"
 require_relative "openai/models/embedding_create_params"
@@ -1364,6 +1371,7 @@ require_relative "openai/models/responses/tool_choice_mcp"
 require_relative "openai/models/responses/tool_choice_options"
 require_relative "openai/models/responses/tool_choice_shell"
 require_relative "openai/models/responses/tool_choice_types"
+require_relative "openai/models/responses/tool_search_output_namespace_tool"
 require_relative "openai/models/responses/tool_search_tool"
 require_relative "openai/models/responses/web_search_preview_tool"
 require_relative "openai/models/responses/web_search_tool"
@@ -1559,6 +1567,7 @@ require_relative "openai/resources/containers/files/content"
 require_relative "openai/resources/content_provenance_checks"
 require_relative "openai/resources/conversations"
 require_relative "openai/resources/conversations/items"
+require_relative "openai/resources/decisions"
 require_relative "openai/resources/embeddings"
 require_relative "openai/resources/evals"
 require_relative "openai/resources/evals/runs"

data/rbi/openai/client.rbi

@@ -29,6 +29,9 @@ module OpenAI
     sig { returns(T.nilable(String)) }
     attr_reader :webhook_secret
 
+    sig { returns(OpenAI::Resources::Decisions) }
+    attr_reader :decisions
+
     # Given a prompt, the model will return one or more predicted completions, and can
     # also return the probabilities of alternative tokens at each position.
     sig { returns(OpenAI::Resources::Completions) }