openai 0.89.0 → 0.90.0

data/rbi/openai/models/beta/agents/sessions/subagents/turn_retrieve_params.rbi

@@ -0,0 +1,79 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          module Subagents
+
+            class TurnRetrieveParams < OpenAI::Internal::Type::BaseModel
+
+              extend OpenAI::Internal::Type::RequestParameters::Converter
+              include OpenAI::Internal::Type::RequestParameters
+
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Sessions::Subagents::TurnRetrieveParams,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              sig { returns(String) }
+              attr_accessor :session_id
+
+              sig { returns(String) }
+              attr_accessor :subagent_id
+
+              sig { returns(String) }
+              attr_accessor :turn_id
+
+              sig do
+                params(
+
+                  session_id: String,
+
+                  subagent_id: String,
+
+                  turn_id: String,
+
+                  request_options: OpenAI::RequestOptions::OrHash
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                session_id:,
+
+                subagent_id:,
+
+                turn_id:,
+
+                request_options: {}
+              )
+              end
+
+              sig do
+                override.returns(
+                  {session_id: String, subagent_id: String, turn_id: String, request_options: OpenAI::RequestOptions}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/sessions/subagents/turns/item_list_params.rbi

@@ -0,0 +1,161 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          module Subagents
+
+            module Turns
+
+              class ItemListParams < OpenAI::Internal::Type::BaseModel
+
+                extend OpenAI::Internal::Type::RequestParameters::Converter
+                include OpenAI::Internal::Type::RequestParameters
+
+                OrHash = T.type_alias do
+                  T.any(
+                    OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+                sig { returns(String) }
+                attr_accessor :session_id
+
+                sig { returns(String) }
+                attr_accessor :subagent_id
+
+                sig { returns(String) }
+                attr_accessor :turn_id
+
+                # Return resources after this resource ID in the selected order.
+                sig { returns(T.nilable(String)) }
+                attr_reader :after
+
+                sig { params(after: String).void }
+                attr_writer :after
+
+                # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+                sig { returns(T.nilable(Integer)) }
+                attr_reader :limit
+
+                sig { params(limit: Integer).void }
+                attr_writer :limit
+
+                # The order in which resources are returned. Defaults to `desc`.
+                sig {
+                  returns(T.nilable(OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::OrSymbol))
+                }
+                attr_reader :order
+
+                sig {
+                  params(order: OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::OrSymbol).void
+                }
+                attr_writer :order
+
+                sig do
+                  params(
+
+                    session_id: String,
+
+                    subagent_id: String,
+
+                    turn_id: String,
+
+                    after: String,
+
+                    limit: Integer,
+
+                    order: OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::OrSymbol,
+
+                    request_options: OpenAI::RequestOptions::OrHash
+                  )
+                    .returns(T.attached_class)
+                end
+                def self.new(
+
+                  session_id:,
+
+                  subagent_id:,
+
+                  turn_id:,
+
+                  # Return resources after this resource ID in the selected order.
+                  after: nil,
+
+                  # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+                  limit: nil,
+
+                  # The order in which resources are returned. Defaults to `desc`.
+                  order: nil,
+
+                  request_options: {}
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      session_id: String,
+                      subagent_id: String,
+                      turn_id: String,
+                      after: String,
+                      limit: Integer,
+                      order: OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::OrSymbol,
+                      request_options: OpenAI::RequestOptions
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # The order in which resources are returned. Defaults to `desc`.
+                module Order
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(Symbol, OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order)
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  # Returns resources in ascending order.
+                  ASC = T.let(
+                    :asc,
+                    OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::TaggedSymbol
+                  )
+
+                  # Returns resources in descending order.
+                  DESC = T.let(
+                    :desc,
+                    OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[OpenAI::Beta::Agents::Sessions::Subagents::Turns::ItemListParams::Order::TaggedSymbol]
+                    )
+                  }
+                  def self.values
+                  end
+                end
+
+              end
+
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/sessions/turn.rbi

@@ -0,0 +1,200 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          class Turn < OpenAI::Internal::Type::BaseModel
+
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::Sessions::Turn,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The ID of the turn.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # The ID of the agent that ran the turn.
+            sig { returns(String) }
+            attr_accessor :agent_id
+
+            # The Unix timestamp, in seconds, when the turn reached a terminal state.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :completed_at
+
+            # The Unix timestamp, in seconds, used to order the turn by creation time.
+            # Subagent turns use their start time, falling back to completion time or the
+            # subagent opening time when the preceding timestamps are unavailable.
+            sig { returns(Integer) }
+            attr_accessor :created_at
+
+            # A customer-safe error describing why a session request failed.
+            sig { returns(T.nilable(OpenAI::Beta::SessionTurnError)) }
+            attr_reader :error
+
+            sig { params(error: T.nilable(OpenAI::Beta::SessionTurnError::OrHash)).void }
+            attr_writer :error
+
+            # The object type. Always `agent.session.turn`.
+            sig { returns(Symbol) }
+            attr_accessor :object
+
+            # The ID of the session that owns the turn.
+            sig { returns(String) }
+            attr_accessor :session_id
+
+            # The Unix timestamp, in seconds, when the turn started.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :started_at
+
+            # The current status of the turn.
+            sig { returns(OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol) }
+            attr_accessor :status
+
+            # The ID of the subagent that ran the turn, if applicable.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :subagent_id
+
+            # Recorded token usage for a session or turn. Usage is best effort and may change.
+            sig { returns(T.nilable(OpenAI::Beta::TokenUsage)) }
+            attr_reader :usage
+
+            sig { params(usage: T.nilable(OpenAI::Beta::TokenUsage::OrHash)).void }
+            attr_writer :usage
+
+            # The canonical public representation of a session turn.
+            sig do
+              params(
+
+                id: String,
+
+                agent_id: String,
+
+                completed_at: T.nilable(Integer),
+
+                created_at: Integer,
+
+                error: T.nilable(OpenAI::Beta::SessionTurnError::OrHash),
+
+                session_id: String,
+
+                started_at: T.nilable(Integer),
+
+                status: OpenAI::Beta::Agents::Sessions::Turn::Status::OrSymbol,
+
+                subagent_id: T.nilable(String),
+
+                usage: T.nilable(OpenAI::Beta::TokenUsage::OrHash),
+
+                object: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The ID of the turn.
+              id:,
+
+              # The ID of the agent that ran the turn.
+              agent_id:,
+
+              # The Unix timestamp, in seconds, when the turn reached a terminal state.
+              completed_at:,
+
+              # The Unix timestamp, in seconds, used to order the turn by creation time.
+              # Subagent turns use their start time, falling back to completion time or the
+              # subagent opening time when the preceding timestamps are unavailable.
+              created_at:,
+
+              # A customer-safe error describing why a session request failed.
+              error:,
+
+              # The ID of the session that owns the turn.
+              session_id:,
+
+              # The Unix timestamp, in seconds, when the turn started.
+              started_at:,
+
+              # The current status of the turn.
+              status:,
+
+              # The ID of the subagent that ran the turn, if applicable.
+              subagent_id:,
+
+              # Recorded token usage for a session or turn. Usage is best effort and may change.
+              usage:,
+
+              # The object type. Always `agent.session.turn`.
+
+              object: :"agent.session.turn"
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: String,
+                  agent_id: String,
+                  completed_at: T.nilable(Integer),
+                  created_at: Integer,
+                  error: T.nilable(OpenAI::Beta::SessionTurnError),
+                  object: Symbol,
+                  session_id: String,
+                  started_at: T.nilable(Integer),
+                  status: OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol,
+                  subagent_id: T.nilable(String),
+                  usage: T.nilable(OpenAI::Beta::TokenUsage)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The current status of the turn.
+            module Status
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::Agents::Sessions::Turn::Status) }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              # The turn is waiting to start.
+              QUEUED = T.let(:queued, OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol)
+
+              # The turn is in progress.
+              IN_PROGRESS = T.let(:in_progress, OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol)
+
+              # The turn is waiting for external input.
+              WAITING = T.let(:waiting, OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol)
+
+              # The turn completed successfully.
+              COMPLETED = T.let(:completed, OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol)
+
+              # The turn failed.
+              FAILED = T.let(:failed, OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol)
+
+              # The turn was cancelled.
+              CANCELLED = T.let(:cancelled, OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol)
+
+              sig { override.returns(T::Array[OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol]) }
+              def self.values
+              end
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/sessions/turn_list_params.rbi

@@ -0,0 +1,121 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          class TurnListParams < OpenAI::Internal::Type::BaseModel
+
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::Sessions::TurnListParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(String) }
+            attr_accessor :session_id
+
+            # Return resources after this resource ID in the selected order.
+            sig { returns(T.nilable(String)) }
+            attr_reader :after
+
+            sig { params(after: String).void }
+            attr_writer :after
+
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :limit
+
+            sig { params(limit: Integer).void }
+            attr_writer :limit
+
+            # The order in which resources are returned. Defaults to `desc`.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::Sessions::TurnListParams::Order::OrSymbol)) }
+            attr_reader :order
+
+            sig { params(order: OpenAI::Beta::Agents::Sessions::TurnListParams::Order::OrSymbol).void }
+            attr_writer :order
+
+            sig do
+              params(
+
+                session_id: String,
+
+                after: String,
+
+                limit: Integer,
+
+                order: OpenAI::Beta::Agents::Sessions::TurnListParams::Order::OrSymbol,
+
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              session_id:,
+
+              # Return resources after this resource ID in the selected order.
+              after: nil,
+
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+              limit: nil,
+
+              # The order in which resources are returned. Defaults to `desc`.
+              order: nil,
+
+              request_options: {}
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  session_id: String,
+                  after: String,
+                  limit: Integer,
+                  order: OpenAI::Beta::Agents::Sessions::TurnListParams::Order::OrSymbol,
+                  request_options: OpenAI::RequestOptions
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The order in which resources are returned. Defaults to `desc`.
+            module Order
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::Agents::Sessions::TurnListParams::Order) }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              # Returns resources in ascending order.
+              ASC = T.let(:asc, OpenAI::Beta::Agents::Sessions::TurnListParams::Order::TaggedSymbol)
+
+              # Returns resources in descending order.
+              DESC = T.let(:desc, OpenAI::Beta::Agents::Sessions::TurnListParams::Order::TaggedSymbol)
+
+              sig { override.returns(T::Array[OpenAI::Beta::Agents::Sessions::TurnListParams::Order::TaggedSymbol]) }
+              def self.values
+              end
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/sessions/turn_retrieve_params.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          class TurnRetrieveParams < OpenAI::Internal::Type::BaseModel
+
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::Sessions::TurnRetrieveParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(String) }
+            attr_accessor :session_id
+
+            sig { returns(String) }
+            attr_accessor :turn_id
+
+            sig do
+              params(
+
+                session_id: String,
+
+                turn_id: String,
+
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              session_id:,
+
+              turn_id:,
+
+              request_options: {}
+            )
+            end
+
+            sig do
+              override.returns(
+                {session_id: String, turn_id: String, request_options: OpenAI::RequestOptions}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end