openai 4.35.0 → 4.37.0

package/resources/beta/threads/threads.d.ts

@@ -3,8 +3,8 @@ import { APIPromise } from 'openai/core';
 import { APIResource } from 'openai/resource';
 import { AssistantStream, ThreadCreateAndRunParamsBaseStream } from 'openai/lib/AssistantStream';
 import * as ThreadsAPI from 'openai/resources/beta/threads/threads';
-import * as AssistantsAPI from 'openai/resources/beta/assistants/assistants';
-import * as MessagesAPI from 'openai/resources/beta/threads/messages/messages';
+import * as AssistantsAPI from 'openai/resources/beta/assistants';
+import * as MessagesAPI from 'openai/resources/beta/threads/messages';
 import * as RunsAPI from 'openai/resources/beta/threads/runs/runs';
 import { Stream } from 'openai/streaming';
 export declare class Threads extends APIResource {
@@ -82,7 +82,7 @@ export interface AssistantToolChoice {
     /**
      * The type of the tool. If type is `function`, the function name must be set
      */
-    type: 'function' | 'code_interpreter' | 'retrieval';
+    type: 'function' | 'code_interpreter' | 'file_search';
     function?: AssistantToolChoiceFunction;
 }
 export interface AssistantToolChoiceFunction {
@@ -124,6 +124,44 @@ export interface Thread {
      * The object type, which is always `thread`.
      */
     object: 'thread';
+    /**
+     * A set of resources that are made available to the assistant's tools in this
+     * thread. The resources are specific to the type of tool. For example, the
+     * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+     * tool requires a list of vector store IDs.
+     */
+    tool_resources: Thread.ToolResources | null;
+}
+export declare namespace Thread {
+    /**
+     * A set of resources that are made available to the assistant's tools in this
+     * thread. The resources are specific to the type of tool. For example, the
+     * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+     * tool requires a list of vector store IDs.
+     */
+    interface ToolResources {
+        code_interpreter?: ToolResources.CodeInterpreter;
+        file_search?: ToolResources.FileSearch;
+    }
+    namespace ToolResources {
+        interface CodeInterpreter {
+            /**
+             * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+             * available to the `code_interpreter` tool. There can be a maximum of 20 files
+             * associated with the tool.
+             */
+            file_ids?: Array<string>;
+        }
+        interface FileSearch {
+            /**
+             * The
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * attached to this thread. There can be a maximum of 1 vector store attached to
+             * the thread.
+             */
+            vector_store_ids?: Array<string>;
+        }
+    }
 }
 export interface ThreadDeleted {
     id: string;
@@ -143,6 +181,13 @@ export interface ThreadCreateParams {
      * characters long.
      */
     metadata?: unknown | null;
+    /**
+     * A set of resources that are made available to the assistant's tools in this
+     * thread. The resources are specific to the type of tool. For example, the
+     * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+     * tool requires a list of vector store IDs.
+     */
+    tool_resources?: ThreadCreateParams.ToolResources | null;
 }
 export declare namespace ThreadCreateParams {
     interface Message {
@@ -160,12 +205,9 @@ export declare namespace ThreadCreateParams {
          */
         role: 'user' | 'assistant';
         /**
-         * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-         * the message should use. There can be a maximum of 10 files attached to a
-         * message. Useful for tools like `retrieval` and `code_interpreter` that can
-         * access and use files.
+         * A list of files attached to the message, and the tools they should be added to.
          */
-        file_ids?: Array<string>;
+        attachments?: Array<Message.Attachment> | null;
         /**
          * 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. Keys
@@ -174,6 +216,68 @@ export declare namespace ThreadCreateParams {
          */
         metadata?: unknown | null;
     }
+    namespace Message {
+        interface Attachment {
+            add_to?: Array<'file_search' | 'code_interpreter'>;
+            /**
+             * The ID of the file to attach to the message.
+             */
+            file_id?: string;
+        }
+    }
+    /**
+     * A set of resources that are made available to the assistant's tools in this
+     * thread. The resources are specific to the type of tool. For example, the
+     * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+     * tool requires a list of vector store IDs.
+     */
+    interface ToolResources {
+        code_interpreter?: ToolResources.CodeInterpreter;
+        file_search?: ToolResources.FileSearch;
+    }
+    namespace ToolResources {
+        interface CodeInterpreter {
+            /**
+             * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+             * available to the `code_interpreter` tool. There can be a maximum of 20 files
+             * associated with the tool.
+             */
+            file_ids?: Array<string>;
+        }
+        interface FileSearch {
+            /**
+             * The
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * attached to this thread. There can be a maximum of 1 vector store attached to
+             * the thread.
+             */
+            vector_store_ids?: Array<string>;
+            /**
+             * A helper to create a
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * with file_ids and attach it to this thread. There can be a maximum of 1 vector
+             * store attached to the thread.
+             */
+            vector_stores?: Array<FileSearch.VectorStore>;
+        }
+        namespace FileSearch {
+            interface VectorStore {
+                /**
+                 * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs to
+                 * add to the vector store. There can be a maximum of 10000 files in a vector
+                 * store.
+                 */
+                file_ids?: Array<string>;
+                /**
+                 * Set of 16 key-value pairs that can be attached to a vector store. This can be
+                 * useful for storing additional information about the vector store in a structured
+                 * format. Keys can be a maximum of 64 characters long and values can be a maxium
+                 * of 512 characters long.
+                 */
+                metadata?: unknown;
+            }
+        }
+    }
 }
 export interface ThreadUpdateParams {
     /**
@@ -183,6 +287,44 @@ export interface ThreadUpdateParams {
      * characters long.
      */
     metadata?: unknown | null;
+    /**
+     * A set of resources that are made available to the assistant's tools in this
+     * thread. The resources are specific to the type of tool. For example, the
+     * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+     * tool requires a list of vector store IDs.
+     */
+    tool_resources?: ThreadUpdateParams.ToolResources | null;
+}
+export declare namespace ThreadUpdateParams {
+    /**
+     * A set of resources that are made available to the assistant's tools in this
+     * thread. The resources are specific to the type of tool. For example, the
+     * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+     * tool requires a list of vector store IDs.
+     */
+    interface ToolResources {
+        code_interpreter?: ToolResources.CodeInterpreter;
+        file_search?: ToolResources.FileSearch;
+    }
+    namespace ToolResources {
+        interface CodeInterpreter {
+            /**
+             * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+             * available to the `code_interpreter` tool. There can be a maximum of 20 files
+             * associated with the tool.
+             */
+            file_ids?: Array<string>;
+        }
+        interface FileSearch {
+            /**
+             * The
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * attached to this thread. There can be a maximum of 1 vector store attached to
+             * the thread.
+             */
+            vector_store_ids?: Array<string>;
+        }
+    }
 }
 export type ThreadCreateAndRunParams = ThreadCreateAndRunParamsNonStreaming | ThreadCreateAndRunParamsStreaming;
 export interface ThreadCreateAndRunParamsBase {
@@ -201,7 +343,7 @@ export interface ThreadCreateAndRunParamsBase {
      * 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 `complete`. See
+     * completion tokens specified, the run will end with status `incomplete`. See
      * `incomplete_details` for more info.
      */
     max_completion_tokens?: number | null;
@@ -209,7 +351,7 @@ export interface ThreadCreateAndRunParamsBase {
      * 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 `complete`. See
+     * prompt tokens specified, the run will end with status `incomplete`. See
      * `incomplete_details` for more info.
      */
     max_prompt_tokens?: number | null;
@@ -269,11 +411,24 @@ export interface ThreadCreateAndRunParamsBase {
      * call that tool.
      */
     tool_choice?: AssistantToolChoiceOption | null;
+    /**
+     * A set of resources that are used by the assistant's tools. The resources are
+     * specific to the type of tool. For example, the `code_interpreter` tool requires
+     * a list of file IDs, while the `file_search` tool requires a list of vector store
+     * IDs.
+     */
+    tool_resources?: ThreadCreateAndRunParams.ToolResources | null;
     /**
      * Override the tools the assistant can use for this run. This is useful for
      * modifying the behavior on a per-run basis.
      */
-    tools?: Array<AssistantsAPI.CodeInterpreterTool | AssistantsAPI.RetrievalTool | AssistantsAPI.FunctionTool> | null;
+    tools?: Array<AssistantsAPI.CodeInterpreterTool | AssistantsAPI.FileSearchTool | AssistantsAPI.FunctionTool> | null;
+    /**
+     * 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.
+     */
+    top_p?: number | null;
     truncation_strategy?: ThreadCreateAndRunParams.TruncationStrategy | null;
 }
 export declare namespace ThreadCreateAndRunParams {
@@ -293,6 +448,13 @@ export declare namespace ThreadCreateAndRunParams {
          * characters long.
          */
         metadata?: unknown | null;
+        /**
+         * A set of resources that are made available to the assistant's tools in this
+         * thread. The resources are specific to the type of tool. For example, the
+         * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+         * tool requires a list of vector store IDs.
+         */
+        tool_resources?: Thread.ToolResources | null;
     }
     namespace Thread {
         interface Message {
@@ -310,12 +472,9 @@ export declare namespace ThreadCreateAndRunParams {
              */
             role: 'user' | 'assistant';
             /**
-             * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-             * the message should use. There can be a maximum of 10 files attached to a
-             * message. Useful for tools like `retrieval` and `code_interpreter` that can
-             * access and use files.
+             * A list of files attached to the message, and the tools they should be added to.
              */
-            file_ids?: Array<string>;
+            attachments?: Array<Message.Attachment> | null;
             /**
              * 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. Keys
@@ -324,6 +483,97 @@ export declare namespace ThreadCreateAndRunParams {
              */
             metadata?: unknown | null;
         }
+        namespace Message {
+            interface Attachment {
+                add_to?: Array<'file_search' | 'code_interpreter'>;
+                /**
+                 * The ID of the file to attach to the message.
+                 */
+                file_id?: string;
+            }
+        }
+        /**
+         * A set of resources that are made available to the assistant's tools in this
+         * thread. The resources are specific to the type of tool. For example, the
+         * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+         * tool requires a list of vector store IDs.
+         */
+        interface ToolResources {
+            code_interpreter?: ToolResources.CodeInterpreter;
+            file_search?: ToolResources.FileSearch;
+        }
+        namespace ToolResources {
+            interface CodeInterpreter {
+                /**
+                 * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+                 * available to the `code_interpreter` tool. There can be a maximum of 20 files
+                 * associated with the tool.
+                 */
+                file_ids?: Array<string>;
+            }
+            interface FileSearch {
+                /**
+                 * The
+                 * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+                 * attached to this thread. There can be a maximum of 1 vector store attached to
+                 * the thread.
+                 */
+                vector_store_ids?: Array<string>;
+                /**
+                 * A helper to create a
+                 * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+                 * with file_ids and attach it to this thread. There can be a maximum of 1 vector
+                 * store attached to the thread.
+                 */
+                vector_stores?: Array<FileSearch.VectorStore>;
+            }
+            namespace FileSearch {
+                interface VectorStore {
+                    /**
+                     * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs to
+                     * add to the vector store. There can be a maximum of 10000 files in a vector
+                     * store.
+                     */
+                    file_ids?: Array<string>;
+                    /**
+                     * Set of 16 key-value pairs that can be attached to a vector store. This can be
+                     * useful for storing additional information about the vector store in a structured
+                     * format. Keys can be a maximum of 64 characters long and values can be a maxium
+                     * of 512 characters long.
+                     */
+                    metadata?: unknown;
+                }
+            }
+        }
+    }
+    /**
+     * A set of resources that are used by the assistant's tools. The resources are
+     * specific to the type of tool. For example, the `code_interpreter` tool requires
+     * a list of file IDs, while the `file_search` tool requires a list of vector store
+     * IDs.
+     */
+    interface ToolResources {
+        code_interpreter?: ToolResources.CodeInterpreter;
+        file_search?: ToolResources.FileSearch;
+    }
+    namespace ToolResources {
+        interface CodeInterpreter {
+            /**
+             * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+             * available to the `code_interpreter` tool. There can be a maximum of 20 files
+             * associated with the tool.
+             */
+            file_ids?: Array<string>;
+        }
+        interface FileSearch {
+            /**
+             * The ID of the
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * attached to this assistant. There can be a maximum of 1 vector store attached to
+             * the assistant.
+             */
+            vector_store_ids?: Array<string>;
+        }
     }
     interface TruncationStrategy {
         /**
@@ -374,7 +624,7 @@ export interface ThreadCreateAndRunPollParams {
      * 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 `complete`. See
+     * completion tokens specified, the run will end with status `incomplete`. See
      * `incomplete_details` for more info.
      */
     max_completion_tokens?: number | null;
@@ -382,7 +632,7 @@ export interface ThreadCreateAndRunPollParams {
      * 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 `complete`. See
+     * prompt tokens specified, the run will end with status `incomplete`. See
      * `incomplete_details` for more info.
      */
     max_prompt_tokens?: number | null;
@@ -436,11 +686,24 @@ export interface ThreadCreateAndRunPollParams {
      * call that tool.
      */
     tool_choice?: AssistantToolChoiceOption | null;
+    /**
+     * A set of resources that are used by the assistant's tools. The resources are
+     * specific to the type of tool. For example, the `code_interpreter` tool requires
+     * a list of file IDs, while the `file_search` tool requires a list of vector store
+     * IDs.
+     */
+    tool_resources?: ThreadCreateAndRunPollParams.ToolResources | null;
     /**
      * Override the tools the assistant can use for this run. This is useful for
      * modifying the behavior on a per-run basis.
      */
-    tools?: Array<AssistantsAPI.CodeInterpreterTool | AssistantsAPI.RetrievalTool | AssistantsAPI.FunctionTool> | null;
+    tools?: Array<AssistantsAPI.CodeInterpreterTool | AssistantsAPI.FileSearchTool | AssistantsAPI.FunctionTool> | null;
+    /**
+     * 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.
+     */
+    top_p?: number | null;
     truncation_strategy?: ThreadCreateAndRunPollParams.TruncationStrategy | null;
 }
 export declare namespace ThreadCreateAndRunPollParams {
@@ -460,6 +723,13 @@ export declare namespace ThreadCreateAndRunPollParams {
          * characters long.
          */
         metadata?: unknown | null;
+        /**
+         * A set of resources that are made available to the assistant's tools in this
+         * thread. The resources are specific to the type of tool. For example, the
+         * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+         * tool requires a list of vector store IDs.
+         */
+        tool_resources?: Thread.ToolResources | null;
     }
     namespace Thread {
         interface Message {
@@ -477,12 +747,9 @@ export declare namespace ThreadCreateAndRunPollParams {
              */
             role: 'user' | 'assistant';
             /**
-             * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-             * the message should use. There can be a maximum of 10 files attached to a
-             * message. Useful for tools like `retrieval` and `code_interpreter` that can
-             * access and use files.
+             * A list of files attached to the message, and the tools they should be added to.
              */
-            file_ids?: Array<string>;
+            attachments?: Array<Message.Attachment> | null;
             /**
              * 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. Keys
@@ -491,6 +758,97 @@ export declare namespace ThreadCreateAndRunPollParams {
              */
             metadata?: unknown | null;
         }
+        namespace Message {
+            interface Attachment {
+                add_to?: Array<'file_search' | 'code_interpreter'>;
+                /**
+                 * The ID of the file to attach to the message.
+                 */
+                file_id?: string;
+            }
+        }
+        /**
+         * A set of resources that are made available to the assistant's tools in this
+         * thread. The resources are specific to the type of tool. For example, the
+         * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+         * tool requires a list of vector store IDs.
+         */
+        interface ToolResources {
+            code_interpreter?: ToolResources.CodeInterpreter;
+            file_search?: ToolResources.FileSearch;
+        }
+        namespace ToolResources {
+            interface CodeInterpreter {
+                /**
+                 * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+                 * available to the `code_interpreter` tool. There can be a maximum of 20 files
+                 * associated with the tool.
+                 */
+                file_ids?: Array<string>;
+            }
+            interface FileSearch {
+                /**
+                 * The
+                 * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+                 * attached to this thread. There can be a maximum of 1 vector store attached to
+                 * the thread.
+                 */
+                vector_store_ids?: Array<string>;
+                /**
+                 * A helper to create a
+                 * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+                 * with file_ids and attach it to this thread. There can be a maximum of 1 vector
+                 * store attached to the thread.
+                 */
+                vector_stores?: Array<FileSearch.VectorStore>;
+            }
+            namespace FileSearch {
+                interface VectorStore {
+                    /**
+                     * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs to
+                     * add to the vector store. There can be a maximum of 10000 files in a vector
+                     * store.
+                     */
+                    file_ids?: Array<string>;
+                    /**
+                     * Set of 16 key-value pairs that can be attached to a vector store. This can be
+                     * useful for storing additional information about the vector store in a structured
+                     * format. Keys can be a maximum of 64 characters long and values can be a maxium
+                     * of 512 characters long.
+                     */
+                    metadata?: unknown;
+                }
+            }
+        }
+    }
+    /**
+     * A set of resources that are used by the assistant's tools. The resources are
+     * specific to the type of tool. For example, the `code_interpreter` tool requires
+     * a list of file IDs, while the `file_search` tool requires a list of vector store
+     * IDs.
+     */
+    interface ToolResources {
+        code_interpreter?: ToolResources.CodeInterpreter;
+        file_search?: ToolResources.FileSearch;
+    }
+    namespace ToolResources {
+        interface CodeInterpreter {
+            /**
+             * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+             * available to the `code_interpreter` tool. There can be a maximum of 20 files
+             * associated with the tool.
+             */
+            file_ids?: Array<string>;
+        }
+        interface FileSearch {
+            /**
+             * The ID of the
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * attached to this assistant. There can be a maximum of 1 vector store attached to
+             * the assistant.
+             */
+            vector_store_ids?: Array<string>;
+        }
     }
     interface TruncationStrategy {
         /**
@@ -523,7 +881,7 @@ export interface ThreadCreateAndRunStreamParams {
      * 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 `complete`. See
+     * completion tokens specified, the run will end with status `incomplete`. See
      * `incomplete_details` for more info.
      */
     max_completion_tokens?: number | null;
@@ -531,7 +889,7 @@ export interface ThreadCreateAndRunStreamParams {
      * 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 `complete`. See
+     * prompt tokens specified, the run will end with status `incomplete`. See
      * `incomplete_details` for more info.
      */
     max_prompt_tokens?: number | null;
@@ -585,11 +943,24 @@ export interface ThreadCreateAndRunStreamParams {
      * call that tool.
      */
     tool_choice?: AssistantToolChoiceOption | null;
+    /**
+     * A set of resources that are used by the assistant's tools. The resources are
+     * specific to the type of tool. For example, the `code_interpreter` tool requires
+     * a list of file IDs, while the `file_search` tool requires a list of vector store
+     * IDs.
+     */
+    tool_resources?: ThreadCreateAndRunStreamParams.ToolResources | null;
     /**
      * Override the tools the assistant can use for this run. This is useful for
      * modifying the behavior on a per-run basis.
      */
-    tools?: Array<AssistantsAPI.CodeInterpreterTool | AssistantsAPI.RetrievalTool | AssistantsAPI.FunctionTool> | null;
+    tools?: Array<AssistantsAPI.CodeInterpreterTool | AssistantsAPI.FileSearchTool | AssistantsAPI.FunctionTool> | null;
+    /**
+     * 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.
+     */
+    top_p?: number | null;
     truncation_strategy?: ThreadCreateAndRunStreamParams.TruncationStrategy | null;
 }
 export declare namespace ThreadCreateAndRunStreamParams {
@@ -609,6 +980,13 @@ export declare namespace ThreadCreateAndRunStreamParams {
          * characters long.
          */
         metadata?: unknown | null;
+        /**
+         * A set of resources that are made available to the assistant's tools in this
+         * thread. The resources are specific to the type of tool. For example, the
+         * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+         * tool requires a list of vector store IDs.
+         */
+        tool_resources?: Thread.ToolResources | null;
     }
     namespace Thread {
         interface Message {
@@ -626,12 +1004,9 @@ export declare namespace ThreadCreateAndRunStreamParams {
              */
             role: 'user' | 'assistant';
             /**
-             * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-             * the message should use. There can be a maximum of 10 files attached to a
-             * message. Useful for tools like `retrieval` and `code_interpreter` that can
-             * access and use files.
+             * A list of files attached to the message, and the tools they should be added to.
              */
-            file_ids?: Array<string>;
+            attachments?: Array<Message.Attachment> | null;
             /**
              * 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. Keys
@@ -640,6 +1015,97 @@ export declare namespace ThreadCreateAndRunStreamParams {
              */
             metadata?: unknown | null;
         }
+        namespace Message {
+            interface Attachment {
+                add_to?: Array<'file_search' | 'code_interpreter'>;
+                /**
+                 * The ID of the file to attach to the message.
+                 */
+                file_id?: string;
+            }
+        }
+        /**
+         * A set of resources that are made available to the assistant's tools in this
+         * thread. The resources are specific to the type of tool. For example, the
+         * `code_interpreter` tool requires a list of file IDs, while the `file_search`
+         * tool requires a list of vector store IDs.
+         */
+        interface ToolResources {
+            code_interpreter?: ToolResources.CodeInterpreter;
+            file_search?: ToolResources.FileSearch;
+        }
+        namespace ToolResources {
+            interface CodeInterpreter {
+                /**
+                 * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+                 * available to the `code_interpreter` tool. There can be a maximum of 20 files
+                 * associated with the tool.
+                 */
+                file_ids?: Array<string>;
+            }
+            interface FileSearch {
+                /**
+                 * The
+                 * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+                 * attached to this thread. There can be a maximum of 1 vector store attached to
+                 * the thread.
+                 */
+                vector_store_ids?: Array<string>;
+                /**
+                 * A helper to create a
+                 * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+                 * with file_ids and attach it to this thread. There can be a maximum of 1 vector
+                 * store attached to the thread.
+                 */
+                vector_stores?: Array<FileSearch.VectorStore>;
+            }
+            namespace FileSearch {
+                interface VectorStore {
+                    /**
+                     * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs to
+                     * add to the vector store. There can be a maximum of 10000 files in a vector
+                     * store.
+                     */
+                    file_ids?: Array<string>;
+                    /**
+                     * Set of 16 key-value pairs that can be attached to a vector store. This can be
+                     * useful for storing additional information about the vector store in a structured
+                     * format. Keys can be a maximum of 64 characters long and values can be a maxium
+                     * of 512 characters long.
+                     */
+                    metadata?: unknown;
+                }
+            }
+        }
+    }
+    /**
+     * A set of resources that are used by the assistant's tools. The resources are
+     * specific to the type of tool. For example, the `code_interpreter` tool requires
+     * a list of file IDs, while the `file_search` tool requires a list of vector store
+     * IDs.
+     */
+    interface ToolResources {
+        code_interpreter?: ToolResources.CodeInterpreter;
+        file_search?: ToolResources.FileSearch;
+    }
+    namespace ToolResources {
+        interface CodeInterpreter {
+            /**
+             * A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+             * available to the `code_interpreter` tool. There can be a maximum of 20 files
+             * associated with the tool.
+             */
+            file_ids?: Array<string>;
+        }
+        interface FileSearch {
+            /**
+             * The ID of the
+             * [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+             * attached to this assistant. There can be a maximum of 1 vector store attached to
+             * the assistant.
+             */
+            vector_store_ids?: Array<string>;
+        }
     }
     interface TruncationStrategy {
         /**