App Intents Framework: New Capabilities (iOS 27)

import AppIntents

// MARK: - Photo Entity
struct PhotoEntity: AppEntity {
    static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "Photo")
    static var defaultQuery = PhotoEntityQuery()

    var id: String
    var title: String
    var keywords: [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 layer
        identifiers.map { id in
            PhotoEntity(id: id, title: "Photo \(id)", keywords: [])
        }
    }
}

// MARK: - Efficient Batch Tagging Intent using EntityCollection
struct TagPhotosIntent: AppIntent {
    static var title: LocalizedStringResource = "Tag Photos"
    static var description = IntentDescription("Adds a keyword tag to multiple photos efficiently.")

    // EntityCollection passes only IDs — no full entity resolution
    @Parameter(title: "Photos")
    var photos: EntityCollection<PhotoEntity>

    @Parameter(title: "Tag")
    var tag: String

    func perform() async throws -> some IntentResult {
        // photos.entityIdentifiers contains just the IDs
        let ids = photos.entityIdentifiers
        await PhotoLibrary.shared.addTag(tag, toPhotoIDs: ids)
        return .result()
    }
}

// MARK: - Simulated Data Layer
actor PhotoLibrary {
    static let shared = PhotoLibrary()

    func addTag(_ tag: String, toPhotoIDs ids: [String]) {
        // Efficiently update only the records that need tagging
        print("Tagged \(ids.count) photos with '\(tag)'")
    }
}

// MARK: - RelevantEntities: Surface a playlist in a workout context
import AppIntents

struct RunningPlaylistEntity: AppEntity {
    static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "Playlist")
    static var defaultQuery = PlaylistEntityQuery()
    var id: String
    var name: String
    var displayRepresentation: DisplayRepresentation { DisplayRepresentation(title: "\(name)") }
}

struct PlaylistEntityQuery: EntityQuery {
    func entities(for identifiers: [String]) async throws -> [RunningPlaylistEntity] {
        identifiers.map { RunningPlaylistEntity(id: $0, name: "Playlist \($0)") }
    }
}

func registerRunningPlaylists() async throws {
    let playlists = [
        RunningPlaylistEntity(id: "pl-1", name: "High Tempo Run"),
        RunningPlaylistEntity(id: "pl-2", name: "Endurance Mix")
    ]
    let context = RelevantContext.workout
    try await RelevantEntities.updateEntities(playlists, forContext: context)
}