llama-stack-client 0.2.16-rc1 → 0.2.17-rc1

package/resources/chat/completions.d.ts

@@ -82,7 +82,7 @@ export declare namespace CompletionCreateResponse {
                 /**
                  * The content of the message, which can include text and other media
                  */
-                content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam>;
+                content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam | OpenAIUserMessageParam.OpenAIFile>;
                 /**
                  * Must be "user" to identify this as a user message
                  */
@@ -93,20 +93,58 @@ export declare namespace CompletionCreateResponse {
                 name?: string;
             }
             namespace OpenAIUserMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface OpenAIChatCompletionContentPartTextParam {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
+                /**
+                 * Image content part for OpenAI-compatible chat completion messages.
+                 */
                 interface OpenAIChatCompletionContentPartImageParam {
+                    /**
+                     * Image URL specification and processing details
+                     */
                     image_url: OpenAIChatCompletionContentPartImageParam.ImageURL;
+                    /**
+                     * Must be "image_url" to identify this as image content
+                     */
                     type: 'image_url';
                 }
                 namespace OpenAIChatCompletionContentPartImageParam {
+                    /**
+                     * Image URL specification and processing details
+                     */
                     interface ImageURL {
+                        /**
+                         * URL of the image to include in the message
+                         */
                         url: string;
+                        /**
+                         * (Optional) Level of detail for image processing. Can be "low", "high", or "auto"
+                         */
                         detail?: string;
                     }
                 }
+                interface OpenAIFile {
+                    file: OpenAIFile.File;
+                    type: 'file';
+                }
+                namespace OpenAIFile {
+                    interface File {
+                        file_data?: string;
+                        file_id?: string;
+                        filename?: string;
+                    }
+                }
             }
             /**
              * A system message providing instructions or context to the model.
@@ -128,8 +166,17 @@ export declare namespace CompletionCreateResponse {
                 name?: string;
             }
             namespace OpenAISystemMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
             }
@@ -156,19 +203,52 @@ export declare namespace CompletionCreateResponse {
                 tool_calls?: Array<OpenAIAssistantMessageParam.ToolCall>;
             }
             namespace OpenAIAssistantMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
+                /**
+                 * Tool call specification for OpenAI-compatible chat completion responses.
+                 */
                 interface ToolCall {
+                    /**
+                     * Must be "function" to identify this as a function call
+                     */
                     type: 'function';
+                    /**
+                     * (Optional) Unique identifier for the tool call
+                     */
                     id?: string;
+                    /**
+                     * (Optional) Function call details
+                     */
                     function?: ToolCall.Function;
+                    /**
+                     * (Optional) Index of the tool call in the list
+                     */
                     index?: number;
                 }
                 namespace ToolCall {
+                    /**
+                     * (Optional) Function call details
+                     */
                     interface Function {
+                        /**
+                         * (Optional) Arguments to pass to the function as a JSON string
+                         */
                         arguments?: string;
+                        /**
+                         * (Optional) Name of the function to call
+                         */
                         name?: string;
                     }
                 }
@@ -192,8 +272,17 @@ export declare namespace CompletionCreateResponse {
                 tool_call_id: string;
             }
             namespace OpenAIToolMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
             }
@@ -215,8 +304,17 @@ export declare namespace CompletionCreateResponse {
                 name?: string;
             }
             namespace OpenAIDeveloperMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
             }
@@ -333,7 +431,7 @@ export declare namespace CompletionRetrieveResponse {
             /**
              * The content of the message, which can include text and other media
              */
-            content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam>;
+            content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam | OpenAIUserMessageParam.OpenAIFile>;
             /**
              * Must be "user" to identify this as a user message
              */
@@ -344,20 +442,58 @@ export declare namespace CompletionRetrieveResponse {
             name?: string;
         }
         namespace OpenAIUserMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface OpenAIChatCompletionContentPartTextParam {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
+            /**
+             * Image content part for OpenAI-compatible chat completion messages.
+             */
             interface OpenAIChatCompletionContentPartImageParam {
+                /**
+                 * Image URL specification and processing details
+                 */
                 image_url: OpenAIChatCompletionContentPartImageParam.ImageURL;
+                /**
+                 * Must be "image_url" to identify this as image content
+                 */
                 type: 'image_url';
             }
             namespace OpenAIChatCompletionContentPartImageParam {
+                /**
+                 * Image URL specification and processing details
+                 */
                 interface ImageURL {
+                    /**
+                     * URL of the image to include in the message
+                     */
                     url: string;
+                    /**
+                     * (Optional) Level of detail for image processing. Can be "low", "high", or "auto"
+                     */
                     detail?: string;
                 }
             }
+            interface OpenAIFile {
+                file: OpenAIFile.File;
+                type: 'file';
+            }
+            namespace OpenAIFile {
+                interface File {
+                    file_data?: string;
+                    file_id?: string;
+                    filename?: string;
+                }
+            }
         }
         /**
          * A system message providing instructions or context to the model.
@@ -379,8 +515,17 @@ export declare namespace CompletionRetrieveResponse {
             name?: string;
         }
         namespace OpenAISystemMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
         }
@@ -407,19 +552,52 @@ export declare namespace CompletionRetrieveResponse {
             tool_calls?: Array<OpenAIAssistantMessageParam.ToolCall>;
         }
         namespace OpenAIAssistantMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
+            /**
+             * Tool call specification for OpenAI-compatible chat completion responses.
+             */
             interface ToolCall {
+                /**
+                 * Must be "function" to identify this as a function call
+                 */
                 type: 'function';
+                /**
+                 * (Optional) Unique identifier for the tool call
+                 */
                 id?: string;
+                /**
+                 * (Optional) Function call details
+                 */
                 function?: ToolCall.Function;
+                /**
+                 * (Optional) Index of the tool call in the list
+                 */
                 index?: number;
             }
             namespace ToolCall {
+                /**
+                 * (Optional) Function call details
+                 */
                 interface Function {
+                    /**
+                     * (Optional) Arguments to pass to the function as a JSON string
+                     */
                     arguments?: string;
+                    /**
+                     * (Optional) Name of the function to call
+                     */
                     name?: string;
                 }
             }
@@ -443,8 +621,17 @@ export declare namespace CompletionRetrieveResponse {
             tool_call_id: string;
         }
         namespace OpenAIToolMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
         }
@@ -466,8 +653,17 @@ export declare namespace CompletionRetrieveResponse {
             name?: string;
         }
         namespace OpenAIDeveloperMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
         }
@@ -536,7 +732,7 @@ export declare namespace CompletionRetrieveResponse {
         /**
          * The content of the message, which can include text and other media
          */
-        content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam>;
+        content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam | OpenAIUserMessageParam.OpenAIFile>;
         /**
          * Must be "user" to identify this as a user message
          */
@@ -547,20 +743,58 @@ export declare namespace CompletionRetrieveResponse {
         name?: string;
     }
     namespace OpenAIUserMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface OpenAIChatCompletionContentPartTextParam {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
+        /**
+         * Image content part for OpenAI-compatible chat completion messages.
+         */
         interface OpenAIChatCompletionContentPartImageParam {
+            /**
+             * Image URL specification and processing details
+             */
             image_url: OpenAIChatCompletionContentPartImageParam.ImageURL;
+            /**
+             * Must be "image_url" to identify this as image content
+             */
             type: 'image_url';
         }
         namespace OpenAIChatCompletionContentPartImageParam {
+            /**
+             * Image URL specification and processing details
+             */
             interface ImageURL {
+                /**
+                 * URL of the image to include in the message
+                 */
                 url: string;
+                /**
+                 * (Optional) Level of detail for image processing. Can be "low", "high", or "auto"
+                 */
                 detail?: string;
             }
         }
+        interface OpenAIFile {
+            file: OpenAIFile.File;
+            type: 'file';
+        }
+        namespace OpenAIFile {
+            interface File {
+                file_data?: string;
+                file_id?: string;
+                filename?: string;
+            }
+        }
     }
     /**
      * A system message providing instructions or context to the model.
@@ -582,8 +816,17 @@ export declare namespace CompletionRetrieveResponse {
         name?: string;
     }
     namespace OpenAISystemMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
     }
@@ -610,19 +853,52 @@ export declare namespace CompletionRetrieveResponse {
         tool_calls?: Array<OpenAIAssistantMessageParam.ToolCall>;
     }
     namespace OpenAIAssistantMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
+        /**
+         * Tool call specification for OpenAI-compatible chat completion responses.
+         */
         interface ToolCall {
+            /**
+             * Must be "function" to identify this as a function call
+             */
             type: 'function';
+            /**
+             * (Optional) Unique identifier for the tool call
+             */
             id?: string;
+            /**
+             * (Optional) Function call details
+             */
             function?: ToolCall.Function;
+            /**
+             * (Optional) Index of the tool call in the list
+             */
             index?: number;
         }
         namespace ToolCall {
+            /**
+             * (Optional) Function call details
+             */
             interface Function {
+                /**
+                 * (Optional) Arguments to pass to the function as a JSON string
+                 */
                 arguments?: string;
+                /**
+                 * (Optional) Name of the function to call
+                 */
                 name?: string;
             }
         }
@@ -646,8 +922,17 @@ export declare namespace CompletionRetrieveResponse {
         tool_call_id: string;
     }
     namespace OpenAIToolMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
     }
@@ -669,17 +954,44 @@ export declare namespace CompletionRetrieveResponse {
         name?: string;
     }
     namespace OpenAIDeveloperMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
     }
 }
+/**
+ * Response from listing OpenAI-compatible chat completions.
+ */
 export interface CompletionListResponse {
+    /**
+     * List of chat completion objects with their input messages
+     */
     data: Array<CompletionListResponse.Data>;
+    /**
+     * ID of the first completion in this list
+     */
     first_id: string;
+    /**
+     * Whether there are more completions available beyond this list
+     */
     has_more: boolean;
+    /**
+     * ID of the last completion in this list
+     */
     last_id: string;
+    /**
+     * Must be "list" to identify this as a list response
+     */
     object: 'list';
 }
 export declare namespace CompletionListResponse {
@@ -736,7 +1048,7 @@ export declare namespace CompletionListResponse {
                 /**
                  * The content of the message, which can include text and other media
                  */
-                content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam>;
+                content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam | OpenAIUserMessageParam.OpenAIFile>;
                 /**
                  * Must be "user" to identify this as a user message
                  */
@@ -747,20 +1059,58 @@ export declare namespace CompletionListResponse {
                 name?: string;
             }
             namespace OpenAIUserMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface OpenAIChatCompletionContentPartTextParam {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
+                /**
+                 * Image content part for OpenAI-compatible chat completion messages.
+                 */
                 interface OpenAIChatCompletionContentPartImageParam {
+                    /**
+                     * Image URL specification and processing details
+                     */
                     image_url: OpenAIChatCompletionContentPartImageParam.ImageURL;
+                    /**
+                     * Must be "image_url" to identify this as image content
+                     */
                     type: 'image_url';
                 }
                 namespace OpenAIChatCompletionContentPartImageParam {
+                    /**
+                     * Image URL specification and processing details
+                     */
                     interface ImageURL {
+                        /**
+                         * URL of the image to include in the message
+                         */
                         url: string;
+                        /**
+                         * (Optional) Level of detail for image processing. Can be "low", "high", or "auto"
+                         */
                         detail?: string;
                     }
                 }
+                interface OpenAIFile {
+                    file: OpenAIFile.File;
+                    type: 'file';
+                }
+                namespace OpenAIFile {
+                    interface File {
+                        file_data?: string;
+                        file_id?: string;
+                        filename?: string;
+                    }
+                }
             }
             /**
              * A system message providing instructions or context to the model.
@@ -782,8 +1132,17 @@ export declare namespace CompletionListResponse {
                 name?: string;
             }
             namespace OpenAISystemMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
             }
@@ -810,19 +1169,52 @@ export declare namespace CompletionListResponse {
                 tool_calls?: Array<OpenAIAssistantMessageParam.ToolCall>;
             }
             namespace OpenAIAssistantMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
+                /**
+                 * Tool call specification for OpenAI-compatible chat completion responses.
+                 */
                 interface ToolCall {
+                    /**
+                     * Must be "function" to identify this as a function call
+                     */
                     type: 'function';
+                    /**
+                     * (Optional) Unique identifier for the tool call
+                     */
                     id?: string;
+                    /**
+                     * (Optional) Function call details
+                     */
                     function?: ToolCall.Function;
+                    /**
+                     * (Optional) Index of the tool call in the list
+                     */
                     index?: number;
                 }
                 namespace ToolCall {
+                    /**
+                     * (Optional) Function call details
+                     */
                     interface Function {
+                        /**
+                         * (Optional) Arguments to pass to the function as a JSON string
+                         */
                         arguments?: string;
+                        /**
+                         * (Optional) Name of the function to call
+                         */
                         name?: string;
                     }
                 }
@@ -846,8 +1238,17 @@ export declare namespace CompletionListResponse {
                 tool_call_id: string;
             }
             namespace OpenAIToolMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
             }
@@ -869,8 +1270,17 @@ export declare namespace CompletionListResponse {
                 name?: string;
             }
             namespace OpenAIDeveloperMessageParam {
+                /**
+                 * Text content part for OpenAI-compatible chat completion messages.
+                 */
                 interface UnionMember1 {
+                    /**
+                     * The text content of the message
+                     */
                     text: string;
+                    /**
+                     * Must be "text" to identify this as text content
+                     */
                     type: 'text';
                 }
             }
@@ -939,7 +1349,7 @@ export declare namespace CompletionListResponse {
             /**
              * The content of the message, which can include text and other media
              */
-            content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam>;
+            content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam | OpenAIUserMessageParam.OpenAIFile>;
             /**
              * Must be "user" to identify this as a user message
              */
@@ -950,20 +1360,58 @@ export declare namespace CompletionListResponse {
             name?: string;
         }
         namespace OpenAIUserMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface OpenAIChatCompletionContentPartTextParam {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
+            /**
+             * Image content part for OpenAI-compatible chat completion messages.
+             */
             interface OpenAIChatCompletionContentPartImageParam {
+                /**
+                 * Image URL specification and processing details
+                 */
                 image_url: OpenAIChatCompletionContentPartImageParam.ImageURL;
+                /**
+                 * Must be "image_url" to identify this as image content
+                 */
                 type: 'image_url';
             }
             namespace OpenAIChatCompletionContentPartImageParam {
+                /**
+                 * Image URL specification and processing details
+                 */
                 interface ImageURL {
+                    /**
+                     * URL of the image to include in the message
+                     */
                     url: string;
+                    /**
+                     * (Optional) Level of detail for image processing. Can be "low", "high", or "auto"
+                     */
                     detail?: string;
                 }
             }
+            interface OpenAIFile {
+                file: OpenAIFile.File;
+                type: 'file';
+            }
+            namespace OpenAIFile {
+                interface File {
+                    file_data?: string;
+                    file_id?: string;
+                    filename?: string;
+                }
+            }
         }
         /**
          * A system message providing instructions or context to the model.
@@ -985,8 +1433,17 @@ export declare namespace CompletionListResponse {
             name?: string;
         }
         namespace OpenAISystemMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
         }
@@ -1013,19 +1470,52 @@ export declare namespace CompletionListResponse {
             tool_calls?: Array<OpenAIAssistantMessageParam.ToolCall>;
         }
         namespace OpenAIAssistantMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
+            /**
+             * Tool call specification for OpenAI-compatible chat completion responses.
+             */
             interface ToolCall {
+                /**
+                 * Must be "function" to identify this as a function call
+                 */
                 type: 'function';
+                /**
+                 * (Optional) Unique identifier for the tool call
+                 */
                 id?: string;
+                /**
+                 * (Optional) Function call details
+                 */
                 function?: ToolCall.Function;
+                /**
+                 * (Optional) Index of the tool call in the list
+                 */
                 index?: number;
             }
             namespace ToolCall {
+                /**
+                 * (Optional) Function call details
+                 */
                 interface Function {
+                    /**
+                     * (Optional) Arguments to pass to the function as a JSON string
+                     */
                     arguments?: string;
+                    /**
+                     * (Optional) Name of the function to call
+                     */
                     name?: string;
                 }
             }
@@ -1049,8 +1539,17 @@ export declare namespace CompletionListResponse {
             tool_call_id: string;
         }
         namespace OpenAIToolMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
         }
@@ -1072,8 +1571,17 @@ export declare namespace CompletionListResponse {
             name?: string;
         }
         namespace OpenAIDeveloperMessageParam {
+            /**
+             * Text content part for OpenAI-compatible chat completion messages.
+             */
             interface UnionMember1 {
+                /**
+                 * The text content of the message
+                 */
                 text: string;
+                /**
+                 * Must be "text" to identify this as text content
+                 */
                 type: 'text';
             }
         }
@@ -1195,7 +1703,7 @@ export declare namespace CompletionCreateParams {
         /**
          * The content of the message, which can include text and other media
          */
-        content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam>;
+        content: string | Array<OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam | OpenAIUserMessageParam.OpenAIFile>;
         /**
          * Must be "user" to identify this as a user message
          */
@@ -1206,20 +1714,58 @@ export declare namespace CompletionCreateParams {
         name?: string;
     }
     namespace OpenAIUserMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface OpenAIChatCompletionContentPartTextParam {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
+        /**
+         * Image content part for OpenAI-compatible chat completion messages.
+         */
         interface OpenAIChatCompletionContentPartImageParam {
+            /**
+             * Image URL specification and processing details
+             */
             image_url: OpenAIChatCompletionContentPartImageParam.ImageURL;
+            /**
+             * Must be "image_url" to identify this as image content
+             */
             type: 'image_url';
         }
         namespace OpenAIChatCompletionContentPartImageParam {
+            /**
+             * Image URL specification and processing details
+             */
             interface ImageURL {
+                /**
+                 * URL of the image to include in the message
+                 */
                 url: string;
+                /**
+                 * (Optional) Level of detail for image processing. Can be "low", "high", or "auto"
+                 */
                 detail?: string;
             }
         }
+        interface OpenAIFile {
+            file: OpenAIFile.File;
+            type: 'file';
+        }
+        namespace OpenAIFile {
+            interface File {
+                file_data?: string;
+                file_id?: string;
+                filename?: string;
+            }
+        }
     }
     /**
      * A system message providing instructions or context to the model.
@@ -1241,8 +1787,17 @@ export declare namespace CompletionCreateParams {
         name?: string;
     }
     namespace OpenAISystemMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
     }
@@ -1269,19 +1824,52 @@ export declare namespace CompletionCreateParams {
         tool_calls?: Array<OpenAIAssistantMessageParam.ToolCall>;
     }
     namespace OpenAIAssistantMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
+        /**
+         * Tool call specification for OpenAI-compatible chat completion responses.
+         */
         interface ToolCall {
+            /**
+             * Must be "function" to identify this as a function call
+             */
             type: 'function';
+            /**
+             * (Optional) Unique identifier for the tool call
+             */
             id?: string;
+            /**
+             * (Optional) Function call details
+             */
             function?: ToolCall.Function;
+            /**
+             * (Optional) Index of the tool call in the list
+             */
             index?: number;
         }
         namespace ToolCall {
+            /**
+             * (Optional) Function call details
+             */
             interface Function {
+                /**
+                 * (Optional) Arguments to pass to the function as a JSON string
+                 */
                 arguments?: string;
+                /**
+                 * (Optional) Name of the function to call
+                 */
                 name?: string;
             }
         }
@@ -1305,8 +1893,17 @@ export declare namespace CompletionCreateParams {
         tool_call_id: string;
     }
     namespace OpenAIToolMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
     }
@@ -1328,29 +1925,74 @@ export declare namespace CompletionCreateParams {
         name?: string;
     }
     namespace OpenAIDeveloperMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         interface UnionMember1 {
+            /**
+             * The text content of the message
+             */
             text: string;
+            /**
+             * Must be "text" to identify this as text content
+             */
             type: 'text';
         }
     }
+    /**
+     * Text response format for OpenAI-compatible chat completion requests.
+     */
     interface OpenAIResponseFormatText {
+        /**
+         * Must be "text" to indicate plain text response format
+         */
         type: 'text';
     }
+    /**
+     * JSON schema response format for OpenAI-compatible chat completion requests.
+     */
     interface OpenAIResponseFormatJsonSchema {
+        /**
+         * The JSON schema specification for the response
+         */
         json_schema: OpenAIResponseFormatJsonSchema.JsonSchema;
+        /**
+         * Must be "json_schema" to indicate structured JSON response format
+         */
         type: 'json_schema';
     }
     namespace OpenAIResponseFormatJsonSchema {
+        /**
+         * The JSON schema specification for the response
+         */
         interface JsonSchema {
+            /**
+             * Name of the schema
+             */
             name: string;
+            /**
+             * (Optional) Description of the schema
+             */
             description?: string;
+            /**
+             * (Optional) The JSON schema definition
+             */
             schema?: {
                 [key: string]: boolean | number | string | Array<unknown> | unknown | null;
             };
+            /**
+             * (Optional) Whether to enforce strict adherence to the schema
+             */
             strict?: boolean;
         }
     }
+    /**
+     * JSON object response format for OpenAI-compatible chat completion requests.
+     */
     interface OpenAIResponseFormatJsonObject {
+        /**
+         * Must be "json_object" to indicate generic JSON object response format
+         */
         type: 'json_object';
     }
     type CompletionCreateParamsNonStreaming = CompletionsAPI.CompletionCreateParamsNonStreaming;