using AIStudio.Settings; using AIStudio.Settings.DataModel; using AIStudio.Tools.PluginSystem; using AIStudio.Tools.Rust; using Microsoft.AspNetCore.Components; namespace AIStudio.Tools.Services; public sealed class GlobalShortcutService : BackgroundService, IMessageBusReceiver { private static bool IS_STARTUP_COMPLETED; private enum ShortcutSyncSource { CONFIGURATION_CHANGED, STARTUP_COMPLETED, PLUGINS_RELOADED, VOICE_RECORDING_AVAILABILITY_CHANGED, } private readonly SemaphoreSlim registrationSemaphore = new(1, 1); private readonly Dictionary lastSentStates = []; private readonly Dictionary lastNonEmptyShortcuts = []; private readonly ILogger logger; private readonly SettingsManager settingsManager; private readonly MessageBus messageBus; private readonly RustService rustService; private readonly VoiceRecordingAvailabilityService voiceRecordingAvailabilityService; public GlobalShortcutService( ILogger logger, SettingsManager settingsManager, MessageBus messageBus, RustService rustService, VoiceRecordingAvailabilityService voiceRecordingAvailabilityService) { this.logger = logger; this.settingsManager = settingsManager; this.messageBus = messageBus; this.rustService = rustService; this.voiceRecordingAvailabilityService = voiceRecordingAvailabilityService; this.messageBus.RegisterComponent(this); this.ApplyFilters([], [Event.CONFIGURATION_CHANGED, Event.PLUGINS_RELOADED, Event.STARTUP_COMPLETED, Event.TAURI_EVENT_RECEIVED, Event.VOICE_RECORDING_AVAILABILITY_CHANGED]); } protected override async Task ExecuteAsync(CancellationToken stoppingToken) { this.logger.LogInformation("The global shortcut service was initialized."); await Task.Delay(Timeout.InfiniteTimeSpan, stoppingToken); } public override async Task StopAsync(CancellationToken cancellationToken) { this.messageBus.Unregister(this); this.registrationSemaphore.Dispose(); await base.StopAsync(cancellationToken); } #region IMessageBusReceiver public async Task ProcessMessage(ComponentBase? sendingComponent, Event triggeredEvent, T? data) { switch (triggeredEvent) { case Event.CONFIGURATION_CHANGED: if (!IS_STARTUP_COMPLETED) return; await this.RegisterAllShortcuts(ShortcutSyncSource.CONFIGURATION_CHANGED); break; case Event.STARTUP_COMPLETED: IS_STARTUP_COMPLETED = true; await this.RegisterAllShortcuts(ShortcutSyncSource.STARTUP_COMPLETED); break; case Event.PLUGINS_RELOADED: if (!IS_STARTUP_COMPLETED) return; await this.RegisterAllShortcuts(ShortcutSyncSource.PLUGINS_RELOADED); break; case Event.VOICE_RECORDING_AVAILABILITY_CHANGED: if (!IS_STARTUP_COMPLETED) return; await this.RegisterAllShortcuts(ShortcutSyncSource.VOICE_RECORDING_AVAILABILITY_CHANGED); break; case Event.TAURI_EVENT_RECEIVED: if (data is TauriEvent tauriEvent && tauriEvent.TryGetShortcutChange(out var shortcutId, out var effectiveDisplayName)) { await this.UpdateEffectiveDisplayName(shortcutId, effectiveDisplayName); } break; } } public Task ProcessMessageWithResult(ComponentBase? sendingComponent, Event triggeredEvent, TPayload? data) => Task.FromResult(default); #endregion private async Task RegisterAllShortcuts(ShortcutSyncSource source) { await this.registrationSemaphore.WaitAsync(); try { this.logger.LogInformation("Registering global shortcuts (source='{Source}').", source); foreach (var shortcutId in Enum.GetValues()) { if(shortcutId is Shortcut.NONE) continue; var shortcutState = await this.GetShortcutState(shortcutId, source); var shortcut = shortcutState.Shortcut; var isEnabled = shortcutState.IsEnabled; var requestedState = new ShortcutState(isEnabled ? shortcut : string.Empty, isEnabled, shortcutState.UsesPersistedFallback); this.logger.LogInformation( "Sync shortcut '{ShortcutId}' (source='{Source}', enabled={IsEnabled}, configured='{Shortcut}').", shortcutId, source, isEnabled, shortcut); if (shortcutState.UsesPersistedFallback) { this.logger.LogWarning( "Using persisted shortcut fallback for '{ShortcutId}' during startup completion (source='{Source}', configured='{Shortcut}').", shortcutId, source, shortcut); } if (this.lastSentStates.TryGetValue(shortcutId, out var lastSentState) && lastSentState.Shortcut == requestedState.Shortcut && lastSentState.IsEnabled == requestedState.IsEnabled) { this.logger.LogDebug("Skipping unchanged global shortcut '{ShortcutId}'.", shortcutId); continue; } var description = await this.GetShortcutDescription(shortcutId); var reconfigure = !string.IsNullOrWhiteSpace(requestedState.Shortcut) && this.lastNonEmptyShortcuts.TryGetValue(shortcutId, out var lastNonEmptyShortcut) && !string.Equals(lastNonEmptyShortcut, requestedState.Shortcut, StringComparison.Ordinal); var result = await this.rustService.UpdateGlobalShortcut(shortcutId, requestedState.Shortcut, description, reconfigure); this.lastSentStates[shortcutId] = requestedState; if (!string.IsNullOrWhiteSpace(requestedState.Shortcut)) this.lastNonEmptyShortcuts[shortcutId] = requestedState.Shortcut; if (result.Success) { this.logger.LogInformation( "Global shortcut '{ShortcutId}' ({Shortcut}) synchronized through {Backend}.", shortcutId, requestedState.Shortcut, result.Backend); if (result.Backend is ShortcutBackend.PORTAL) await this.UpdateEffectiveDisplayName(shortcutId, result.EffectiveDisplayName); } else { var userMessage = result.Cancelled ? TB("The global shortcut change was cancelled. The previous shortcut remains active.") : TB("The global shortcut could not be registered. The previous shortcut remains active."); this.logger.LogWarning( "Failed to synchronize global shortcut '{ShortcutId}' ({Shortcut}, backend={Backend}, cancelled={Cancelled}): {Error}", shortcutId, requestedState.Shortcut, result.Backend, result.Cancelled, result.ErrorMessage); if (result.Cancelled) await this.messageBus.SendWarning(new(Icons.Material.Filled.Keyboard, userMessage)); else await this.messageBus.SendError(new(Icons.Material.Filled.Keyboard, userMessage)); } } this.logger.LogInformation("Global shortcuts registration completed (source='{Source}').", source); } finally { this.registrationSemaphore.Release(); } } private string GetShortcutValue(Shortcut name) => name switch { Shortcut.VOICE_RECORDING_TOGGLE => this.settingsManager.ConfigurationData.App.ShortcutVoiceRecording, _ => string.Empty, }; private bool IsShortcutAllowed(Shortcut name) => name switch { // Voice recording is a preview feature: Shortcut.VOICE_RECORDING_TOGGLE => PreviewFeatures.PRE_SPEECH_TO_TEXT_2026.IsEnabled(this.settingsManager) && this.voiceRecordingAvailabilityService.IsAvailable, // Other shortcuts are always allowed: _ => true, }; private async Task GetShortcutDescription(Shortcut shortcutId) { var language = await this.settingsManager.GetActiveLanguagePlugin(); return shortcutId switch { Shortcut.VOICE_RECORDING_TOGGLE => I18N.I.GetText(language, "Toggle voice recording", typeof(GlobalShortcutService).Namespace, nameof(GlobalShortcutService)), _ => I18N.I.GetText(language, "Global shortcut", typeof(GlobalShortcutService).Namespace, nameof(GlobalShortcutService)), }; } private async Task UpdateEffectiveDisplayName(Shortcut shortcutId, string effectiveDisplayName) { if (shortcutId is not Shortcut.VOICE_RECORDING_TOGGLE || string.IsNullOrWhiteSpace(effectiveDisplayName)) return; var configuredShortcut = this.settingsManager.ConfigurationData.App.ShortcutVoiceRecording; if (this.settingsManager.ConfigurationData.App.ShortcutVoiceRecordingDisplayName == effectiveDisplayName && this.settingsManager.ConfigurationData.App.ShortcutVoiceRecordingDisplaySource == configuredShortcut) return; this.settingsManager.ConfigurationData.App.ShortcutVoiceRecordingDisplayName = effectiveDisplayName; this.settingsManager.ConfigurationData.App.ShortcutVoiceRecordingDisplaySource = configuredShortcut; await this.settingsManager.StoreSettings(); await this.messageBus.SendMessage(null, Event.GLOBAL_SHORTCUT_CHANGED); } private static string TB(string fallbackEN) => I18N.I.T(fallbackEN, typeof(GlobalShortcutService).Namespace, nameof(GlobalShortcutService)); private async Task GetShortcutState(Shortcut shortcutId, ShortcutSyncSource source) { var shortcut = this.GetShortcutValue(shortcutId); var isEnabled = this.IsShortcutAllowed(shortcutId); if (isEnabled && !string.IsNullOrWhiteSpace(shortcut)) return new(shortcut, true, false); if (source is not ShortcutSyncSource.STARTUP_COMPLETED || shortcutId is not Shortcut.VOICE_RECORDING_TOGGLE) return new(shortcut, isEnabled, false); var settingsSnapshot = await this.settingsManager.TryReadSettingsSnapshot(); if (settingsSnapshot is null) return new(shortcut, isEnabled, false); var fallbackShortcut = settingsSnapshot.App.ShortcutVoiceRecording; var fallbackEnabled = !string.IsNullOrWhiteSpace(settingsSnapshot.App.UseTranscriptionProvider); if (!fallbackEnabled || string.IsNullOrWhiteSpace(fallbackShortcut)) return new(shortcut, isEnabled, false); return new(fallbackShortcut, true, true); } private readonly record struct ShortcutState(string Shortcut, bool IsEnabled, bool UsesPersistedFallback); }