openai 0.3.0 → 0.4.1

data/rbi/openai/models/beta/threads/run.rbi

@@ -0,0 +1,870 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Beta
+      module Threads
+        class Run < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(OpenAI::Beta::Threads::Run, OpenAI::Internal::AnyHash)
+            end
+
+          # The identifier, which can be referenced in API endpoints.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The ID of the
+          # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+          # execution of this run.
+          sig { returns(String) }
+          attr_accessor :assistant_id
+
+          # The Unix timestamp (in seconds) for when the run was cancelled.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :cancelled_at
+
+          # The Unix timestamp (in seconds) for when the run was completed.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :completed_at
+
+          # The Unix timestamp (in seconds) for when the run was created.
+          sig { returns(Integer) }
+          attr_accessor :created_at
+
+          # The Unix timestamp (in seconds) for when the run will expire.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :expires_at
+
+          # The Unix timestamp (in seconds) for when the run failed.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :failed_at
+
+          # Details on why the run is incomplete. Will be `null` if the run is not
+          # incomplete.
+          sig do
+            returns(T.nilable(OpenAI::Beta::Threads::Run::IncompleteDetails))
+          end
+          attr_reader :incomplete_details
+
+          sig do
+            params(
+              incomplete_details:
+                T.nilable(OpenAI::Beta::Threads::Run::IncompleteDetails::OrHash)
+            ).void
+          end
+          attr_writer :incomplete_details
+
+          # The instructions that the
+          # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+          # this run.
+          sig { returns(String) }
+          attr_accessor :instructions
+
+          # The last error associated with this run. Will be `null` if there are no errors.
+          sig { returns(T.nilable(OpenAI::Beta::Threads::Run::LastError)) }
+          attr_reader :last_error
+
+          sig do
+            params(
+              last_error:
+                T.nilable(OpenAI::Beta::Threads::Run::LastError::OrHash)
+            ).void
+          end
+          attr_writer :last_error
+
+          # The maximum number of completion tokens specified to have been used over the
+          # course of the run.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :max_completion_tokens
+
+          # The maximum number of prompt tokens specified to have been used over the course
+          # of the run.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :max_prompt_tokens
+
+          # Set of 16 key-value pairs that can be attached to an object. This can be useful
+          # for storing additional information about the object in a structured format, and
+          # querying for objects via API or the dashboard.
+          #
+          # Keys are strings with a maximum length of 64 characters. Values are strings with
+          # a maximum length of 512 characters.
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_accessor :metadata
+
+          # The model that the
+          # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+          # this run.
+          sig { returns(String) }
+          attr_accessor :model
+
+          # The object type, which is always `thread.run`.
+          sig { returns(Symbol) }
+          attr_accessor :object
+
+          # Whether to enable
+          # [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
+          # during tool use.
+          sig { returns(T::Boolean) }
+          attr_accessor :parallel_tool_calls
+
+          # Details on the action required to continue the run. Will be `null` if no action
+          # is required.
+          sig { returns(T.nilable(OpenAI::Beta::Threads::Run::RequiredAction)) }
+          attr_reader :required_action
+
+          sig do
+            params(
+              required_action:
+                T.nilable(OpenAI::Beta::Threads::Run::RequiredAction::OrHash)
+            ).void
+          end
+          attr_writer :required_action
+
+          # Specifies the format that the model must output. Compatible with
+          # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+          # [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
+          # and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+          #
+          # Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
+          # Outputs which ensures the model will match your supplied JSON schema. Learn more
+          # in the
+          # [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+          #
+          # Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
+          # message the model generates is valid JSON.
+          #
+          # **Important:** when using JSON mode, you **must** also instruct the model to
+          # produce JSON yourself via a system or user message. Without this, the model may
+          # generate an unending stream of whitespace until the generation reaches the token
+          # limit, resulting in a long-running and seemingly "stuck" request. Also note that
+          # the message content may be partially cut off if `finish_reason="length"`, which
+          # indicates the generation exceeded `max_tokens` or the conversation exceeded the
+          # max context length.
+          sig do
+            returns(
+              T.nilable(OpenAI::Beta::AssistantResponseFormatOption::Variants)
+            )
+          end
+          attr_accessor :response_format
+
+          # The Unix timestamp (in seconds) for when the run was started.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :started_at
+
+          # The status of the run, which can be either `queued`, `in_progress`,
+          # `requires_action`, `cancelling`, `cancelled`, `failed`, `completed`,
+          # `incomplete`, or `expired`.
+          sig { returns(OpenAI::Beta::Threads::RunStatus::TaggedSymbol) }
+          attr_accessor :status
+
+          # The ID of the [thread](https://platform.openai.com/docs/api-reference/threads)
+          # that was executed on as a part of this run.
+          sig { returns(String) }
+          attr_accessor :thread_id
+
+          # Controls which (if any) tool is called by the model. `none` means the model will
+          # not call any tools and instead generates a message. `auto` is the default value
+          # and means the model can pick between generating a message or calling one or more
+          # tools. `required` means the model must call one or more tools before responding
+          # to the user. Specifying a particular tool like `{"type": "file_search"}` or
+          # `{"type": "function", "function": {"name": "my_function"}}` forces the model to
+          # call that tool.
+          sig do
+            returns(
+              T.nilable(OpenAI::Beta::AssistantToolChoiceOption::Variants)
+            )
+          end
+          attr_accessor :tool_choice
+
+          # The list of tools that the
+          # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+          # this run.
+          sig { returns(T::Array[OpenAI::Beta::AssistantTool::Variants]) }
+          attr_accessor :tools
+
+          # Controls for how a thread will be truncated prior to the run. Use this to
+          # control the intial context window of the run.
+          sig do
+            returns(T.nilable(OpenAI::Beta::Threads::Run::TruncationStrategy))
+          end
+          attr_reader :truncation_strategy
+
+          sig do
+            params(
+              truncation_strategy:
+                T.nilable(
+                  OpenAI::Beta::Threads::Run::TruncationStrategy::OrHash
+                )
+            ).void
+          end
+          attr_writer :truncation_strategy
+
+          # Usage statistics related to the run. This value will be `null` if the run is not
+          # in a terminal state (i.e. `in_progress`, `queued`, etc.).
+          sig { returns(T.nilable(OpenAI::Beta::Threads::Run::Usage)) }
+          attr_reader :usage
+
+          sig do
+            params(
+              usage: T.nilable(OpenAI::Beta::Threads::Run::Usage::OrHash)
+            ).void
+          end
+          attr_writer :usage
+
+          # The sampling temperature used for this run. If not set, defaults to 1.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :temperature
+
+          # The nucleus sampling value used for this run. If not set, defaults to 1.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :top_p
+
+          # Represents an execution run on a
+          # [thread](https://platform.openai.com/docs/api-reference/threads).
+          sig do
+            params(
+              id: String,
+              assistant_id: String,
+              cancelled_at: T.nilable(Integer),
+              completed_at: T.nilable(Integer),
+              created_at: Integer,
+              expires_at: T.nilable(Integer),
+              failed_at: T.nilable(Integer),
+              incomplete_details:
+                T.nilable(
+                  OpenAI::Beta::Threads::Run::IncompleteDetails::OrHash
+                ),
+              instructions: String,
+              last_error:
+                T.nilable(OpenAI::Beta::Threads::Run::LastError::OrHash),
+              max_completion_tokens: T.nilable(Integer),
+              max_prompt_tokens: T.nilable(Integer),
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              model: String,
+              parallel_tool_calls: T::Boolean,
+              required_action:
+                T.nilable(OpenAI::Beta::Threads::Run::RequiredAction::OrHash),
+              response_format:
+                T.nilable(
+                  T.any(
+                    Symbol,
+                    OpenAI::ResponseFormatText::OrHash,
+                    OpenAI::ResponseFormatJSONObject::OrHash,
+                    OpenAI::ResponseFormatJSONSchema::OrHash
+                  )
+                ),
+              started_at: T.nilable(Integer),
+              status: OpenAI::Beta::Threads::RunStatus::OrSymbol,
+              thread_id: String,
+              tool_choice:
+                T.nilable(
+                  T.any(
+                    OpenAI::Beta::AssistantToolChoiceOption::Auto::OrSymbol,
+                    OpenAI::Beta::AssistantToolChoice::OrHash
+                  )
+                ),
+              tools:
+                T::Array[
+                  T.any(
+                    OpenAI::Beta::CodeInterpreterTool::OrHash,
+                    OpenAI::Beta::FileSearchTool::OrHash,
+                    OpenAI::Beta::FunctionTool::OrHash
+                  )
+                ],
+              truncation_strategy:
+                T.nilable(
+                  OpenAI::Beta::Threads::Run::TruncationStrategy::OrHash
+                ),
+              usage: T.nilable(OpenAI::Beta::Threads::Run::Usage::OrHash),
+              temperature: T.nilable(Float),
+              top_p: T.nilable(Float),
+              object: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The identifier, which can be referenced in API endpoints.
+            id:,
+            # The ID of the
+            # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+            # execution of this run.
+            assistant_id:,
+            # The Unix timestamp (in seconds) for when the run was cancelled.
+            cancelled_at:,
+            # The Unix timestamp (in seconds) for when the run was completed.
+            completed_at:,
+            # The Unix timestamp (in seconds) for when the run was created.
+            created_at:,
+            # The Unix timestamp (in seconds) for when the run will expire.
+            expires_at:,
+            # The Unix timestamp (in seconds) for when the run failed.
+            failed_at:,
+            # Details on why the run is incomplete. Will be `null` if the run is not
+            # incomplete.
+            incomplete_details:,
+            # The instructions that the
+            # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+            # this run.
+            instructions:,
+            # The last error associated with this run. Will be `null` if there are no errors.
+            last_error:,
+            # The maximum number of completion tokens specified to have been used over the
+            # course of the run.
+            max_completion_tokens:,
+            # The maximum number of prompt tokens specified to have been used over the course
+            # of the run.
+            max_prompt_tokens:,
+            # Set of 16 key-value pairs that can be attached to an object. This can be useful
+            # for storing additional information about the object in a structured format, and
+            # querying for objects via API or the dashboard.
+            #
+            # Keys are strings with a maximum length of 64 characters. Values are strings with
+            # a maximum length of 512 characters.
+            metadata:,
+            # The model that the
+            # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+            # this run.
+            model:,
+            # Whether to enable
+            # [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
+            # during tool use.
+            parallel_tool_calls:,
+            # Details on the action required to continue the run. Will be `null` if no action
+            # is required.
+            required_action:,
+            # Specifies the format that the model must output. Compatible with
+            # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+            # [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
+            # and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+            #
+            # Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
+            # Outputs which ensures the model will match your supplied JSON schema. Learn more
+            # in the
+            # [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+            #
+            # Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
+            # message the model generates is valid JSON.
+            #
+            # **Important:** when using JSON mode, you **must** also instruct the model to
+            # produce JSON yourself via a system or user message. Without this, the model may
+            # generate an unending stream of whitespace until the generation reaches the token
+            # limit, resulting in a long-running and seemingly "stuck" request. Also note that
+            # the message content may be partially cut off if `finish_reason="length"`, which
+            # indicates the generation exceeded `max_tokens` or the conversation exceeded the
+            # max context length.
+            response_format:,
+            # The Unix timestamp (in seconds) for when the run was started.
+            started_at:,
+            # The status of the run, which can be either `queued`, `in_progress`,
+            # `requires_action`, `cancelling`, `cancelled`, `failed`, `completed`,
+            # `incomplete`, or `expired`.
+            status:,
+            # The ID of the [thread](https://platform.openai.com/docs/api-reference/threads)
+            # that was executed on as a part of this run.
+            thread_id:,
+            # Controls which (if any) tool is called by the model. `none` means the model will
+            # not call any tools and instead generates a message. `auto` is the default value
+            # and means the model can pick between generating a message or calling one or more
+            # tools. `required` means the model must call one or more tools before responding
+            # to the user. Specifying a particular tool like `{"type": "file_search"}` or
+            # `{"type": "function", "function": {"name": "my_function"}}` forces the model to
+            # call that tool.
+            tool_choice:,
+            # The list of tools that the
+            # [assistant](https://platform.openai.com/docs/api-reference/assistants) used for
+            # this run.
+            tools:,
+            # Controls for how a thread will be truncated prior to the run. Use this to
+            # control the intial context window of the run.
+            truncation_strategy:,
+            # Usage statistics related to the run. This value will be `null` if the run is not
+            # in a terminal state (i.e. `in_progress`, `queued`, etc.).
+            usage:,
+            # The sampling temperature used for this run. If not set, defaults to 1.
+            temperature: nil,
+            # The nucleus sampling value used for this run. If not set, defaults to 1.
+            top_p: nil,
+            # The object type, which is always `thread.run`.
+            object: :"thread.run"
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                assistant_id: String,
+                cancelled_at: T.nilable(Integer),
+                completed_at: T.nilable(Integer),
+                created_at: Integer,
+                expires_at: T.nilable(Integer),
+                failed_at: T.nilable(Integer),
+                incomplete_details:
+                  T.nilable(OpenAI::Beta::Threads::Run::IncompleteDetails),
+                instructions: String,
+                last_error: T.nilable(OpenAI::Beta::Threads::Run::LastError),
+                max_completion_tokens: T.nilable(Integer),
+                max_prompt_tokens: T.nilable(Integer),
+                metadata: T.nilable(T::Hash[Symbol, String]),
+                model: String,
+                object: Symbol,
+                parallel_tool_calls: T::Boolean,
+                required_action:
+                  T.nilable(OpenAI::Beta::Threads::Run::RequiredAction),
+                response_format:
+                  T.nilable(
+                    OpenAI::Beta::AssistantResponseFormatOption::Variants
+                  ),
+                started_at: T.nilable(Integer),
+                status: OpenAI::Beta::Threads::RunStatus::TaggedSymbol,
+                thread_id: String,
+                tool_choice:
+                  T.nilable(OpenAI::Beta::AssistantToolChoiceOption::Variants),
+                tools: T::Array[OpenAI::Beta::AssistantTool::Variants],
+                truncation_strategy:
+                  T.nilable(OpenAI::Beta::Threads::Run::TruncationStrategy),
+                usage: T.nilable(OpenAI::Beta::Threads::Run::Usage),
+                temperature: T.nilable(Float),
+                top_p: T.nilable(Float)
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class IncompleteDetails < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::Run::IncompleteDetails,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The reason why the run is incomplete. This will point to which specific token
+            # limit was reached over the course of the run.
+            sig do
+              returns(
+                T.nilable(
+                  OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::TaggedSymbol
+                )
+              )
+            end
+            attr_reader :reason
+
+            sig do
+              params(
+                reason:
+                  OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::OrSymbol
+              ).void
+            end
+            attr_writer :reason
+
+            # Details on why the run is incomplete. Will be `null` if the run is not
+            # incomplete.
+            sig do
+              params(
+                reason:
+                  OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The reason why the run is incomplete. This will point to which specific token
+              # limit was reached over the course of the run.
+              reason: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  reason:
+                    OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The reason why the run is incomplete. This will point to which specific token
+            # limit was reached over the course of the run.
+            module Reason
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    OpenAI::Beta::Threads::Run::IncompleteDetails::Reason
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              MAX_COMPLETION_TOKENS =
+                T.let(
+                  :max_completion_tokens,
+                  OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::TaggedSymbol
+                )
+              MAX_PROMPT_TOKENS =
+                T.let(
+                  :max_prompt_tokens,
+                  OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::Run::IncompleteDetails::Reason::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          class LastError < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::Run::LastError,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # One of `server_error`, `rate_limit_exceeded`, or `invalid_prompt`.
+            sig do
+              returns(OpenAI::Beta::Threads::Run::LastError::Code::TaggedSymbol)
+            end
+            attr_accessor :code
+
+            # A human-readable description of the error.
+            sig { returns(String) }
+            attr_accessor :message
+
+            # The last error associated with this run. Will be `null` if there are no errors.
+            sig do
+              params(
+                code: OpenAI::Beta::Threads::Run::LastError::Code::OrSymbol,
+                message: String
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # One of `server_error`, `rate_limit_exceeded`, or `invalid_prompt`.
+              code:,
+              # A human-readable description of the error.
+              message:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  code:
+                    OpenAI::Beta::Threads::Run::LastError::Code::TaggedSymbol,
+                  message: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # One of `server_error`, `rate_limit_exceeded`, or `invalid_prompt`.
+            module Code
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(Symbol, OpenAI::Beta::Threads::Run::LastError::Code)
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              SERVER_ERROR =
+                T.let(
+                  :server_error,
+                  OpenAI::Beta::Threads::Run::LastError::Code::TaggedSymbol
+                )
+              RATE_LIMIT_EXCEEDED =
+                T.let(
+                  :rate_limit_exceeded,
+                  OpenAI::Beta::Threads::Run::LastError::Code::TaggedSymbol
+                )
+              INVALID_PROMPT =
+                T.let(
+                  :invalid_prompt,
+                  OpenAI::Beta::Threads::Run::LastError::Code::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::Run::LastError::Code::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          class RequiredAction < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::Run::RequiredAction,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # Details on the tool outputs needed for this run to continue.
+            sig do
+              returns(
+                OpenAI::Beta::Threads::Run::RequiredAction::SubmitToolOutputs
+              )
+            end
+            attr_reader :submit_tool_outputs
+
+            sig do
+              params(
+                submit_tool_outputs:
+                  OpenAI::Beta::Threads::Run::RequiredAction::SubmitToolOutputs::OrHash
+              ).void
+            end
+            attr_writer :submit_tool_outputs
+
+            # For now, this is always `submit_tool_outputs`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Details on the action required to continue the run. Will be `null` if no action
+            # is required.
+            sig do
+              params(
+                submit_tool_outputs:
+                  OpenAI::Beta::Threads::Run::RequiredAction::SubmitToolOutputs::OrHash,
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Details on the tool outputs needed for this run to continue.
+              submit_tool_outputs:,
+              # For now, this is always `submit_tool_outputs`.
+              type: :submit_tool_outputs
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  submit_tool_outputs:
+                    OpenAI::Beta::Threads::Run::RequiredAction::SubmitToolOutputs,
+                  type: Symbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class SubmitToolOutputs < OpenAI::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    OpenAI::Beta::Threads::Run::RequiredAction::SubmitToolOutputs,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+              # A list of the relevant tool calls.
+              sig do
+                returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::RequiredActionFunctionToolCall
+                  ]
+                )
+              end
+              attr_accessor :tool_calls
+
+              # Details on the tool outputs needed for this run to continue.
+              sig do
+                params(
+                  tool_calls:
+                    T::Array[
+                      OpenAI::Beta::Threads::RequiredActionFunctionToolCall::OrHash
+                    ]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # A list of the relevant tool calls.
+                tool_calls:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    tool_calls:
+                      T::Array[
+                        OpenAI::Beta::Threads::RequiredActionFunctionToolCall
+                      ]
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
+          end
+
+          class TruncationStrategy < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::Run::TruncationStrategy,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The truncation strategy to use for the thread. The default is `auto`. If set to
+            # `last_messages`, the thread will be truncated to the n most recent messages in
+            # the thread. When set to `auto`, messages in the middle of the thread will be
+            # dropped to fit the context length of the model, `max_prompt_tokens`.
+            sig do
+              returns(
+                OpenAI::Beta::Threads::Run::TruncationStrategy::Type::TaggedSymbol
+              )
+            end
+            attr_accessor :type
+
+            # The number of most recent messages from the thread when constructing the context
+            # for the run.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :last_messages
+
+            # Controls for how a thread will be truncated prior to the run. Use this to
+            # control the intial context window of the run.
+            sig do
+              params(
+                type:
+                  OpenAI::Beta::Threads::Run::TruncationStrategy::Type::OrSymbol,
+                last_messages: T.nilable(Integer)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The truncation strategy to use for the thread. The default is `auto`. If set to
+              # `last_messages`, the thread will be truncated to the n most recent messages in
+              # the thread. When set to `auto`, messages in the middle of the thread will be
+              # dropped to fit the context length of the model, `max_prompt_tokens`.
+              type:,
+              # The number of most recent messages from the thread when constructing the context
+              # for the run.
+              last_messages: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  type:
+                    OpenAI::Beta::Threads::Run::TruncationStrategy::Type::TaggedSymbol,
+                  last_messages: T.nilable(Integer)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The truncation strategy to use for the thread. The default is `auto`. If set to
+            # `last_messages`, the thread will be truncated to the n most recent messages in
+            # the thread. When set to `auto`, messages in the middle of the thread will be
+            # dropped to fit the context length of the model, `max_prompt_tokens`.
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    OpenAI::Beta::Threads::Run::TruncationStrategy::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              AUTO =
+                T.let(
+                  :auto,
+                  OpenAI::Beta::Threads::Run::TruncationStrategy::Type::TaggedSymbol
+                )
+              LAST_MESSAGES =
+                T.let(
+                  :last_messages,
+                  OpenAI::Beta::Threads::Run::TruncationStrategy::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::Run::TruncationStrategy::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          class Usage < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::Run::Usage,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # Number of completion tokens used over the course of the run.
+            sig { returns(Integer) }
+            attr_accessor :completion_tokens
+
+            # Number of prompt tokens used over the course of the run.
+            sig { returns(Integer) }
+            attr_accessor :prompt_tokens
+
+            # Total number of tokens used (prompt + completion).
+            sig { returns(Integer) }
+            attr_accessor :total_tokens
+
+            # Usage statistics related to the run. This value will be `null` if the run is not
+            # in a terminal state (i.e. `in_progress`, `queued`, etc.).
+            sig do
+              params(
+                completion_tokens: Integer,
+                prompt_tokens: Integer,
+                total_tokens: Integer
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Number of completion tokens used over the course of the run.
+              completion_tokens:,
+              # Number of prompt tokens used over the course of the run.
+              prompt_tokens:,
+              # Total number of tokens used (prompt + completion).
+              total_tokens:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  completion_tokens: Integer,
+                  prompt_tokens: Integer,
+                  total_tokens: Integer
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end