docs: use @deprecated decorator for deprecated params (#711)

src/resources/chat/completions.ts

@@ -133,8 +133,8 @@ export interface ChatCompletionAssistantMessageParam {
   content?: string | null;
 
   /**
-   * Deprecated and replaced by `tool_calls`. The name and arguments of a function
-   * that should be called, as generated by the model.
+   * @deprecated: Deprecated and replaced by `tool_calls`. The name and arguments of
+   * a function that should be called, as generated by the model.
    */
   function_call?: ChatCompletionAssistantMessageParam.FunctionCall;
 
@@ -152,8 +152,8 @@ export interface ChatCompletionAssistantMessageParam {
 
 export namespace ChatCompletionAssistantMessageParam {
   /**
-   * Deprecated and replaced by `tool_calls`. The name and arguments of a function
-   * that should be called, as generated by the model.
+   * @deprecated: Deprecated and replaced by `tool_calls`. The name and arguments of
+   * a function that should be called, as generated by the model.
    */
   export interface FunctionCall {
     /**
@@ -250,8 +250,8 @@ export namespace ChatCompletionChunk {
       content?: string | null;
 
       /**
-       * Deprecated and replaced by `tool_calls`. The name and arguments of a function
-       * that should be called, as generated by the model.
+       * @deprecated: Deprecated and replaced by `tool_calls`. The name and arguments of
+       * a function that should be called, as generated by the model.
        */
       function_call?: Delta.FunctionCall;
 
@@ -265,8 +265,8 @@ export namespace ChatCompletionChunk {
 
     export namespace Delta {
       /**
-       * Deprecated and replaced by `tool_calls`. The name and arguments of a function
-       * that should be called, as generated by the model.
+       * @deprecated: Deprecated and replaced by `tool_calls`. The name and arguments of
+       * a function that should be called, as generated by the model.
        */
       export interface FunctionCall {
         /**
@@ -378,6 +378,9 @@ export interface ChatCompletionFunctionCallOption {
   name: string;
 }
 
+/**
+ * @deprecated
+ */
 export interface ChatCompletionFunctionMessageParam {
   /**
    * The contents of the function message.
@@ -410,8 +413,8 @@ export interface ChatCompletionMessage {
   role: 'assistant';
 
   /**
-   * Deprecated and replaced by `tool_calls`. The name and arguments of a function
-   * that should be called, as generated by the model.
+   * @deprecated: Deprecated and replaced by `tool_calls`. The name and arguments of
+   * a function that should be called, as generated by the model.
    */
   function_call?: ChatCompletionMessage.FunctionCall;
 
@@ -423,8 +426,8 @@ export interface ChatCompletionMessage {
 
 export namespace ChatCompletionMessage {
   /**
-   * Deprecated and replaced by `tool_calls`. The name and arguments of a function
-   * that should be called, as generated by the model.
+   * @deprecated: Deprecated and replaced by `tool_calls`. The name and arguments of
+   * a function that should be called, as generated by the model.
    */
   export interface FunctionCall {
     /**
@@ -855,6 +858,9 @@ export interface ChatCompletionCreateParamsBase {
 }
 
 export namespace ChatCompletionCreateParams {
+  /**
+   * @deprecated
+   */
   export interface Function {
     /**
      * The name of the function to be called. Must be a-z, A-Z, 0-9, or contain

src/resources/files.ts

@@ -154,14 +154,14 @@ export interface FileObject {
   purpose: 'fine-tune' | 'fine-tune-results' | 'assistants' | 'assistants_output';
 
   /**
-   * Deprecated. The current status of the file, which can be either `uploaded`,
-   * `processed`, or `error`.
+   * @deprecated: Deprecated. The current status of the file, which can be either
+   * `uploaded`, `processed`, or `error`.
    */
   status: 'uploaded' | 'processed' | 'error';
 
   /**
-   * Deprecated. For details on why a fine-tuning training file failed validation,
-   * see the `error` field on `fine_tuning.job`.
+   * @deprecated: Deprecated. For details on why a fine-tuning training file failed
+   * validation, see the `error` field on `fine_tuning.job`.
    */
   status_details?: string;
 }