llama-stack-client 0.2.16 → 0.2.17-rc1

package/src/resources/chat/completions.ts

@@ -141,6 +141,7 @@ export namespace CompletionCreateResponse {
           | Array<
               | OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam
               | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam
+              | OpenAIUserMessageParam.OpenAIFile
             >;
 
         /**
@@ -155,25 +156,68 @@ export namespace CompletionCreateResponse {
       }
 
       export namespace OpenAIUserMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export 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.
+         */
         export 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';
         }
 
         export namespace OpenAIChatCompletionContentPartImageParam {
+          /**
+           * Image URL specification and processing details
+           */
           export 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;
           }
         }
+
+        export interface OpenAIFile {
+          file: OpenAIFile.File;
+
+          type: 'file';
+        }
+
+        export namespace OpenAIFile {
+          export interface File {
+            file_data?: string;
+
+            file_id?: string;
+
+            filename?: string;
+          }
+        }
       }
 
       /**
@@ -199,9 +243,18 @@ export namespace CompletionCreateResponse {
       }
 
       export namespace OpenAISystemMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export interface UnionMember1 {
+          /**
+           * The text content of the message
+           */
           text: string;
 
+          /**
+           * Must be "text" to identify this as text content
+           */
           type: 'text';
         }
       }
@@ -233,26 +286,59 @@ export namespace CompletionCreateResponse {
       }
 
       export namespace OpenAIAssistantMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export 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.
+         */
         export 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;
         }
 
         export namespace ToolCall {
+          /**
+           * (Optional) Function call details
+           */
           export interface Function {
+            /**
+             * (Optional) Arguments to pass to the function as a JSON string
+             */
             arguments?: string;
 
+            /**
+             * (Optional) Name of the function to call
+             */
             name?: string;
           }
         }
@@ -280,9 +366,18 @@ export namespace CompletionCreateResponse {
       }
 
       export namespace OpenAIToolMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export interface UnionMember1 {
+          /**
+           * The text content of the message
+           */
           text: string;
 
+          /**
+           * Must be "text" to identify this as text content
+           */
           type: 'text';
         }
       }
@@ -308,9 +403,18 @@ export namespace CompletionCreateResponse {
       }
 
       export namespace OpenAIDeveloperMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export interface UnionMember1 {
+          /**
+           * The text content of the message
+           */
           text: string;
 
+          /**
+           * Must be "text" to identify this as text content
+           */
           type: 'text';
         }
       }
@@ -470,6 +574,7 @@ export namespace CompletionRetrieveResponse {
         | Array<
             | OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam
             | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam
+            | OpenAIUserMessageParam.OpenAIFile
           >;
 
       /**
@@ -484,25 +589,68 @@ export namespace CompletionRetrieveResponse {
     }
 
     export namespace OpenAIUserMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export 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.
+       */
       export 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';
       }
 
       export namespace OpenAIChatCompletionContentPartImageParam {
+        /**
+         * Image URL specification and processing details
+         */
         export 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;
         }
       }
+
+      export interface OpenAIFile {
+        file: OpenAIFile.File;
+
+        type: 'file';
+      }
+
+      export namespace OpenAIFile {
+        export interface File {
+          file_data?: string;
+
+          file_id?: string;
+
+          filename?: string;
+        }
+      }
     }
 
     /**
@@ -528,9 +676,18 @@ export namespace CompletionRetrieveResponse {
     }
 
     export namespace OpenAISystemMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export interface UnionMember1 {
+        /**
+         * The text content of the message
+         */
         text: string;
 
+        /**
+         * Must be "text" to identify this as text content
+         */
         type: 'text';
       }
     }
@@ -562,26 +719,59 @@ export namespace CompletionRetrieveResponse {
     }
 
     export namespace OpenAIAssistantMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export 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.
+       */
       export 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;
       }
 
       export namespace ToolCall {
+        /**
+         * (Optional) Function call details
+         */
         export interface Function {
+          /**
+           * (Optional) Arguments to pass to the function as a JSON string
+           */
           arguments?: string;
 
+          /**
+           * (Optional) Name of the function to call
+           */
           name?: string;
         }
       }
@@ -609,9 +799,18 @@ export namespace CompletionRetrieveResponse {
     }
 
     export namespace OpenAIToolMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export interface UnionMember1 {
+        /**
+         * The text content of the message
+         */
         text: string;
 
+        /**
+         * Must be "text" to identify this as text content
+         */
         type: 'text';
       }
     }
@@ -637,9 +836,18 @@ export namespace CompletionRetrieveResponse {
     }
 
     export namespace OpenAIDeveloperMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export interface UnionMember1 {
+        /**
+         * The text content of the message
+         */
         text: string;
 
+        /**
+         * Must be "text" to identify this as text content
+         */
         type: 'text';
       }
     }
@@ -730,6 +938,7 @@ export namespace CompletionRetrieveResponse {
       | Array<
           | OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam
           | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam
+          | OpenAIUserMessageParam.OpenAIFile
         >;
 
     /**
@@ -744,25 +953,68 @@ export namespace CompletionRetrieveResponse {
   }
 
   export namespace OpenAIUserMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export 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.
+     */
     export 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';
     }
 
     export namespace OpenAIChatCompletionContentPartImageParam {
+      /**
+       * Image URL specification and processing details
+       */
       export 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;
       }
     }
+
+    export interface OpenAIFile {
+      file: OpenAIFile.File;
+
+      type: 'file';
+    }
+
+    export namespace OpenAIFile {
+      export interface File {
+        file_data?: string;
+
+        file_id?: string;
+
+        filename?: string;
+      }
+    }
   }
 
   /**
@@ -788,9 +1040,18 @@ export namespace CompletionRetrieveResponse {
   }
 
   export namespace OpenAISystemMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export interface UnionMember1 {
+      /**
+       * The text content of the message
+       */
       text: string;
 
+      /**
+       * Must be "text" to identify this as text content
+       */
       type: 'text';
     }
   }
@@ -822,26 +1083,59 @@ export namespace CompletionRetrieveResponse {
   }
 
   export namespace OpenAIAssistantMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export 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.
+     */
     export 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;
     }
 
     export namespace ToolCall {
+      /**
+       * (Optional) Function call details
+       */
       export interface Function {
+        /**
+         * (Optional) Arguments to pass to the function as a JSON string
+         */
         arguments?: string;
 
+        /**
+         * (Optional) Name of the function to call
+         */
         name?: string;
       }
     }
@@ -869,9 +1163,18 @@ export namespace CompletionRetrieveResponse {
   }
 
   export namespace OpenAIToolMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export interface UnionMember1 {
+      /**
+       * The text content of the message
+       */
       text: string;
 
+      /**
+       * Must be "text" to identify this as text content
+       */
       type: 'text';
     }
   }
@@ -897,23 +1200,50 @@ export namespace CompletionRetrieveResponse {
   }
 
   export namespace OpenAIDeveloperMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export 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';
 }
 
@@ -997,6 +1327,7 @@ export namespace CompletionListResponse {
           | Array<
               | OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam
               | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam
+              | OpenAIUserMessageParam.OpenAIFile
             >;
 
         /**
@@ -1011,25 +1342,68 @@ export namespace CompletionListResponse {
       }
 
       export namespace OpenAIUserMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export 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.
+         */
         export 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';
         }
 
         export namespace OpenAIChatCompletionContentPartImageParam {
+          /**
+           * Image URL specification and processing details
+           */
           export 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;
           }
         }
+
+        export interface OpenAIFile {
+          file: OpenAIFile.File;
+
+          type: 'file';
+        }
+
+        export namespace OpenAIFile {
+          export interface File {
+            file_data?: string;
+
+            file_id?: string;
+
+            filename?: string;
+          }
+        }
       }
 
       /**
@@ -1055,9 +1429,18 @@ export namespace CompletionListResponse {
       }
 
       export namespace OpenAISystemMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export interface UnionMember1 {
+          /**
+           * The text content of the message
+           */
           text: string;
 
+          /**
+           * Must be "text" to identify this as text content
+           */
           type: 'text';
         }
       }
@@ -1089,26 +1472,59 @@ export namespace CompletionListResponse {
       }
 
       export namespace OpenAIAssistantMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export 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.
+         */
         export 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;
         }
 
         export namespace ToolCall {
+          /**
+           * (Optional) Function call details
+           */
           export interface Function {
+            /**
+             * (Optional) Arguments to pass to the function as a JSON string
+             */
             arguments?: string;
 
+            /**
+             * (Optional) Name of the function to call
+             */
             name?: string;
           }
         }
@@ -1136,9 +1552,18 @@ export namespace CompletionListResponse {
       }
 
       export namespace OpenAIToolMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export interface UnionMember1 {
+          /**
+           * The text content of the message
+           */
           text: string;
 
+          /**
+           * Must be "text" to identify this as text content
+           */
           type: 'text';
         }
       }
@@ -1164,9 +1589,18 @@ export namespace CompletionListResponse {
       }
 
       export namespace OpenAIDeveloperMessageParam {
+        /**
+         * Text content part for OpenAI-compatible chat completion messages.
+         */
         export interface UnionMember1 {
+          /**
+           * The text content of the message
+           */
           text: string;
 
+          /**
+           * Must be "text" to identify this as text content
+           */
           type: 'text';
         }
       }
@@ -1257,6 +1691,7 @@ export namespace CompletionListResponse {
         | Array<
             | OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam
             | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam
+            | OpenAIUserMessageParam.OpenAIFile
           >;
 
       /**
@@ -1271,25 +1706,68 @@ export namespace CompletionListResponse {
     }
 
     export namespace OpenAIUserMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export 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.
+       */
       export 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';
       }
 
       export namespace OpenAIChatCompletionContentPartImageParam {
+        /**
+         * Image URL specification and processing details
+         */
         export 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;
         }
       }
+
+      export interface OpenAIFile {
+        file: OpenAIFile.File;
+
+        type: 'file';
+      }
+
+      export namespace OpenAIFile {
+        export interface File {
+          file_data?: string;
+
+          file_id?: string;
+
+          filename?: string;
+        }
+      }
     }
 
     /**
@@ -1315,9 +1793,18 @@ export namespace CompletionListResponse {
     }
 
     export namespace OpenAISystemMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export interface UnionMember1 {
+        /**
+         * The text content of the message
+         */
         text: string;
 
+        /**
+         * Must be "text" to identify this as text content
+         */
         type: 'text';
       }
     }
@@ -1349,26 +1836,59 @@ export namespace CompletionListResponse {
     }
 
     export namespace OpenAIAssistantMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export 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.
+       */
       export 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;
       }
 
       export namespace ToolCall {
+        /**
+         * (Optional) Function call details
+         */
         export interface Function {
+          /**
+           * (Optional) Arguments to pass to the function as a JSON string
+           */
           arguments?: string;
 
+          /**
+           * (Optional) Name of the function to call
+           */
           name?: string;
         }
       }
@@ -1396,9 +1916,18 @@ export namespace CompletionListResponse {
     }
 
     export namespace OpenAIToolMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export interface UnionMember1 {
+        /**
+         * The text content of the message
+         */
         text: string;
 
+        /**
+         * Must be "text" to identify this as text content
+         */
         type: 'text';
       }
     }
@@ -1424,9 +1953,18 @@ export namespace CompletionListResponse {
     }
 
     export namespace OpenAIDeveloperMessageParam {
+      /**
+       * Text content part for OpenAI-compatible chat completion messages.
+       */
       export interface UnionMember1 {
+        /**
+         * The text content of the message
+         */
         text: string;
 
+        /**
+         * Must be "text" to identify this as text content
+         */
         type: 'text';
       }
     }
@@ -1575,6 +2113,7 @@ export namespace CompletionCreateParams {
       | Array<
           | OpenAIUserMessageParam.OpenAIChatCompletionContentPartTextParam
           | OpenAIUserMessageParam.OpenAIChatCompletionContentPartImageParam
+          | OpenAIUserMessageParam.OpenAIFile
         >;
 
     /**
@@ -1589,25 +2128,68 @@ export namespace CompletionCreateParams {
   }
 
   export namespace OpenAIUserMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export 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.
+     */
     export 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';
     }
 
     export namespace OpenAIChatCompletionContentPartImageParam {
+      /**
+       * Image URL specification and processing details
+       */
       export 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;
       }
     }
+
+    export interface OpenAIFile {
+      file: OpenAIFile.File;
+
+      type: 'file';
+    }
+
+    export namespace OpenAIFile {
+      export interface File {
+        file_data?: string;
+
+        file_id?: string;
+
+        filename?: string;
+      }
+    }
   }
 
   /**
@@ -1633,9 +2215,18 @@ export namespace CompletionCreateParams {
   }
 
   export namespace OpenAISystemMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export interface UnionMember1 {
+      /**
+       * The text content of the message
+       */
       text: string;
 
+      /**
+       * Must be "text" to identify this as text content
+       */
       type: 'text';
     }
   }
@@ -1667,26 +2258,59 @@ export namespace CompletionCreateParams {
   }
 
   export namespace OpenAIAssistantMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export 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.
+     */
     export 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;
     }
 
     export namespace ToolCall {
+      /**
+       * (Optional) Function call details
+       */
       export interface Function {
+        /**
+         * (Optional) Arguments to pass to the function as a JSON string
+         */
         arguments?: string;
 
+        /**
+         * (Optional) Name of the function to call
+         */
         name?: string;
       }
     }
@@ -1714,9 +2338,18 @@ export namespace CompletionCreateParams {
   }
 
   export namespace OpenAIToolMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export interface UnionMember1 {
+      /**
+       * The text content of the message
+       */
       text: string;
 
+      /**
+       * Must be "text" to identify this as text content
+       */
       type: 'text';
     }
   }
@@ -1742,36 +2375,81 @@ export namespace CompletionCreateParams {
   }
 
   export namespace OpenAIDeveloperMessageParam {
+    /**
+     * Text content part for OpenAI-compatible chat completion messages.
+     */
     export 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.
+   */
   export interface OpenAIResponseFormatText {
+    /**
+     * Must be "text" to indicate plain text response format
+     */
     type: 'text';
   }
 
+  /**
+   * JSON schema response format for OpenAI-compatible chat completion requests.
+   */
   export 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';
   }
 
   export namespace OpenAIResponseFormatJsonSchema {
+    /**
+     * The JSON schema specification for the response
+     */
     export 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.
+   */
   export interface OpenAIResponseFormatJsonObject {
+    /**
+     * Must be "json_object" to indicate generic JSON object response format
+     */
     type: 'json_object';
   }