fix(appintents): stable IDs, Shortcut auto‑activate, Spotlight VM indexing

  - Prevent ActionNotFound by adding static action IDs
  - Activate/foreground UTM when starting a VM via Shortcuts
  - Index VM entities (IndexedEntity) and reindex on launch/changes for Spotlight free‑text resolution

feat(Intents): activate UTM before starting VM via Shortcut

feat(spotlight): index VM entities (IndexedEntity) and reindex on launch/changes to fix Spotlight free‑text resolution

Author: peterneutron

Intents/UTMActionIntent.swift

@@ -15,9 +15,13 @@
 //
 
 import AppIntents
+#if os(macOS)
+import AppKit
+#endif
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMStatusActionIntent: UTMIntent {
+    static var id: String = "UTMStatusActionIntent"
     static let title: LocalizedStringResource = "Get Virtual Machine Status"
     static let description = IntentDescription("Get the status of a virtual machine.")
     static var parameterSummary: some ParameterSummary {
@@ -38,6 +42,7 @@ struct UTMStatusActionIntent: UTMIntent {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMStartActionIntent: UTMIntent {
+    static var id: String = "UTMStartActionIntent"
     static let title: LocalizedStringResource = "Start Virtual Machine"
     static let description = IntentDescription("Start a virtual machine.")
     static var parameterSummary: some ParameterSummary {
@@ -78,7 +83,12 @@ struct UTMStartActionIntent: UTMIntent {
             }
             options.insert(.bootDisposibleMode)
         }
+        #if os(macOS)
+        // Ensure the app comes to the foreground before presenting VM UI
+        NSApp.activate(ignoringOtherApps: true)
+        #endif
         data.run(vm: boxed, options: options)
+        // For platforms that support foreground continuation, request it (no-op on older SDKs).
         if !vm.isHeadless {
             if #available(iOS 26, macOS 26, tvOS 26, watchOS 26, visionOS 26, *), systemContext.currentMode.canContinueInForeground {
                 try await continueInForeground(alwaysConfirm: false)
@@ -90,6 +100,7 @@ struct UTMStartActionIntent: UTMIntent {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMStopActionIntent: UTMIntent {
+    static var id: String = "UTMStopActionIntent"
     static let title: LocalizedStringResource = "Stop Virtual Machine"
     static let description = IntentDescription("Stop a virtual machine.")
     static var parameterSummary: some ParameterSummary {
@@ -128,6 +139,7 @@ extension UTMVirtualMachineStopMethod: AppEnum {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMPauseActionIntent: UTMIntent {
+    static var id: String = "UTMPauseActionIntent"
     static let title: LocalizedStringResource = "Pause Virtual Machine"
     static let description = IntentDescription("Pause a virtual machine.")
     static var parameterSummary: some ParameterSummary {
@@ -157,6 +169,7 @@ struct UTMPauseActionIntent: UTMIntent {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMResumeActionIntent: UTMIntent {
+    static var id: String = "UTMResumeActionIntent"
     static let title: LocalizedStringResource = "Resume Virtual Machine"
     static let description = IntentDescription("Resume a virtual machine.")
     static var parameterSummary: some ParameterSummary {
@@ -172,7 +185,7 @@ struct UTMResumeActionIntent: UTMIntent {
     @MainActor
     func perform(with vm: any UTMVirtualMachine, boxed: VMData) async throws -> some IntentResult {
         try await vm.resume()
-        if vm.isHeadless {
+        if !vm.isHeadless {
             if #available(iOS 26, macOS 26, tvOS 26, watchOS 26, visionOS 26, *), systemContext.currentMode.canContinueInForeground {
                 try await continueInForeground(alwaysConfirm: false)
             }
@@ -183,6 +196,7 @@ struct UTMResumeActionIntent: UTMIntent {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMRestartActionIntent: UTMIntent {
+    static var id: String = "UTMRestartActionIntent"
     static let title: LocalizedStringResource = "Restart Virtual Machine"
     static let description = IntentDescription("Restart a virtual machine.")
     static var parameterSummary: some ParameterSummary {
@@ -198,7 +212,7 @@ struct UTMRestartActionIntent: UTMIntent {
     @MainActor
     func perform(with vm: any UTMVirtualMachine, boxed: VMData) async throws -> some IntentResult {
         try await vm.restart()
-        if vm.isHeadless {
+        if !vm.isHeadless {
             if #available(iOS 26, macOS 26, tvOS 26, watchOS 26, visionOS 26, *), systemContext.currentMode.canContinueInForeground {
                 try await continueInForeground(alwaysConfirm: false)
             }

Intents/UTMEntityIndexing.swift

@@ -0,0 +1,43 @@
+//
+// Copyright © 2025 osy. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import Foundation
+import AppIntents
+import CoreSpotlight
+
+enum UTMEntityIndexer {
+    /// Rebuild the Spotlight index for all VM entities (macOS 15+/iOS 18+).
+    @MainActor
+    static func reindexAll(with data: UTMData) async {
+        guard #available(iOS 18, macOS 15, tvOS 18, watchOS 11, *) else {
+            return
+        }
+        let entities: [UTMVirtualMachineEntity] = data.virtualMachines.map { UTMVirtualMachineEntity(from: $0) }
+        do {
+            let index = CSSearchableIndex.default()
+            try await index.deleteAppEntities(ofType: UTMVirtualMachineEntity.self)
+            if !entities.isEmpty {
+                try await index.indexAppEntities(entities)
+                logger.debug("[Indexing] Indexed \(entities.count) VM entities for Spotlight")
+            } else {
+                logger.debug("[Indexing] Cleared VM entity index (no entities)")
+            }
+        } catch {
+            logger.error("[Indexing] Failed to (re)index VM entities: \(error.localizedDescription)")
+        }
+    }
+}
+

Intents/UTMInputIntent.swift

@@ -20,6 +20,7 @@ private let kDelayNs: UInt64 = 20000000
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMSendScanCodeIntent: UTMIntent {
+    static var id: String = "UTMSendScanCodeIntent"
     static let title: LocalizedStringResource = "Send Scan Code"
     static let description = IntentDescription("Send a sequence of raw keyboard scan codes to the virtual machine. Only supported on QEMU backend.")
     static var parameterSummary: some ParameterSummary {
@@ -63,6 +64,7 @@ struct UTMSendScanCodeIntent: UTMIntent {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMSendKeystrokesIntent: UTMIntent {
+    static var id: String = "UTMSendKeystrokesIntent"
     static let title: LocalizedStringResource = "Send Keystrokes"
     static let description = IntentDescription("Send text as a sequence of keystrokes to the virtual machine. Only supported on QEMU backend.")
     static var parameterSummary: some ParameterSummary {
@@ -154,6 +156,7 @@ struct UTMSendKeystrokesIntent: UTMIntent {
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMMouseClickIntent: UTMIntent {
+    static var id: String = "UTMMouseClickIntent"
     static let title: LocalizedStringResource = "Send Mouse Click"
     static let description = IntentDescription("Send a mouse position and click to the virtual machine. Only supported on QEMU backend.")
     static var parameterSummary: some ParameterSummary {

Intents/UTMVirtualMachineEntity.swift

@@ -15,6 +15,7 @@
 //
 
 import AppIntents
+import CoreSpotlight
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)
 struct UTMVirtualMachineEntity: AppEntity {
@@ -63,7 +64,18 @@ struct UTMVirtualMachineEntity: AppEntity {
 
 @available(iOS 18, macOS 15, *)
 extension UTMVirtualMachineEntity: IndexedEntity {
-    
+    // Spotlight searchable attributes for this VM entity
+    var attributeSet: CSSearchableItemAttributeSet {
+        let attrs = CSSearchableItemAttributeSet()
+        attrs.title = name
+        attrs.contentDescription = description
+        if let iconURL {
+            attrs.thumbnailURL = iconURL
+        }
+        // Light keywords for common queries
+        attrs.keywords = ["vm", "virtual machine", String(describing: state)]
+        return attrs
+    }
 }
 
 @available(iOS 16, macOS 13, tvOS 16, watchOS 9, *)

Platform/macOS/UTMApp.swift

@@ -16,6 +16,7 @@
 
 import SwiftUI
 import AppIntents
+import CoreSpotlight
 
 struct UTMApp: App {
     let data: UTMData
@@ -35,12 +36,16 @@ struct UTMApp: App {
             .onAppear {
                 appDelegate.data = data
                 NSApp.scriptingDelegate = appDelegate
+                Task { await reindexVms() }
             }
             .onReceive(.vmSessionError) { notification in
                 if let message = notification.userInfo?["Message"] as? String {
                     data.showErrorAlert(message: message)
                 }
             }
+            .onChange(of: data.virtualMachines) { _ in
+                Task { await reindexVms() }
+            }
     }
 
     @SceneBuilder
@@ -81,4 +86,22 @@ struct UTMApp: App {
             return oldBody
         }
     }
+
+    @MainActor
+    private func reindexVms() async {
+        guard #available(macOS 15, *) else { return }
+        let entities = data.virtualMachines.map { UTMVirtualMachineEntity(from: $0) }
+        do {
+            let index = CSSearchableIndex.default()
+            try await index.deleteAppEntities(ofType: UTMVirtualMachineEntity.self)
+            if !entities.isEmpty {
+                try await index.indexAppEntities(entities)
+                logger.debug("[Indexing] Indexed \(entities.count) VM entities for Spotlight")
+            } else {
+                logger.debug("[Indexing] Cleared VM entity index (no entities)")
+            }
+        } catch {
+            logger.error("[Indexing] Failed to (re)index VM entities: \(error.localizedDescription)")
+        }
+    }
 }