openai 0.98.0 → 0.100.0

data/lib/openai/providers/bedrock.rb

@@ -90,10 +90,29 @@ module OpenAI
           OpenAI::Internal::Provider::Runtime.new(
             name: name,
             base_url: base_url,
-            prepare_request: auth.method(:prepare_request),
+            prepare_request: lambda do |request|
+              url = request.fetch(:url)
+              # AWS documents a separate inference path for this exact Mantle model.
+              if @base_url.nil? && @endpoint == :mantle && sol_inference_request?(request)
+                url = url.dup
+                url.path = "/openai#{url.path}"
+                request = request.merge(url: url)
+              end
+
+              auth.prepare_request(request)
+            end,
             authentication_headers: AUTH_HEADERS
           )
         end
+
+        private def sol_inference_request?(request)
+          unless request[:method] == :post &&
+              %w[/v1/responses /v1/chat/completions].include?(request.fetch(:url).path)
+            return false
+          end
+
+          request[:provider_request_model] == "openai.gpt-6.1-sol"
+        end
       end
 
       class BearerAuth

data/lib/openai/resources/admin/organization/usage.rb

@@ -196,8 +196,10 @@ module OpenAI
           #
           # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::GroupBy>]
           #   Group the usage data by the specified fields. Support fields include
-          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
-          #   combination of them.
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+          #   `api_source` or any combination of them. When grouped by `api_source`, results
+          #   use `agents_api` for attributed Agents API activity and `unlabeled` for all
+          #   other activity. Without source grouping, `api_source` is null.
           #
           # @param limit [Integer]
           #   Specifies the number of buckets to return.
@@ -255,8 +257,13 @@ module OpenAI
           #   End time (Unix seconds) of the query time range, exclusive.
           #
           # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::GroupBy>]
-          #   Group the costs by the specified fields. Support fields include `project_id`,
-          #   `line_item`, `api_key_id` and any combination of them.
+          #   Group the costs by the specified fields. Supported fields include `project_id`,
+          #   `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining
+          #   `user_id` with `project_id` grouping or the `project_ids` filter depends on the
+          #   organization and requested time range. Unsupported combinations return HTTP 400.
+          #   When grouped by `api_source`, results use `agents_api` for attributed Agents API
+          #   activity and `unlabeled` for all other activity. Without source grouping,
+          #   `api_source` is null.
           #
           # @param limit [Integer]
           #   A limit on the number of buckets to be returned. Limit can range between 1 and
@@ -609,8 +616,10 @@ module OpenAI
           #
           # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::GroupBy>]
           #   Group the usage data by the specified fields. Support fields include
-          #   `project_id`, `user_id`, `api_key_id`, `model`, `context_level` or any
-          #   combination of them.
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `context_level`, `api_source` or
+          #   any combination of them. When grouped by `api_source`, results use `agents_api`
+          #   for attributed Agents API activity and `unlabeled` for all other activity.
+          #   Without source grouping, `api_source` is null.
           #
           # @param limit [Integer]
           #   Specifies the number of buckets to return.

data/lib/openai/resources/audio/speech.rb

@@ -26,6 +26,8 @@ module OpenAI
         #   object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #   voices are available in the
         #   [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
+        #   Custom voices must be created from audio samples. Voices created from text
+        #   prompts are supported only in Live.
         #
         # @param instructions [String]
         #   Control the voice of your generated audio with additional instructions. Does not

data/lib/openai/resources/audio/voices.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Audio
+      # Turn audio into text or text into audio.
+      class Voices
+        # Creates a voice from a text prompt or from a consent recording and an audio
+        # sample.
+        #
+        # For prompt-based creation, send `type: "prompt"` with a `name` and `prompt` as
+        # JSON or multipart form data. For creation from an audio sample, send
+        # `type: "audio_sample"` with a `name`, `audio_sample`, and `consent` recording ID
+        # as multipart form data. The type defaults to `audio_sample` when omitted.
+        #
+        # Returns the saved voice's metadata. Voices created from text prompts are
+        # supported only in Live, not in Realtime or the speech endpoint. The response
+        # does not include preview audio.
+        #
+        # @overload create(body:, request_options: {})
+        #
+        # @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
+        #   Creates a voice from a consent recording and an audio sample. Requires
+        #   multipart/form-data.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::Audio::Voice]
+        #
+        # @see OpenAI::Models::Audio::VoiceCreateParams
+        def create(params)
+          parsed, options = OpenAI::Audio::VoiceCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "audio/voices",
+            headers: {"content-type" => "multipart/form-data"},
+            body: parsed[:body],
+            model: OpenAI::Audio::Voice,
+            security: {bearer_auth: true},
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/audio.rb

@@ -15,6 +15,10 @@ module OpenAI
       # @return [OpenAI::Resources::Audio::Speech]
       attr_reader :speech
 
+      # Turn audio into text or text into audio.
+      # @return [OpenAI::Resources::Audio::Voices]
+      attr_reader :voices
+
       # @api private
       #
       # @param client [OpenAI::Client]
@@ -23,6 +27,7 @@ module OpenAI
         @transcriptions = OpenAI::Resources::Audio::Transcriptions.new(client: client)
         @translations = OpenAI::Resources::Audio::Translations.new(client: client)
         @speech = OpenAI::Resources::Audio::Speech.new(client: client)
+        @voices = OpenAI::Resources::Audio::Voices.new(client: client)
       end
     end
   end

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -30,8 +30,8 @@ module OpenAI
             #   An optional human-readable display name for the template.
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Network, nil]
-            #   Network access policy for the environment. Defaults to disabled for GA requests
-            #   and enabled for beta requests.
+            #   Network access policy for the environment. If omitted, the API version
+            #   determines whether network access is enabled or disabled.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Packages, nil]
             #   Packages to install in the environment. Defaults to empty package lists.
@@ -113,8 +113,7 @@ module OpenAI
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network, nil]
             #   Network access available after setup completes. Omit to preserve the current
-            #   policy, or pass `null` to reset to disabled for GA requests or enabled for beta
-            #   requests.
+            #   policy, or pass `null` to reset to the default policy.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Packages, nil]
             #   Packages installed before the runtime network policy applies.

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

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Turns
+            class Items
+              # Lists items belonging to one root-agent turn, including its interactions with
+              # subagents. See
+              # [inspecting agent output](https://developers.openai.com/api/docs/guides/agents-api/observability).
+              #
+              # @overload list(turn_id, session_id:, after: nil, limit: nil, order: nil, request_options: {})
+              #
+              # @param turn_id [String]
+              #   Path param: The ID of the turn.
+              #
+              # @param session_id [String]
+              #   Path param: The ID of the session that owns the turn.
+              #
+              # @param after [String]
+              #   Query param: Return items after this cursor in the selected order. Pass the
+              #   previous response's last_id, which can differ from the last item's ID.
+              #
+              # @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::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::ConversationCursorPage<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::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, 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::Turns::ItemListParams
+              def list(turn_id, params)
+                parsed, options = OpenAI::Beta::Agents::Sessions::Turns::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/turns/%2$s/items", session_id, turn_id],
+                  query: query,
+                  page: OpenAI::Internal::ConversationCursorPage,
+                  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/turns.rb

@@ -6,6 +6,9 @@ module OpenAI
       class Agents
         class Sessions
           class Turns
+            # @return [OpenAI::Resources::Beta::Agents::Sessions::Turns::Items]
+            attr_reader :items
+
             # Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
             # the turn does not belong to the session. See
             # [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
@@ -80,6 +83,7 @@ module OpenAI
             # @param client [OpenAI::Client]
             def initialize(client:)
               @client = client
+              @items = OpenAI::Resources::Beta::Agents::Sessions::Turns::Items.new(client: client)
             end
           end
         end

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

@@ -85,7 +85,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, metadata: nil, vault_ids: nil, request_options: {})
+          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -112,6 +112,7 @@ module OpenAI
           #   The IDs of vaults made available to the session.
           #
           # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: configure and parse a structured answer.
+          # @param tool_handlers [Hash{String=>Proc}] Local handlers for initial-turn function calls (not sent to the API).
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -121,6 +122,7 @@ module OpenAI
           def create_streaming(params)
             params = params.to_h.transform_keys { _1.is_a?(String) ? _1.to_sym : _1 }
             output_type = params.delete(:output_type)
+            tool_handlers = params.delete(:tool_handlers)
             parser = OpenAI::Helpers::Beta::Agents::OutputParser.new(output_type) unless output_type.nil?
             parsed, options = OpenAI::Beta::Agents::SessionCreateParams.dump_request(params)
             unless parsed.fetch(:stream, true)
@@ -140,6 +142,10 @@ module OpenAI
               security: {bearer_auth: true},
               options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
             )
+            if tool_handlers
+              stream.configure_tool_handlers(sessions: self, tool_handlers: tool_handlers, request_options: options)
+            end
+
             stream.configure_output_parser(parser)
           end
 
@@ -274,17 +280,31 @@ module OpenAI
           # @param session_id [String]
           # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>]
           # @param tool_handlers [Hash{String=>Proc}]
+          # @param on_tool_error [Proc, nil]
+          #   Beta: use with tool_handlers to log or monitor argument parsing, handler
+          #   execution, and output conversion failures locally. Receives ToolError;
+          #   API/transport errors still propagate normally. Ordinary observer errors
+          #   are ignored, and the submitted tool failure stays generic.
           # @param idempotency_key [String, nil] Applies only to the input submission.
           # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: parse output without changing session configuration.
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           # @yieldparam stream [OpenAI::Helpers::Agents::SessionStream]
           # @return [OpenAI::Helpers::Agents::SessionStream]
-          def stream(session_id, input:, tool_handlers: {}, idempotency_key: nil, output_type: nil, request_options: {})
+          def stream(
+            session_id,
+            input:,
+            tool_handlers: {},
+            on_tool_error: nil,
+            idempotency_key: nil,
+            output_type: nil,
+            request_options: {}
+          )
             stream = OpenAI::Helpers::Agents::SessionStream.new(
               sessions: self,
               session_id: session_id,
               input: input,
               tool_handlers: tool_handlers,
+              on_tool_error: on_tool_error,
               idempotency_key: idempotency_key,
               output_type: output_type,
               request_options: request_options

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

@@ -141,8 +141,13 @@ module OpenAI
         #   Number of fine-tuning jobs to retrieve.
         #
         # @param metadata [Hash{Symbol=>String}, nil]
-        #   Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
-        #   Alternatively, set `metadata=null` to indicate no metadata.
+        #   Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
+        #   the parameter or passing an empty object applies no metadata filter. An empty
+        #   value, such as `metadata[k]=`, filters for that key with an empty string value.
+        #   To select jobs with null metadata, send the literal query string
+        #   `metadata=null`. Nullable caller types do not specify how a client serializes
+        #   null for a deep-object parameter. Use a raw query parameter if the client omits
+        #   null. Do not combine the two query forms.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #