let intelligence = PrismGamificationIntelligence()

let intelligence = PrismGamificationIntelligence(
    configuration: PrismAppleIntelligenceConfiguration(/* ... */)
)

let intelligence = PrismGamificationIntelligence(
    provider: myCustomProvider // any PrismLanguageIntelligenceProvider
)

let available = await intelligence.isAvailable()

let message = try await intelligence.generateMessage(
    kind: .challengeCompleted,
    context: PrismGamificationContext(
        entityID: "tenWorkouts",
        challengeTitle: "Ten Workouts",
        points: 50,
        totalPoints: 120
    )
)

print(message.content)
// "You crushed 10 workouts and earned 50 points! 💪"

let messages = await intelligence.generateMessages([
    (kind: .challengeCompleted, context: completionCtx),
    (kind: .streakMotivation, context: streakCtx),
    (kind: .badgeUnlocked, context: badgeCtx)
])
// Failed generations are silently skipped

let message = await intelligence.messageWithFallback(
    kind: .streakMotivation,
    context: PrismGamificationContext(
        entityID: "daily",
        currentStreak: 14,
        longestStreak: 21
    )
)
// AI-generated if available, static fallback otherwise

let message = await intelligence.fallbackMessage(
    kind: .badgeUnlocked,
    context: PrismGamificationContext(
        entityID: "fitnessFreak",
        badgeTitle: "Fitness Freak",
        badgeTier: "silver"
    )
)
// "Silver badge "Fitness Freak" unlocked!"

let builder = PrismGamificationPromptBuilder()
let prompt = builder.prompt(
    for: .challengeCompleted,
    context: myContext
)
let system = builder.systemInstructions

let text = PrismGamificationFallbacks.message(
    for: .streakAtRisk,
    context: PrismGamificationContext(
        entityID: "daily",
        currentStreak: 7
    )
)
// "Your 7-day streak is at risk! Log activity today."

for await event in manager.events {
    switch event {
    case .completed(let id, let points):
        let msg = await intelligence.messageWithFallback(
            kind: .challengeCompleted,
            context: PrismGamificationContext(
                entityID: id,
                challengeTitle: id,
                points: points
            )
        )
        showToast(msg.content)

    case .streakExtended(let id, let count):
        let msg = await intelligence.messageWithFallback(
            kind: .streakMotivation,
            context: PrismGamificationContext(
                entityID: id,
                currentStreak: count
            )
        )
        showToast(msg.content)

    case .badgeUnlocked(let id, let tier):
        let msg = await intelligence.messageWithFallback(
            kind: .badgeUnlocked,
            context: PrismGamificationContext(
                entityID: id,
                badgeTitle: id,
                badgeTier: tier
            )
        )
        showCelebration(msg.content)

    default: break
    }
}