fm CLI and Python SDK for Apple Foundation Models

// NOTE: fm CLI is a macOS shell tool; the Swift snippet below shows
// how you would accomplish the same structured-output task using the
// FoundationModels Swift framework on iOS/macOS 27+, mirroring what
// the fm CLI does under the hood.

import FoundationModels
import Foundation

// 1. Define the structured output type (mirrors `fm schema object` in the CLI)
struct FileSortResult: Codable, Generable {
    @Guide(description: "Files identified as final versions")
    var finalFiles: [String]

    @Guide(description: "Files identified as drafts or work-in-progress")
    var draftFiles: [String]
}

// 2. Prepare a list of file names to classify
let fileNames = [
    "logo_v1.png", "logo_final.png", "hero_draft2.jpg",
    "hero_FINAL.jpg", "icon_wip.png", "icon_approved.png"
]
let fileList = fileNames.joined(separator: "\n")

// 3. Create a session with instructions
let session = LanguageModelSession(
    instructions: "You are a file organizer. Classify each filename as either a final deliverable or a draft/work-in-progress based on its name."
)

// 4. Prompt the model and request structured output
let prompt = "Classify these files:\n\(fileList)"

do {
    let response = try await session.respond(
        to: prompt,
        generating: FileSortResult.self
    )
    let result = response.value
    print("✅ Final files: \(result.finalFiles)")
    print("🗑️ Draft files: \(result.draftFiles)")
} catch {
    print("Error: \(error)")
}

// --- Equivalent fm CLI one-liner (run in macOS 27 Terminal) ---
// SCHEMA=$(fm schema object '{"finalFiles":["string"],"draftFiles":["string"]}')
// fm respond "Classify these files: logo_v1.png logo_final.png hero_draft2.jpg" --schema "$SCHEMA"