Advanced App Intents for Siri & Apple Intelligence

 import AppIntents
+import CoreSpotlight
 
−// Pre-iOS 27: Basic entity with no ownership info, no custom snippet,
−// and no interaction donation from UI
+// MARK: - Entity with ownership awareness
 
−struct ConversationEntity: AppEntity {
+struct ConversationEntity: AppEntity, OwnershipProvidingEntity {
     static let typeDisplayRepresentation = TypeDisplayRepresentation(name: "Conversation")
     static let defaultQuery = ConversationEntityQuery()
 
     let id: String
     let title: String
     let isGroupChat: Bool
 
     var displayRepresentation: DisplayRepresentation {
−        DisplayRepresentation(title: "\(title)")
−        // No subtitle, no image, no ownership info
+        DisplayRepresentation(
+            title: "\(title)",
+            subtitle: isGroupChat ? "Group" : "Direct",
+            image: .init(systemName: isGroupChat ? "person.3" : "person")
+        )
     }
−    // No OwnershipProvidingEntity — Siri assumes private, may skip confirmation
−    // even for shared/group conversations
+
+    // OwnershipProvidingEntity: tell Siri if this entity is shared
+    var ownership: EntityOwnership {
+        isGroupChat ? .shared : .private
+    }
 }
 
 struct ConversationEntityQuery: EntityQuery {
     func entities(for identifiers: [String]) async throws -> [ConversationEntity] {
−        identifiers.map { ConversationEntity(id: $0, title: "Chat \($0)", isGroupChat: false) }
+        identifiers.map { ConversationEntity(id: $0, title: "Chat \($0)", isGroupChat: $0.hasPrefix("group")) }
     }
 }
 
+// MARK: - Intent with custom dialog + snippet view
+
 struct SendMessageIntent: AppIntent {
     static let title: LocalizedStringResource = "Send Message"
+    static let description = IntentDescription("Sends a message in UnicornChat")
     static let openAppWhenRun: Bool = false
 
     @Parameter(title: "Conversation") var conversation: ConversationEntity
     @Parameter(title: "Message") var messageText: String
 
−    func perform() async throws -> some IntentResult {
−        // Send the message — no custom dialog, no snippet view
+    @MainActor
+    func perform() async throws -> some ProvidesDialog & ShowsSnippetView {
+        // Send the message
         try await MessageService.send(messageText, to: conversation.id)
−        return .result()
−        // Siri generates a generic response with no branding
+
+        return .result(
+            dialog: IntentDialog(
+                full: "Sent \"\(messageText)\" to \(conversation.title).",
+                supporting: "Message sent"
+            )
+        ) {
+            MessageSentSnippetView(conversation: conversation, message: messageText)
+        }
     }
 }
 
+// MARK: - Donate from UI so Apple Intelligence learns preferences
+
 final class MessageService {
−    static func send(_ text: String, to conversationId: String) async throws {
−        // ... send logic ...
−        // No donation — Apple Intelligence never learns from UI interactions
+    static func send(_ text: String, to conversationId: String, donateIntent: Bool = true) async throws {
+        // ... actual send logic ...
+
+        guard donateIntent else { return }
+
+        // Build and donate the intent so Apple Intelligence learns this preference
+        var intent = SendMessageIntent()
+        intent.conversation = ConversationEntity(id: conversationId, title: "Chat \(conversationId)", isGroupChat: false)
+        intent.messageText = text
+
+        let result = SendMessageIntentResult()
+        await IntentDonationManager.shared.donate(intent: intent, result: result)
     }
+}
+
+struct SendMessageIntentResult: IntentResult {
+    // Empty result — donation only needs the intent populated
+}
+
+// MARK: - Snippet SwiftUI view
+
+import SwiftUI
+
+struct MessageSentSnippetView: View {
+    let conversation: ConversationEntity
+    let message: String
+
+    var body: some View {
+        HStack(spacing: 12) {
+            Image(systemName: "checkmark.circle.fill")
+                .foregroundStyle(.green)
+                .font(.title2)
+            VStack(alignment: .leading) {
+                Text(conversation.title).font(.headline)
+                Text(message).font(.subheadline).foregroundStyle(.secondary)
+            }
+        }
+        .padding()
+        .background(.regularMaterial, in: RoundedRectangle(cornerRadius: 12))
+    }
 }