openai 0.2.0 → 0.4.0.pre.beta.1

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

@@ -0,0 +1,882 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Beta
+      module Threads
+        class RunCreateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Beta::Threads::RunCreateParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The ID of the
+          # [assistant](https://platform.openai.com/docs/api-reference/assistants) to use to
+          # execute this run.
+          sig { returns(String) }
+          attr_accessor :assistant_id
+
+          # A list of additional fields to include in the response. Currently the only
+          # supported value is `step_details.tool_calls[*].file_search.results[*].content`
+          # to fetch the file search result content.
+          #
+          # See the
+          # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+          # for more information.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[OpenAI::Beta::Threads::Runs::RunStepInclude::OrSymbol]
+              )
+            )
+          end
+          attr_reader :include
+
+          sig do
+            params(
+              include:
+                T::Array[OpenAI::Beta::Threads::Runs::RunStepInclude::OrSymbol]
+            ).void
+          end
+          attr_writer :include
+
+          # Appends additional instructions at the end of the instructions for the run. This
+          # is useful for modifying the behavior on a per-run basis without overriding other
+          # instructions.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :additional_instructions
+
+          # Adds additional messages to the thread before creating the run.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage
+                ]
+              )
+            )
+          end
+          attr_accessor :additional_messages
+
+          # Overrides the
+          # [instructions](https://platform.openai.com/docs/api-reference/assistants/createAssistant)
+          # of the assistant. This is useful for modifying the behavior on a per-run basis.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :instructions
+
+          # The maximum number of completion tokens that may be used over the course of the
+          # run. The run will make a best effort to use only the number of completion tokens
+          # specified, across multiple turns of the run. If the run exceeds the number of
+          # completion tokens specified, the run will end with status `incomplete`. See
+          # `incomplete_details` for more info.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :max_completion_tokens
+
+          # The maximum number of prompt tokens that may be used over the course of the run.
+          # The run will make a best effort to use only the number of prompt tokens
+          # specified, across multiple turns of the run. If the run exceeds the number of
+          # prompt tokens specified, the run will end with status `incomplete`. See
+          # `incomplete_details` for more info.
+          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 ID of the [Model](https://platform.openai.com/docs/api-reference/models) to
+          # be used to execute this run. If a value is provided here, it will override the
+          # model associated with the assistant. If not, the model associated with the
+          # assistant will be used.
+          sig { returns(T.nilable(T.any(String, OpenAI::ChatModel::OrSymbol))) }
+          attr_accessor :model
+
+          # Whether to enable
+          # [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
+          # during tool use.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :parallel_tool_calls
+
+          sig { params(parallel_tool_calls: T::Boolean).void }
+          attr_writer :parallel_tool_calls
+
+          # **o-series models only**
+          #
+          # Constrains effort on reasoning for
+          # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+          # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
+          # result in faster responses and fewer tokens used on reasoning in a response.
+          sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
+          attr_accessor :reasoning_effort
+
+          # 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(
+                T.any(
+                  Symbol,
+                  OpenAI::ResponseFormatText,
+                  OpenAI::ResponseFormatJSONObject,
+                  OpenAI::ResponseFormatJSONSchema
+                )
+              )
+            )
+          end
+          attr_accessor :response_format
+
+          # What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+          # make the output more random, while lower values like 0.2 will make it more
+          # focused and deterministic.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :temperature
+
+          # 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(
+                T.any(
+                  OpenAI::Beta::AssistantToolChoiceOption::Auto::OrSymbol,
+                  OpenAI::Beta::AssistantToolChoice
+                )
+              )
+            )
+          end
+          attr_accessor :tool_choice
+
+          # Override the tools the assistant can use for this run. This is useful for
+          # modifying the behavior on a per-run basis.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  T.any(
+                    OpenAI::Beta::CodeInterpreterTool,
+                    OpenAI::Beta::FileSearchTool,
+                    OpenAI::Beta::FunctionTool
+                  )
+                ]
+              )
+            )
+          end
+          attr_accessor :tools
+
+          # An alternative to sampling with temperature, called nucleus sampling, where the
+          # model considers the results of the tokens with top_p probability mass. So 0.1
+          # means only the tokens comprising the top 10% probability mass are considered.
+          #
+          # We generally recommend altering this or temperature but not both.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :top_p
+
+          # 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::RunCreateParams::TruncationStrategy
+              )
+            )
+          end
+          attr_reader :truncation_strategy
+
+          sig do
+            params(
+              truncation_strategy:
+                T.nilable(
+                  OpenAI::Beta::Threads::RunCreateParams::TruncationStrategy::OrHash
+                )
+            ).void
+          end
+          attr_writer :truncation_strategy
+
+          sig do
+            params(
+              assistant_id: String,
+              include:
+                T::Array[OpenAI::Beta::Threads::Runs::RunStepInclude::OrSymbol],
+              additional_instructions: T.nilable(String),
+              additional_messages:
+                T.nilable(
+                  T::Array[
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::OrHash
+                  ]
+                ),
+              instructions: T.nilable(String),
+              max_completion_tokens: T.nilable(Integer),
+              max_prompt_tokens: T.nilable(Integer),
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              model: T.nilable(T.any(String, OpenAI::ChatModel::OrSymbol)),
+              parallel_tool_calls: T::Boolean,
+              reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
+              response_format:
+                T.nilable(
+                  T.any(
+                    Symbol,
+                    OpenAI::ResponseFormatText::OrHash,
+                    OpenAI::ResponseFormatJSONObject::OrHash,
+                    OpenAI::ResponseFormatJSONSchema::OrHash
+                  )
+                ),
+              temperature: T.nilable(Float),
+              tool_choice:
+                T.nilable(
+                  T.any(
+                    OpenAI::Beta::AssistantToolChoiceOption::Auto::OrSymbol,
+                    OpenAI::Beta::AssistantToolChoice::OrHash
+                  )
+                ),
+              tools:
+                T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::CodeInterpreterTool::OrHash,
+                      OpenAI::Beta::FileSearchTool::OrHash,
+                      OpenAI::Beta::FunctionTool::OrHash
+                    )
+                  ]
+                ),
+              top_p: T.nilable(Float),
+              truncation_strategy:
+                T.nilable(
+                  OpenAI::Beta::Threads::RunCreateParams::TruncationStrategy::OrHash
+                ),
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The ID of the
+            # [assistant](https://platform.openai.com/docs/api-reference/assistants) to use to
+            # execute this run.
+            assistant_id:,
+            # A list of additional fields to include in the response. Currently the only
+            # supported value is `step_details.tool_calls[*].file_search.results[*].content`
+            # to fetch the file search result content.
+            #
+            # See the
+            # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+            # for more information.
+            include: nil,
+            # Appends additional instructions at the end of the instructions for the run. This
+            # is useful for modifying the behavior on a per-run basis without overriding other
+            # instructions.
+            additional_instructions: nil,
+            # Adds additional messages to the thread before creating the run.
+            additional_messages: nil,
+            # Overrides the
+            # [instructions](https://platform.openai.com/docs/api-reference/assistants/createAssistant)
+            # of the assistant. This is useful for modifying the behavior on a per-run basis.
+            instructions: nil,
+            # The maximum number of completion tokens that may be used over the course of the
+            # run. The run will make a best effort to use only the number of completion tokens
+            # specified, across multiple turns of the run. If the run exceeds the number of
+            # completion tokens specified, the run will end with status `incomplete`. See
+            # `incomplete_details` for more info.
+            max_completion_tokens: nil,
+            # The maximum number of prompt tokens that may be used over the course of the run.
+            # The run will make a best effort to use only the number of prompt tokens
+            # specified, across multiple turns of the run. If the run exceeds the number of
+            # prompt tokens specified, the run will end with status `incomplete`. See
+            # `incomplete_details` for more info.
+            max_prompt_tokens: nil,
+            # 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: nil,
+            # The ID of the [Model](https://platform.openai.com/docs/api-reference/models) to
+            # be used to execute this run. If a value is provided here, it will override the
+            # model associated with the assistant. If not, the model associated with the
+            # assistant will be used.
+            model: nil,
+            # Whether to enable
+            # [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
+            # during tool use.
+            parallel_tool_calls: nil,
+            # **o-series models only**
+            #
+            # Constrains effort on reasoning for
+            # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+            # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
+            # result in faster responses and fewer tokens used on reasoning in a response.
+            reasoning_effort: nil,
+            # 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: nil,
+            # What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+            # make the output more random, while lower values like 0.2 will make it more
+            # focused and deterministic.
+            temperature: nil,
+            # 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: nil,
+            # Override the tools the assistant can use for this run. This is useful for
+            # modifying the behavior on a per-run basis.
+            tools: nil,
+            # An alternative to sampling with temperature, called nucleus sampling, where the
+            # model considers the results of the tokens with top_p probability mass. So 0.1
+            # means only the tokens comprising the top 10% probability mass are considered.
+            #
+            # We generally recommend altering this or temperature but not both.
+            top_p: nil,
+            # 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: nil,
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                assistant_id: String,
+                include:
+                  T::Array[
+                    OpenAI::Beta::Threads::Runs::RunStepInclude::OrSymbol
+                  ],
+                additional_instructions: T.nilable(String),
+                additional_messages:
+                  T.nilable(
+                    T::Array[
+                      OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage
+                    ]
+                  ),
+                instructions: T.nilable(String),
+                max_completion_tokens: T.nilable(Integer),
+                max_prompt_tokens: T.nilable(Integer),
+                metadata: T.nilable(T::Hash[Symbol, String]),
+                model: T.nilable(T.any(String, OpenAI::ChatModel::OrSymbol)),
+                parallel_tool_calls: T::Boolean,
+                reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
+                response_format:
+                  T.nilable(
+                    T.any(
+                      Symbol,
+                      OpenAI::ResponseFormatText,
+                      OpenAI::ResponseFormatJSONObject,
+                      OpenAI::ResponseFormatJSONSchema
+                    )
+                  ),
+                temperature: T.nilable(Float),
+                tool_choice:
+                  T.nilable(
+                    T.any(
+                      OpenAI::Beta::AssistantToolChoiceOption::Auto::OrSymbol,
+                      OpenAI::Beta::AssistantToolChoice
+                    )
+                  ),
+                tools:
+                  T.nilable(
+                    T::Array[
+                      T.any(
+                        OpenAI::Beta::CodeInterpreterTool,
+                        OpenAI::Beta::FileSearchTool,
+                        OpenAI::Beta::FunctionTool
+                      )
+                    ]
+                  ),
+                top_p: T.nilable(Float),
+                truncation_strategy:
+                  T.nilable(
+                    OpenAI::Beta::Threads::RunCreateParams::TruncationStrategy
+                  ),
+                request_options: OpenAI::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class AdditionalMessage < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The text contents of the message.
+            sig do
+              returns(
+                OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Content::Variants
+              )
+            end
+            attr_accessor :content
+
+            # The role of the entity that is creating the message. Allowed values include:
+            #
+            # - `user`: Indicates the message is sent by an actual user and should be used in
+            #   most cases to represent user-generated messages.
+            # - `assistant`: Indicates the message is generated by the assistant. Use this
+            #   value to insert messages from the assistant into the conversation.
+            sig do
+              returns(
+                OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role::OrSymbol
+              )
+            end
+            attr_accessor :role
+
+            # A list of files attached to the message, and the tools they should be added to.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment
+                  ]
+                )
+              )
+            end
+            attr_accessor :attachments
+
+            # 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
+
+            sig do
+              params(
+                content:
+                  OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Content::Variants,
+                role:
+                  OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role::OrSymbol,
+                attachments:
+                  T.nilable(
+                    T::Array[
+                      OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::OrHash
+                    ]
+                  ),
+                metadata: T.nilable(T::Hash[Symbol, String])
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The text contents of the message.
+              content:,
+              # The role of the entity that is creating the message. Allowed values include:
+              #
+              # - `user`: Indicates the message is sent by an actual user and should be used in
+              #   most cases to represent user-generated messages.
+              # - `assistant`: Indicates the message is generated by the assistant. Use this
+              #   value to insert messages from the assistant into the conversation.
+              role:,
+              # A list of files attached to the message, and the tools they should be added to.
+              attachments: nil,
+              # 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: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  content:
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Content::Variants,
+                  role:
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role::OrSymbol,
+                  attachments:
+                    T.nilable(
+                      T::Array[
+                        OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment
+                      ]
+                    ),
+                  metadata: T.nilable(T::Hash[Symbol, String])
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The text contents of the message.
+            module Content
+              extend OpenAI::Internal::Type::Union
+
+              Variants =
+                T.type_alias do
+                  T.any(
+                    String,
+                    T::Array[
+                      OpenAI::Beta::Threads::MessageContentPartParam::Variants
+                    ]
+                  )
+                end
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Content::Variants
+                  ]
+                )
+              end
+              def self.variants
+              end
+
+              MessageContentPartParamArray =
+                T.let(
+                  OpenAI::Internal::Type::ArrayOf[
+                    union: OpenAI::Beta::Threads::MessageContentPartParam
+                  ],
+                  OpenAI::Internal::Type::Converter
+                )
+            end
+
+            # The role of the entity that is creating the message. Allowed values include:
+            #
+            # - `user`: Indicates the message is sent by an actual user and should be used in
+            #   most cases to represent user-generated messages.
+            # - `assistant`: Indicates the message is generated by the assistant. Use this
+            #   value to insert messages from the assistant into the conversation.
+            module Role
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              USER =
+                T.let(
+                  :user,
+                  OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role::TaggedSymbol
+                )
+              ASSISTANT =
+                T.let(
+                  :assistant,
+                  OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Role::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            class Attachment < OpenAI::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+              # The ID of the file to attach to the message.
+              sig { returns(T.nilable(String)) }
+              attr_reader :file_id
+
+              sig { params(file_id: String).void }
+              attr_writer :file_id
+
+              # The tools to add this file to.
+              sig do
+                returns(
+                  T.nilable(
+                    T::Array[
+                      T.any(
+                        OpenAI::Beta::CodeInterpreterTool,
+                        OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch
+                      )
+                    ]
+                  )
+                )
+              end
+              attr_reader :tools
+
+              sig do
+                params(
+                  tools:
+                    T::Array[
+                      T.any(
+                        OpenAI::Beta::CodeInterpreterTool::OrHash,
+                        OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch::OrHash
+                      )
+                    ]
+                ).void
+              end
+              attr_writer :tools
+
+              sig do
+                params(
+                  file_id: String,
+                  tools:
+                    T::Array[
+                      T.any(
+                        OpenAI::Beta::CodeInterpreterTool::OrHash,
+                        OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch::OrHash
+                      )
+                    ]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # The ID of the file to attach to the message.
+                file_id: nil,
+                # The tools to add this file to.
+                tools: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    file_id: String,
+                    tools:
+                      T::Array[
+                        T.any(
+                          OpenAI::Beta::CodeInterpreterTool,
+                          OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch
+                        )
+                      ]
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              module Tool
+                extend OpenAI::Internal::Type::Union
+
+                Variants =
+                  T.type_alias do
+                    T.any(
+                      OpenAI::Beta::CodeInterpreterTool,
+                      OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch
+                    )
+                  end
+
+                class FileSearch < OpenAI::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::FileSearch,
+                        OpenAI::Internal::AnyHash
+                      )
+                    end
+
+                  # The type of tool being defined: `file_search`
+                  sig { returns(Symbol) }
+                  attr_accessor :type
+
+                  sig { params(type: Symbol).returns(T.attached_class) }
+                  def self.new(
+                    # The type of tool being defined: `file_search`
+                    type: :file_search
+                  )
+                  end
+
+                  sig { override.returns({ type: Symbol }) }
+                  def to_hash
+                  end
+                end
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      OpenAI::Beta::Threads::RunCreateParams::AdditionalMessage::Attachment::Tool::Variants
+                    ]
+                  )
+                end
+                def self.variants
+                end
+              end
+            end
+          end
+
+          # The ID of the [Model](https://platform.openai.com/docs/api-reference/models) to
+          # be used to execute this run. If a value is provided here, it will override the
+          # model associated with the assistant. If not, the model associated with the
+          # assistant will be used.
+          module Model
+            extend OpenAI::Internal::Type::Union
+
+            Variants =
+              T.type_alias { T.any(String, OpenAI::ChatModel::TaggedSymbol) }
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Beta::Threads::RunCreateParams::Model::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
+          end
+
+          class TruncationStrategy < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Beta::Threads::RunCreateParams::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::RunCreateParams::TruncationStrategy::Type::OrSymbol
+              )
+            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::RunCreateParams::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::RunCreateParams::TruncationStrategy::Type::OrSymbol,
+                  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::RunCreateParams::TruncationStrategy::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              AUTO =
+                T.let(
+                  :auto,
+                  OpenAI::Beta::Threads::RunCreateParams::TruncationStrategy::Type::TaggedSymbol
+                )
+              LAST_MESSAGES =
+                T.let(
+                  :last_messages,
+                  OpenAI::Beta::Threads::RunCreateParams::TruncationStrategy::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Beta::Threads::RunCreateParams::TruncationStrategy::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end