feat(api): add file_url, fix event ID

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 97
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a473967d1766dc155994d932fbc4a5bcbd1c140a37c20d0a4065e1bf0640536d.yml
-openapi_spec_hash: 67cdc62b0d6c8b1de29b7dc54b265749
-config_hash: 7b53f96f897ca1b3407a5341a6f820db
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-2d116cda53321baa3479e628512def723207a81eb1cdaebb542bd0555e563bda.yml
+openapi_spec_hash: 809d958fec261a32004a4b026b718793
+config_hash: e74d6791681e3af1b548748ff47a22c2

audiotranscription.go

@@ -130,14 +130,14 @@ type TranscriptionUsageUnion struct {
 	// This field is from variant [TranscriptionUsageTokens].
 	InputTokenDetails TranscriptionUsageTokensInputTokenDetails `json:"input_token_details"`
 	// This field is from variant [TranscriptionUsageDuration].
-	Duration float64 `json:"duration"`
-	JSON     struct {
+	Seconds float64 `json:"seconds"`
+	JSON    struct {
 		InputTokens       respjson.Field
 		OutputTokens      respjson.Field
 		TotalTokens       respjson.Field
 		Type              respjson.Field
 		InputTokenDetails respjson.Field
-		Duration          respjson.Field
+		Seconds           respjson.Field
 		raw               string
 	} `json:"-"`
 }
@@ -241,12 +241,12 @@ func (r *TranscriptionUsageTokensInputTokenDetails) UnmarshalJSON(data []byte) e
 // Usage statistics for models billed by audio input duration.
 type TranscriptionUsageDuration struct {
 	// Duration of the input audio in seconds.
-	Duration float64 `json:"duration,required"`
+	Seconds float64 `json:"seconds,required"`
 	// The type of the usage object. Always `duration` for this variant.
 	Type constant.Duration `json:"type,required"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
-		Duration    respjson.Field
+		Seconds     respjson.Field
 		Type        respjson.Field
 		ExtraFields map[string]respjson.Field
 		raw         string

file.go

@@ -163,11 +163,11 @@ type FileObject struct {
 	// The object type, which is always `file`.
 	Object constant.File `json:"object,required"`
 	// The intended purpose of the file. Supported values are `assistants`,
-	// `assistants_output`, `batch`, `batch_output`, `fine-tune`, `fine-tune-results`
-	// and `vision`.
+	// `assistants_output`, `batch`, `batch_output`, `fine-tune`, `fine-tune-results`,
+	// `vision`, and `user_data`.
 	//
 	// Any of "assistants", "assistants_output", "batch", "batch_output", "fine-tune",
-	// "fine-tune-results", "vision".
+	// "fine-tune-results", "vision", "user_data".
 	Purpose FileObjectPurpose `json:"purpose,required"`
 	// Deprecated. The current status of the file, which can be either `uploaded`,
 	// `processed`, or `error`.
@@ -206,8 +206,8 @@ func (r *FileObject) UnmarshalJSON(data []byte) error {
 }
 
 // The intended purpose of the file. Supported values are `assistants`,
-// `assistants_output`, `batch`, `batch_output`, `fine-tune`, `fine-tune-results`
-// and `vision`.
+// `assistants_output`, `batch`, `batch_output`, `fine-tune`, `fine-tune-results`,
+// `vision`, and `user_data`.
 type FileObjectPurpose string
 
 const (
@@ -218,6 +218,7 @@ const (
 	FileObjectPurposeFineTune         FileObjectPurpose = "fine-tune"
 	FileObjectPurposeFineTuneResults  FileObjectPurpose = "fine-tune-results"
 	FileObjectPurposeVision           FileObjectPurpose = "vision"
+	FileObjectPurposeUserData         FileObjectPurpose = "user_data"
 )
 
 // Deprecated. The current status of the file, which can be either `uploaded`,

responses/response.go

@@ -4381,6 +4381,8 @@ type ResponseInputContentUnion struct {
 	// This field is from variant [ResponseInputFile].
 	FileData string `json:"file_data"`
 	// This field is from variant [ResponseInputFile].
+	FileURL string `json:"file_url"`
+	// This field is from variant [ResponseInputFile].
 	Filename string `json:"filename"`
 	JSON     struct {
 		Text     respjson.Field
@@ -4389,6 +4391,7 @@ type ResponseInputContentUnion struct {
 		FileID   respjson.Field
 		ImageURL respjson.Field
 		FileData respjson.Field
+		FileURL  respjson.Field
 		Filename respjson.Field
 		raw      string
 	} `json:"-"`
@@ -4530,6 +4533,14 @@ func (u ResponseInputContentUnionParam) GetFileData() *string {
 	return nil
 }
 
+// Returns a pointer to the underlying variant's property, if present.
+func (u ResponseInputContentUnionParam) GetFileURL() *string {
+	if vt := u.OfInputFile; vt != nil && vt.FileURL.Valid() {
+		return &vt.FileURL.Value
+	}
+	return nil
+}
+
 // Returns a pointer to the underlying variant's property, if present.
 func (u ResponseInputContentUnionParam) GetFilename() *string {
 	if vt := u.OfInputFile; vt != nil && vt.Filename.Valid() {
@@ -4577,13 +4588,16 @@ type ResponseInputFile struct {
 	FileData string `json:"file_data"`
 	// The ID of the file to be sent to the model.
 	FileID string `json:"file_id,nullable"`
+	// The URL of the file to be sent to the model.
+	FileURL string `json:"file_url"`
 	// The name of the file to be sent to the model.
 	Filename string `json:"filename"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
 		Type        respjson.Field
 		FileData    respjson.Field
 		FileID      respjson.Field
+		FileURL     respjson.Field
 		Filename    respjson.Field
 		ExtraFields map[string]respjson.Field
 		raw         string
@@ -4613,6 +4627,8 @@ type ResponseInputFileParam struct {
 	FileID param.Opt[string] `json:"file_id,omitzero"`
 	// The content of the file to be sent to the model.
 	FileData param.Opt[string] `json:"file_data,omitzero"`
+	// The URL of the file to be sent to the model.
+	FileURL param.Opt[string] `json:"file_url,omitzero"`
 	// The name of the file to be sent to the model.
 	Filename param.Opt[string] `json:"filename,omitzero"`
 	// The type of the input item. Always `input_file`.
@@ -7597,7 +7613,7 @@ type ResponseMcpCallArgumentsDeltaEvent struct {
 	OutputIndex int64 `json:"output_index,required"`
 	// The sequence number of this event.
 	SequenceNumber int64 `json:"sequence_number,required"`
-	// The type of the event. Always 'response.mcp_call.arguments_delta'.
+	// The type of the event. Always 'response.mcp_call_arguments.delta'.
 	Type constant.ResponseMcpCallArgumentsDelta `json:"type,required"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
@@ -7627,7 +7643,7 @@ type ResponseMcpCallArgumentsDoneEvent struct {
 	OutputIndex int64 `json:"output_index,required"`
 	// The sequence number of this event.
 	SequenceNumber int64 `json:"sequence_number,required"`
-	// The type of the event. Always 'response.mcp_call.arguments_done'.
+	// The type of the event. Always 'response.mcp_call_arguments.done'.
 	Type constant.ResponseMcpCallArgumentsDone `json:"type,required"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
@@ -9217,7 +9233,7 @@ type ResponseOutputTextAnnotationAddedEvent struct {
 	OutputIndex int64 `json:"output_index,required"`
 	// The sequence number of this event.
 	SequenceNumber int64 `json:"sequence_number,required"`
-	// The type of the event. Always 'response.output_text_annotation.added'.
+	// The type of the event. Always 'response.output_text.annotation.added'.
 	Type constant.ResponseOutputTextAnnotationAdded `json:"type,required"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
@@ -9296,6 +9312,8 @@ type ResponsePromptVariableUnion struct {
 	// This field is from variant [ResponseInputFile].
 	FileData string `json:"file_data"`
 	// This field is from variant [ResponseInputFile].
+	FileURL string `json:"file_url"`
+	// This field is from variant [ResponseInputFile].
 	Filename string `json:"filename"`
 	JSON     struct {
 		OfString respjson.Field
@@ -9305,6 +9323,7 @@ type ResponsePromptVariableUnion struct {
 		FileID   respjson.Field
 		ImageURL respjson.Field
 		FileData respjson.Field
+		FileURL  respjson.Field
 		Filename respjson.Field
 		raw      string
 	} `json:"-"`
@@ -9424,6 +9443,14 @@ func (u ResponsePromptVariableUnionParam) GetFileData() *string {
 	return nil
 }
 
+// Returns a pointer to the underlying variant's property, if present.
+func (u ResponsePromptVariableUnionParam) GetFileURL() *string {
+	if vt := u.OfInputFile; vt != nil && vt.FileURL.Valid() {
+		return &vt.FileURL.Value
+	}
+	return nil
+}
+
 // Returns a pointer to the underlying variant's property, if present.
 func (u ResponsePromptVariableUnionParam) GetFilename() *string {
 	if vt := u.OfInputFile; vt != nil && vt.Filename.Valid() {
@@ -10057,11 +10084,11 @@ type ResponseStreamEventUnion struct {
 	// "response.image_generation_call.generating",
 	// "response.image_generation_call.in_progress",
 	// "response.image_generation_call.partial_image",
-	// "response.mcp_call.arguments_delta", "response.mcp_call.arguments_done",
+	// "response.mcp_call_arguments.delta", "response.mcp_call_arguments.done",
 	// "response.mcp_call.completed", "response.mcp_call.failed",
 	// "response.mcp_call.in_progress", "response.mcp_list_tools.completed",
 	// "response.mcp_list_tools.failed", "response.mcp_list_tools.in_progress",
-	// "response.output_text_annotation.added", "response.queued",
+	// "response.output_text.annotation.added", "response.queued",
 	// "response.reasoning.delta", "response.reasoning.done",
 	// "response.reasoning_summary.delta", "response.reasoning_summary.done".
 	Type        string `json:"type"`
@@ -10321,9 +10348,9 @@ func (u ResponseStreamEventUnion) AsAny() anyResponseStreamEvent {
 		return u.AsResponseImageGenerationCallInProgress()
 	case "response.image_generation_call.partial_image":
 		return u.AsResponseImageGenerationCallPartialImage()
-	case "response.mcp_call.arguments_delta":
+	case "response.mcp_call_arguments.delta":
 		return u.AsResponseMcpCallArgumentsDelta()
-	case "response.mcp_call.arguments_done":
+	case "response.mcp_call_arguments.done":
 		return u.AsResponseMcpCallArgumentsDone()
 	case "response.mcp_call.completed":
 		return u.AsResponseMcpCallCompleted()
@@ -10337,7 +10364,7 @@ func (u ResponseStreamEventUnion) AsAny() anyResponseStreamEvent {
 		return u.AsResponseMcpListToolsFailed()
 	case "response.mcp_list_tools.in_progress":
 		return u.AsResponseMcpListToolsInProgress()
-	case "response.output_text_annotation.added":
+	case "response.output_text.annotation.added":
 		return u.AsResponseOutputTextAnnotationAdded()
 	case "response.queued":
 		return u.AsResponseQueued()
@@ -11043,6 +11070,8 @@ type ToolUnion struct {
 	Headers map[string]string `json:"headers"`
 	// This field is from variant [ToolMcp].
 	RequireApproval ToolMcpRequireApprovalUnion `json:"require_approval"`
+	// This field is from variant [ToolMcp].
+	ServerDescription string `json:"server_description"`
 	// This field is from variant [ToolCodeInterpreter].
 	Container ToolCodeInterpreterContainerUnion `json:"container"`
 	// This field is from variant [ToolImageGeneration].
@@ -11083,6 +11112,7 @@ type ToolUnion struct {
 		AllowedTools      respjson.Field
 		Headers           respjson.Field
 		RequireApproval   respjson.Field
+		ServerDescription respjson.Field
 		Container         respjson.Field
 		Background        respjson.Field
 		InputImageMask    respjson.Field
@@ -11170,16 +11200,19 @@ type ToolMcp struct {
 	Headers map[string]string `json:"headers,nullable"`
 	// Specify which of the MCP server's tools require approval.
 	RequireApproval ToolMcpRequireApprovalUnion `json:"require_approval,nullable"`
+	// Optional description of the MCP server, used to provide more context.
+	ServerDescription string `json:"server_description"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
-		ServerLabel     respjson.Field
-		ServerURL       respjson.Field
-		Type            respjson.Field
-		AllowedTools    respjson.Field
-		Headers         respjson.Field
-		RequireApproval respjson.Field
-		ExtraFields     map[string]respjson.Field
-		raw             string
+		ServerLabel       respjson.Field
+		ServerURL         respjson.Field
+		Type              respjson.Field
+		AllowedTools      respjson.Field
+		Headers           respjson.Field
+		RequireApproval   respjson.Field
+		ServerDescription respjson.Field
+		ExtraFields       map[string]respjson.Field
+		raw               string
 	} `json:"-"`
 }
 
@@ -11778,6 +11811,14 @@ func (u ToolUnionParam) GetRequireApproval() *ToolMcpRequireApprovalUnionParam {
 	return nil
 }
 
+// Returns a pointer to the underlying variant's property, if present.
+func (u ToolUnionParam) GetServerDescription() *string {
+	if vt := u.OfMcp; vt != nil && vt.ServerDescription.Valid() {
+		return &vt.ServerDescription.Value
+	}
+	return nil
+}
+
 // Returns a pointer to the underlying variant's property, if present.
 func (u ToolUnionParam) GetContainer() *ToolCodeInterpreterContainerUnionParam {
 	if vt := u.OfCodeInterpreter; vt != nil {
@@ -11905,6 +11946,8 @@ type ToolMcpParam struct {
 	ServerLabel string `json:"server_label,required"`
 	// The URL for the MCP server.
 	ServerURL string `json:"server_url,required"`
+	// Optional description of the MCP server, used to provide more context.
+	ServerDescription param.Opt[string] `json:"server_description,omitzero"`
 	// List of allowed tool names or a filter object.
 	AllowedTools ToolMcpAllowedToolsUnionParam `json:"allowed_tools,omitzero"`
 	// Optional HTTP headers to send to the MCP server. Use for authentication or other

shared/constant/constants.go

@@ -128,8 +128,8 @@ type ResponseImageGenerationCallInProgress string   // Always "response.image_ge
 type ResponseImageGenerationCallPartialImage string // Always "response.image_generation_call.partial_image"
 type ResponseInProgress string                      // Always "response.in_progress"
 type ResponseIncomplete string                      // Always "response.incomplete"
-type ResponseMcpCallArgumentsDelta string           // Always "response.mcp_call.arguments_delta"
-type ResponseMcpCallArgumentsDone string            // Always "response.mcp_call.arguments_done"
+type ResponseMcpCallArgumentsDelta string           // Always "response.mcp_call_arguments.delta"
+type ResponseMcpCallArgumentsDone string            // Always "response.mcp_call_arguments.done"
 type ResponseMcpCallCompleted string                // Always "response.mcp_call.completed"
 type ResponseMcpCallFailed string                   // Always "response.mcp_call.failed"
 type ResponseMcpCallInProgress string               // Always "response.mcp_call.in_progress"
@@ -138,7 +138,7 @@ type ResponseMcpListToolsFailed string              // Always "response.mcp_list
 type ResponseMcpListToolsInProgress string          // Always "response.mcp_list_tools.in_progress"
 type ResponseOutputItemAdded string                 // Always "response.output_item.added"
 type ResponseOutputItemDone string                  // Always "response.output_item.done"
-type ResponseOutputTextAnnotationAdded string       // Always "response.output_text_annotation.added"
+type ResponseOutputTextAnnotationAdded string       // Always "response.output_text.annotation.added"
 type ResponseOutputTextDelta string                 // Always "response.output_text.delta"
 type ResponseOutputTextDone string                  // Always "response.output_text.done"
 type ResponseQueued string                          // Always "response.queued"
@@ -366,10 +366,10 @@ func (c ResponseImageGenerationCallPartialImage) Default() ResponseImageGenerati
 func (c ResponseInProgress) Default() ResponseInProgress { return "response.in_progress" }
 func (c ResponseIncomplete) Default() ResponseIncomplete { return "response.incomplete" }
 func (c ResponseMcpCallArgumentsDelta) Default() ResponseMcpCallArgumentsDelta {
-	return "response.mcp_call.arguments_delta"
+	return "response.mcp_call_arguments.delta"
 }
 func (c ResponseMcpCallArgumentsDone) Default() ResponseMcpCallArgumentsDone {
-	return "response.mcp_call.arguments_done"
+	return "response.mcp_call_arguments.done"
 }
 func (c ResponseMcpCallCompleted) Default() ResponseMcpCallCompleted {
 	return "response.mcp_call.completed"
@@ -392,7 +392,7 @@ func (c ResponseOutputItemAdded) Default() ResponseOutputItemAdded {
 }
 func (c ResponseOutputItemDone) Default() ResponseOutputItemDone { return "response.output_item.done" }
 func (c ResponseOutputTextAnnotationAdded) Default() ResponseOutputTextAnnotationAdded {
-	return "response.output_text_annotation.added"
+	return "response.output_text.annotation.added"
 }
 func (c ResponseOutputTextDelta) Default() ResponseOutputTextDelta {
 	return "response.output_text.delta"