feat: support deprecated markers (#178)

chatcompletion.go

@@ -322,6 +322,8 @@ type ChatCompletionAssistantMessageParam struct {
 	Content param.Field[[]ChatCompletionAssistantMessageParamContentUnion] `json:"content"`
 	// Deprecated and replaced by `tool_calls`. The name and arguments of a function
 	// that should be called, as generated by the model.
+	//
+	// Deprecated: deprecated
 	FunctionCall param.Field[ChatCompletionAssistantMessageParamFunctionCall] `json:"function_call"`
 	// An optional name for the participant. Provides the model information to
 	// differentiate between participants of the same role.
@@ -410,6 +412,8 @@ func (r ChatCompletionAssistantMessageParamContentType) IsKnown() bool {
 
 // Deprecated and replaced by `tool_calls`. The name and arguments of a function
 // that should be called, as generated by the model.
+//
+// Deprecated: deprecated
 type ChatCompletionAssistantMessageParamFunctionCall struct {
 	// The arguments to call the function with, as generated by the model in JSON
 	// format. Note that the model does not always generate valid JSON, and may
@@ -617,6 +621,8 @@ type ChatCompletionChunkChoicesDelta struct {
 	Content string `json:"content,nullable"`
 	// Deprecated and replaced by `tool_calls`. The name and arguments of a function
 	// that should be called, as generated by the model.
+	//
+	// Deprecated: deprecated
 	FunctionCall ChatCompletionChunkChoicesDeltaFunctionCall `json:"function_call"`
 	// The refusal message generated by the model.
 	Refusal string `json:"refusal,nullable"`
@@ -648,6 +654,8 @@ func (r chatCompletionChunkChoicesDeltaJSON) RawJSON() string {
 
 // Deprecated and replaced by `tool_calls`. The name and arguments of a function
 // that should be called, as generated by the model.
+//
+// Deprecated: deprecated
 type ChatCompletionChunkChoicesDeltaFunctionCall struct {
 	// The arguments to call the function with, as generated by the model in JSON
 	// format. Note that the model does not always generate valid JSON, and may
@@ -1114,6 +1122,7 @@ func (r ChatCompletionFunctionCallOptionParam) MarshalJSON() (data []byte, err e
 
 func (r ChatCompletionFunctionCallOptionParam) implementsChatCompletionNewParamsFunctionCallUnion() {}
 
+// Deprecated: deprecated
 type ChatCompletionFunctionMessageParam struct {
 	// The contents of the function message.
 	Content param.Field[string] `json:"content,required"`
@@ -1158,6 +1167,8 @@ type ChatCompletionMessage struct {
 	Audio ChatCompletionAudio `json:"audio,nullable"`
 	// Deprecated and replaced by `tool_calls`. The name and arguments of a function
 	// that should be called, as generated by the model.
+	//
+	// Deprecated: deprecated
 	FunctionCall ChatCompletionMessageFunctionCall `json:"function_call"`
 	// The tool calls generated by the model, such as function calls.
 	ToolCalls []ChatCompletionMessageToolCall `json:"tool_calls"`
@@ -1227,6 +1238,8 @@ func (r ChatCompletionMessageRole) IsKnown() bool {
 
 // Deprecated and replaced by `tool_calls`. The name and arguments of a function
 // that should be called, as generated by the model.
+//
+// Deprecated: deprecated
 type ChatCompletionMessageFunctionCall struct {
 	// The arguments to call the function with, as generated by the model in JSON
 	// format. Note that the model does not always generate valid JSON, and may
@@ -1968,6 +1981,8 @@ func (r ChatCompletionNewParams) MarshalJSON() (data []byte, err error) {
 //
 // Satisfied by [ChatCompletionNewParamsFunctionCallBehavior],
 // [ChatCompletionFunctionCallOptionParam].
+//
+// Deprecated: deprecated
 type ChatCompletionNewParamsFunctionCallUnion interface {
 	implementsChatCompletionNewParamsFunctionCallUnion()
 }
@@ -1993,6 +2008,7 @@ func (r ChatCompletionNewParamsFunctionCallBehavior) IsKnown() bool {
 func (r ChatCompletionNewParamsFunctionCallBehavior) implementsChatCompletionNewParamsFunctionCallUnion() {
 }
 
+// Deprecated: deprecated
 type ChatCompletionNewParamsFunction struct {
 	// The name of the function to be called. Must be a-z, A-Z, 0-9, or contain
 	// underscores and dashes, with a maximum length of 64.

file.go

@@ -200,9 +200,13 @@ type FileObject struct {
 	Purpose FileObjectPurpose `json:"purpose,required"`
 	// Deprecated. The current status of the file, which can be either `uploaded`,
 	// `processed`, or `error`.
+	//
+	// Deprecated: deprecated
 	Status FileObjectStatus `json:"status,required"`
 	// Deprecated. For details on why a fine-tuning training file failed validation,
 	// see the `error` field on `fine_tuning.job`.
+	//
+	// Deprecated: deprecated
 	StatusDetails string         `json:"status_details"`
 	JSON          fileObjectJSON `json:"-"`
 }

finetuningjob.go

@@ -1139,6 +1139,8 @@ func (r FineTuningJobNewParamsModel) IsKnown() bool {
 
 // The hyperparameters used for the fine-tuning job. This value is now deprecated
 // in favor of `method`, and should be passed in under the `method` parameter.
+//
+// Deprecated: deprecated
 type FineTuningJobNewParamsHyperparameters struct {
 	// Number of examples in each batch. A larger batch size means that model
 	// parameters are updated less frequently, but with lower variance.