various helpers

Author: m1guelpf

src/Conversation.swift

@@ -65,7 +65,6 @@ import Foundation
 	}
 
 	private let client: ResponsesAPI
-
 	@MainActor private var config: Config
 
 	/// Creates a new conversation.

src/Models/File.swift

@@ -98,10 +98,11 @@ public extension File.Upload {
 	///
 	/// - Parameter url: The URL of the file to upload.
 	/// - Parameter name: The name of the file.
-	static func url(_ url: URL, name: String? = nil) async throws -> File.Upload {
+	/// - Parameter contentType: The mime type of the file.
+	static func url(_ url: URL, name: String? = nil, contentType: String = "application/octet-stream") async throws -> File.Upload {
 		let name = name ?? url.lastPathComponent == "/" ? "unknown_file" : url.lastPathComponent
 
-		return try File.Upload(name: name, contents: Data(contentsOf: url))
+		return try File.Upload(name: name, contents: Data(contentsOf: url), contentType: contentType)
 	}
 
 	/// Creates a file upload from the given data.

src/Models/Input.swift

@@ -59,32 +59,37 @@ import MetaCodable
 			/// - Parameter imageUrl: The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image in a data URL.
 			@CodedAs("input_image") case image(
 				detail: ImageDetail = .auto,
-				fileId: String?,
-				imageUrl: String?
+				fileId: String? = nil,
+				imageUrl: String? = nil
 			)
 
 			/// A file input to the model.
 			/// - Parameter fileData: The content of the file to be sent to the model.
 			/// - Parameter fileId: The ID of the file to be sent to the model.
 			/// - Parameter filename:  The name of the file to be sent to the model.
 			@CodedAs("input_file") case file(
-				fileData: String?,
-				fileId: String?,
-				filename: String?
+				fileData: String? = nil,
+				fileId: String? = nil,
+				filename: String? = nil
 			)
 		}
 
 		/// A text input to the model, equivalent to a text input.
 		case text(String)
+
 		/// A list of one or many content items to the model, containing different content types.
 		case list([ContentItem])
-	}
 
-	/// A text input to the model, equivalent to a text input with the user role.
-	case text(String)
+		/// Creates a new text input to the model.
+		public init(_ text: String) {
+			self = .text(text)
+		}
 
-	/// A list of one or many input items to the model, containing different content types.
-	case list([ListItem])
+		/// Creates a new input to the model with a list of items.
+		public init(_ items: [ContentItem]) {
+			self = .list(items)
+		}
+	}
 
 	/// The messages contained in the input.
 	public var messages: [Message] {
@@ -113,6 +118,22 @@ import MetaCodable
 				}.joined(separator: " ")
 		}
 	}
+
+	/// A text input to the model, equivalent to a text input with the user role.
+	case text(String)
+
+	/// A list of one or many input items to the model, containing different content types.
+	case list([ListItem])
+
+	/// Creates a new text input to the model.
+	public init(_ text: String) {
+		self = .text(text)
+	}
+
+	/// Creates a new input to the model with a list of items.
+	public init(_ items: [ListItem]) {
+		self = .list(items)
+	}
 }
 
 // MARK: - Text helpers

src/Models/Message.swift

@@ -117,6 +117,14 @@ public enum Message: Equatable, Hashable, Sendable {
 		}
 	}
 
+	/// The unique ID of the message, if available.
+	public var id: String? {
+		switch self {
+			case .input: return nil
+			case let .output(output): return output.id
+		}
+	}
+
 	/// The text content of the input.
 	///
 	/// > Note: This property does not include reasoning text.

src/Models/Tool.swift

@@ -455,10 +455,10 @@ public extension Tool {
 	/// This tool searches the web for relevant results to use in a response.
 	///
 	/// Learn more about the [web search tool](https://platform.openai.com/docs/guides/tools-web-search?api-mode=responses).
-	/// - Parameter searchContextSize: High level guidance for the amount of context window space to use for the search.
+	/// - Parameter contextSize: High level guidance for the amount of context window space to use for the search.
 	/// - Parameter userLocation: Approximate location parameters for the search.
-	static func webSearch(searchContextSize: WebSearch.ContextSize = .medium, userLocation: WebSearch.UserLocation? = nil) -> Self {
-		.webSearch(WebSearch(searchContextSize: searchContextSize, userLocation: userLocation))
+	static func webSearch(contextSize: WebSearch.ContextSize = .medium, userLocation: WebSearch.UserLocation? = nil) -> Self {
+		.webSearch(WebSearch(searchContextSize: contextSize, userLocation: userLocation))
 	}
 }