using AIStudio.Settings; using AIStudio.Settings.DataModel; using AIStudio.Tools.Rust; using Microsoft.AspNetCore.Components; namespace AIStudio.Tools.Services; public sealed class GlobalShortcutService : BackgroundService, IMessageBusReceiver { private static bool IS_INITIALIZED; private static readonly TimeSpan STARTUP_RECOVERY_WINDOW = TimeSpan.FromSeconds(15); private enum ShortcutSyncSource { STARTUP, CONFIGURATION_CHANGED, PLUGINS_RELOADED, } private readonly SemaphoreSlim registrationSemaphore = new(1, 1); private readonly ILogger logger; private readonly SettingsManager settingsManager; private readonly MessageBus messageBus; private readonly RustService rustService; private readonly DateTimeOffset serviceStartedAt = DateTimeOffset.UtcNow; public GlobalShortcutService( ILogger logger, SettingsManager settingsManager, MessageBus messageBus, RustService rustService) { this.logger = logger; this.settingsManager = settingsManager; this.messageBus = messageBus; this.rustService = rustService; this.messageBus.RegisterComponent(this); this.ApplyFilters([], [Event.CONFIGURATION_CHANGED, Event.PLUGINS_RELOADED]); } protected override async Task ExecuteAsync(CancellationToken stoppingToken) { // Wait until the app is fully initialized: while (!stoppingToken.IsCancellationRequested && !IS_INITIALIZED) await Task.Delay(TimeSpan.FromSeconds(1), stoppingToken); // Register shortcuts on startup: await this.RegisterAllShortcuts(ShortcutSyncSource.STARTUP); } 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: await this.RegisterAllShortcuts(ShortcutSyncSource.CONFIGURATION_CHANGED); break; case Event.PLUGINS_RELOADED: await this.RegisterAllShortcuts(ShortcutSyncSource.PLUGINS_RELOADED); 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 (shortcut, isEnabled, usesPersistedFallback) = await this.GetShortcutState(shortcutId); this.logger.LogInformation( "Sync shortcut '{ShortcutId}' (source='{Source}', enabled={IsEnabled}, configured='{Shortcut}').", shortcutId, source, isEnabled, shortcut); if (usesPersistedFallback) { this.logger.LogWarning( "Using persisted shortcut fallback for '{ShortcutId}' during startup recovery (source='{Source}', configured='{Shortcut}').", shortcutId, source, shortcut); } if (isEnabled && !string.IsNullOrWhiteSpace(shortcut)) { var success = await this.rustService.UpdateGlobalShortcut(shortcutId, shortcut); if (success) this.logger.LogInformation("Global shortcut '{ShortcutId}' ({Shortcut}) registered.", shortcutId, shortcut); else this.logger.LogWarning("Failed to register global shortcut '{ShortcutId}' ({Shortcut}).", shortcutId, shortcut); } else { this.logger.LogInformation( "Disabling global shortcut '{ShortcutId}' (source='{Source}', enabled={IsEnabled}, configured='{Shortcut}').", shortcutId, source, isEnabled, shortcut); // Disable the shortcut when empty or feature is disabled: await this.rustService.UpdateGlobalShortcut(shortcutId, string.Empty); } } 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), // Other shortcuts are always allowed: _ => true, }; private async Task GetShortcutState(Shortcut shortcutId) { var shortcut = this.GetShortcutValue(shortcutId); var isEnabled = this.IsShortcutAllowed(shortcutId); if (isEnabled && !string.IsNullOrWhiteSpace(shortcut)) return new(shortcut, true, false); if (!this.IsWithinStartupRecoveryWindow() || 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 = settingsSnapshot.App.EnabledPreviewFeatures.Contains(PreviewFeatures.PRE_SPEECH_TO_TEXT_2026); if (!fallbackEnabled || string.IsNullOrWhiteSpace(fallbackShortcut)) return new(shortcut, isEnabled, false); return new(fallbackShortcut, true, true); } private bool IsWithinStartupRecoveryWindow() => DateTimeOffset.UtcNow - this.serviceStartedAt <= STARTUP_RECOVERY_WINDOW; private readonly record struct ShortcutState(string Shortcut, bool IsEnabled, bool UsesPersistedFallback); public static void Initialize() => IS_INITIALIZED = true; }