App Intents New Capabilities (iOS 27)

 import AppIntents
 
−// MARK: - Pre-iOS-27: full entity array — all entities resolved before perform runs
+// MARK: - Entity
 
−struct TagPhotosIntentLegacy: AppIntent {
+struct PhotoEntity: AppEntity {
+    static var typeDisplayRepresentation: TypeDisplayRepresentation = "Photo"
+    static var defaultQuery = PhotoEntityQuery()
+
+    var id: String
+    var title: String
+
+    var displayRepresentation: DisplayRepresentation {
+        DisplayRepresentation(title: "\(title)")
+    }
+}
+
+struct PhotoEntityQuery: EntityQuery {
+    func entities(for identifiers: [String]) async throws -> [PhotoEntity] {
+        // Fetch only the requested photos from your data store
+        identifiers.map { PhotoEntity(id: $0, title: "Photo \($0)") }
+    }
+}
+
+// MARK: - Intent using EntityCollection (iOS 27)
+// Only entity IDs are passed; no full resolution occurs for the collection.
+
+struct TagPhotosIntent: AppIntent {
     static var title: LocalizedStringResource = "Tag Photos"
     static var description = IntentDescription("Adds a keyword tag to selected photos.")
 
−    // The system resolves every PhotoEntity fully before calling perform,
−    // even though only the ID is needed. At 1000+ photos this is very slow.
+    // EntityCollection passes only IDs — no full entity hydration
     @Parameter(title: "Photos")
−    var photos: [PhotoEntity]
+    var photos: EntityCollection<PhotoEntity>
 
     @Parameter(title: "Tag")
     var tag: String
 
     @MainActor
     func perform() async throws -> some IntentResult {
−        let ids = photos.map(\.id)
+        // photos.entityIdentifiers gives you the raw IDs directly
+        let ids = photos.entityIdentifiers
         await PhotoLibrary.shared.applyTag(tag, toPhotoIDs: ids)
         return .result()
     }
+}
+
+// MARK: - Stub data layer
+
+actor PhotoLibrary {
+    static let shared = PhotoLibrary()
+
+    func applyTag(_ tag: String, toPhotoIDs ids: [String]) async {
+        // Update your data model using IDs only — no full entity needed
+        print("Tagged \(ids.count) photos with '\(tag)'")
+    }
 }