Virtualization Framework Enhancements (macOS 27)

import Virtualization
import Foundation

// MARK: - macOS Guest Provisioning (macOS 27+)

func startVirtualMacWithProvisioning(vm: VZVirtualMachine) async throws {
    // 1. Build provisioning options for the first-boot Setup Assistant automation
    let provisioningOptions = VZMacGuestProvisioningOptions()
    provisioningOptions.fullName = "Jane Appleseed"
    provisioningOptions.userName = "jappleseed"
    provisioningOptions.password = ProcessInfo.processInfo.environment["VM_PASSWORD"] ?? "changeme"
    provisioningOptions.isAutoLoginEnabled = true
    provisioningOptions.isRemoteLoginEnabled = true  // enables SSH

    // 2. Attach provisioning options to start options
    let startOptions = VZMacOSVirtualMachineStartOptions()
    startOptions.guestProvisioning = provisioningOptions

    // 3. Start the VM — on first boot, Setup Assistant is bypassed automatically
    try await vm.start(options: startOptions)
    print("Virtual Mac started. Guest will auto-provision user: \(provisioningOptions.userName)")
}

// MARK: - Example: Build a VZVirtualMachine and provision it

func buildAndProvisionVM() async throws {
    guard let bundleURL = Bundle.main.url(forResource: "MyVM", withExtension: "bundle") else {
        fatalError("VM bundle not found")
    }

    // Load an existing, installed macOS VM configuration from disk
    let configURL = bundleURL.appendingPathComponent("config.plist")
    let configData = try Data(contentsOf: configURL)
    let decoder = PropertyListDecoder()
    // In practice you'd decode your saved VZVirtualMachineConfiguration here.
    // For demonstration we construct a minimal placeholder config.
    let config = VZVirtualMachineConfiguration()
    // (Real apps load hardware model, boot loader, memory, storage, etc.)
    try config.validate()

    let virtualMachine = VZVirtualMachine(configuration: config)
    try await startVirtualMacWithProvisioning(vm: virtualMachine)
}