/// Requests permission for Shortcuts app to interact with Ghostty
/// 
/// This function displays a permission dialog asking the user to allow Shortcuts
/// to interact with Ghostty. The permission is automatically cached for 10 minutes
/// if the user selects "Allow", meaning subsequent intent calls won't show the dialog
/// again during that time period.
/// 
/// The permission uses a shared UserDefaults key across all intents, so granting
/// permission for one intent allows all Ghostty intents to execute without additional
/// prompts for the duration of the cache period.
/// 
/// - Returns: `true` if permission is granted, `false` if denied
/// 
/// ## Usage
/// Add this check at the beginning of any App Intent's `perform()` method:
/// ```swift
/// @MainActor
/// func perform() async throws -> some IntentResult {
///     guard await requestIntentPermission() else {
///         throw GhosttyIntentError.permissionDenied
///     }
///     // ... continue with intent implementation
/// }
/// ```
func requestIntentPermission() async -> Bool {
    await withCheckedContinuation { continuation in
        Task { @MainActor in
            PermissionRequest.show(
                "org.mitchellh.ghostty.shortcutsPermission",
                message: "Allow Shortcuts to interact with Ghostty for the next 10 minutes?",
                allowDuration: .seconds(600),
            ) { response in
                continuation.resume(returning: response)
            }
        }
    }
}