@ciphore/radiocli 0.2.1 → 0.2.3

package/dist/ui/App.js

@@ -1,20 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { fileURLToPath } from 'node:url';
 import { Box, Text, useApp, useStdin, useStdout, useWindowSize } from 'ink';
 import { ProviderManager } from '../providers/provider-manager.js';
 import { PlayerController } from '../player/player-controller.js';
 import { playbackBackendInstallHint, playbackBackendLabel } from '../player/backend-install.js';
 import { JsonLibraryStore, stationKey } from '../storage/store.js';
-import { receiverStyleNames } from '../types.js';
+import { defaultAgentControlSettings } from '../types.js';
 import { nextReceiverStyle, nextTheme, textDim, textMuted, themeAccent } from './theme.js';
 import { DisplayContext, resolveDisplayMode } from './display-context.js';
-import { homeItems, settingsItems } from './screen-items.js';
+import { homeItems, settingsItemsForPage } from './screen-items.js';
 import { AppContent } from './AppContent.js';
 import { TopTabs } from './components/TopTabs.js';
 import { computeTerminalLayout } from './layout.js';
 import { truncate } from './format.js';
 import { playbackFooterText, playbackStateForPendingStation } from './playback-footer.js';
-import { fullFooterRowCount, fullStatusFooterRows, microPlaybackControlsText, pageFooterText } from './page-footer.js';
+import { balancedFooterLegendRows, fullFooterRowCount, fullStatusFooterRows, microPlaybackControlsText, microShortcutFooterText, pageFooterText } from './page-footer.js';
 import { disableMouseReporting, enableMouseReporting, exploreCursorForMouseCell, shouldEnableMouseReporting } from './terminal-mouse.js';
 import { useAppInput } from './use-app-input.js';
 import { useCommandExecutor } from './use-command-executor.js';
@@ -23,14 +24,18 @@ import { isAirPlayBackendAvailable } from './airplay-settings.js';
 import { audioOutputLabel, resolvedAudioOutput } from './audio-output.js';
 import { copyToClipboard, openExternal } from './system-actions.js';
 import { appVersion } from '../version.js';
-import { checkForUpdate, installUpdate, shouldCheckForUpdate, updateCommandForInstall } from '../update-check.js';
+import { automaticUpdateChecksAllowed, checkForUpdate, installUpdate, shouldCheckForUpdate, updateAvailableForVersion, updateCommandForInstall } from '../update-check.js';
 import { helpItemCount } from './help-content.js';
 import { EXIT_CONFIRMATION_MS, ctrlCExitDecision } from './exit-confirmation.js';
-import { activeTabForScreen, addMediaKeyBinding, applyStationFilters, clamp, clampVolume, defaultExploreCursor, formatExploreCursor, formatFilterLabel, formatTimeLeft, initialStationContexts, mediaActionLabel, moveExploreCursor as shiftExploreCursor, nextReceiverPulse, nextSleepTimerMinutes, normalizeMediaKeyBindings, shouldAnimateReceiver, shouldResetReceiverPulse, shouldSkipAfterTuneError, stationApproximateTime, stationContextKeyForScreen, topTabs } from './app-state.js';
-const LIVE_RECEIVER_STYLES = new Set(receiverStyleNames);
-const LIVE_RECEIVER_PULSE_MS = 80;
-const SKYLINE_RECEIVER_PULSE_MS = 120;
-const AMBIENT_RECEIVER_PULSE_MS = 140;
+import { createAlarmTuiService, serializeAlarmTuiService } from './alarm-tui-service.js';
+import { useAlarmTui } from './use-alarm-tui.js';
+import { toAsciiSafe } from './ascii.js';
+import { registerTuiPresence } from '../alarms/tui-presence.js';
+import { configureMcpIntegrations } from '../agent/mcp-install.js';
+import { startRadioSession } from '../agent/session.js';
+import { activeTabForScreen, addMediaKeyBinding, applyStationFilters, clamp, clampVolume, defaultExploreCursor, formatExploreCursor, formatFilterLabel, formatTimeLeft, initialStationContexts, mediaActionLabel, moveExploreCursor as shiftExploreCursor, nextSleepTimerMinutes, normalizeMediaKeyBindings, shouldSkipAfterTuneError, stationApproximateTime, stationContextKeyForScreen, topTabs } from './app-state.js';
+import { ReceiverAnimationProvider } from './receiver-animation.js';
+import { VersionIndicator, versionIndicatorWidth } from './components/VersionIndicator.js';
 const LOADING_SPINNER_MS = 120;
 const VISUALIZER_MESSAGE_MS = 4500;
 const LISTENING_HEARTBEAT_MS = 30_000;
@@ -38,20 +43,23 @@ const COUNTRY_STATIONS_PAGE_SIZE = 120;
 const COUNTRY_STATIONS_LOAD_AHEAD = 12;
 const SEARCH_RESULTS_PAGE_SIZE = 90;
 const SEARCH_RESULTS_LOAD_AHEAD = 12;
+const BROKEN_STREAM_AUTO_SKIP_DELAY_MS = 1000;
 const settingToggleLabel = {
     resumeOnLaunch: 'Resume on launch',
     transparentBackground: 'Transparent background',
     asciiMode: 'ASCII-safe display',
     reduceMotion: 'Reduce motion',
-    mouseSupport: 'Mouse and trackpad scrolling'
+    mouseSupport: 'Mouse and trackpad scrolling',
+    automaticUpdateChecks: 'Automatic update checks'
 };
-export function App({ store: providedStore, providers: providedProviders }) {
+export function App({ store: providedStore, providers: providedProviders, alarmService: providedAlarmService, alarmPreview, initialAgentCommand, mcpConfigurator = configureMcpIntegrations, updateChecker = checkForUpdate }) {
     const { exit } = useApp();
     const { stdin } = useStdin();
     const { stdout } = useStdout();
     const { columns, rows } = useWindowSize();
     const store = useMemo(() => providedStore ?? new JsonLibraryStore(), [providedStore]);
     const providers = useMemo(() => providedProviders ?? new ProviderManager(), [providedProviders]);
+    const alarmService = useMemo(() => providedAlarmService ? serializeAlarmTuiService(providedAlarmService) : createAlarmTuiService(), [providedAlarmService]);
     const installedVersion = useMemo(() => appVersion(), []);
     const [library, setLibrary] = useState(() => store.snapshot());
     const settingsRef = useRef(library.settings);
@@ -62,6 +70,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
     const [availableAirPlayDevices, setAvailableAirPlayDevices] = useState(() => player.detectedAirPlayDevices());
     const [screen, setScreen] = useState('home');
     const [selected, setSelected] = useState(0);
+    const [settingsPage, setSettingsPage] = useState('root');
     const [message, setMessage] = useState(null);
     const [footerMessage, setFooterMessage] = useState(null);
     const [countries, setCountries] = useState([]);
@@ -78,7 +87,6 @@ export function App({ store: providedStore, providers: providedProviders }) {
     const [location, setLocation] = useState(null);
     const [exploreCursor, setExploreCursor] = useState(defaultExploreCursor);
     const [providerHealth, setProviderHealth] = useState({});
-    const [pulse, setPulse] = useState(0);
     const [spinnerFrame, setSpinnerFrame] = useState(0);
     const [commandMode, setCommandMode] = useState(false);
     const [commandText, setCommandText] = useState('');
@@ -88,7 +96,9 @@ export function App({ store: providedStore, providers: providedProviders }) {
     const [showDiagnostics, setShowDiagnostics] = useState(false);
     const [capturingTransportAction, setCapturingTransportAction] = useState(null);
     const announcedUpdateRef = useRef(false);
+    const automaticUpdateCheckStartedRef = useRef(false);
     const installingUpdateRef = useRef(false);
+    const configuringMcpRef = useRef(false);
     const displayStationsRef = useRef([]);
     const playbackQueueRef = useRef(null);
     const lastRawTransportAtRef = useRef(0);
@@ -98,6 +108,8 @@ export function App({ store: providedStore, providers: providedProviders }) {
     const playStationRef = useRef(() => undefined);
     const screenRef = useRef(screen);
     const selectedRef = useRef(selected);
+    const settingsPageRef = useRef(settingsPage);
+    const selectedBySettingsPageRef = useRef({});
     const selectedByScreenRef = useRef({});
     const stationContextsRef = useRef(stationContexts);
     const lastStationContextKeyRef = useRef('explore');
@@ -109,7 +121,6 @@ export function App({ store: providedStore, providers: providedProviders }) {
     const transientMessageTimerRef = useRef(null);
     const transientFooterMessageTimerRef = useRef(null);
     const exitConfirmationUntilRef = useRef(0);
-    const receiverPulseSnapshotRef = useRef(null);
     const helpReturnScreenRef = useRef('home');
     const countriesLoadAttemptedRef = useRef(false);
     const tuneRequestRef = useRef(0);
@@ -118,6 +129,9 @@ export function App({ store: providedStore, providers: providedProviders }) {
     const nearbyRequestRef = useRef(0);
     const skipBrokenTimerRef = useRef(null);
     const volumeRequestRef = useRef(0);
+    const agentHandlerRef = useRef(async () => {
+        throw new Error('RadioCLI is still starting.');
+    });
     const theme = library.settings.theme;
     const displayMode = useMemo(() => resolveDisplayMode(library.settings), [library.settings.transparentBackground, library.settings.asciiMode, library.settings.reduceMotion]);
     const favoriteKeys = useMemo(() => new Set(library.favorites.map(stationKey)), [library.favorites]);
@@ -141,6 +155,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
     }), [library, libraryStations, stationContexts]);
     screenRef.current = screen;
     selectedRef.current = selected;
+    settingsPageRef.current = settingsPage;
     loadingStationsRef.current = loadingStations;
     stationContextsRef.current = activeStationContexts;
     exploreCursorRef.current = exploreCursor;
@@ -165,9 +180,13 @@ export function App({ store: providedStore, providers: providedProviders }) {
         'now-playing': 1,
         library: 0,
         stats: 1,
+        alarms: 0,
+        'alarm-editor': 0,
+        'alarm-picker': 0,
+        'alarm-ringing': 0,
         'airplay-settings': 0,
         'airplay-code': 1,
-        settings: settingsItems.length,
+        settings: settingsItemsForPage(settingsPage).length,
         help: helpItemCount
     });
     itemCountsRef.current = {
@@ -181,9 +200,13 @@ export function App({ store: providedStore, providers: providedProviders }) {
         'now-playing': 1,
         library: stationCounts.library,
         stats: 1,
+        alarms: library.alarms.length,
+        'alarm-editor': 0,
+        'alarm-picker': 0,
+        'alarm-ringing': 0,
         'airplay-settings': availableAirPlayDevices.length,
         'airplay-code': 1,
-        settings: settingsItems.length,
+        settings: settingsItemsForPage(settingsPage).length,
         help: helpItemCount
     };
     const displayStations = useMemo(() => applyStationFilters(stationContext.stations, filters), [filters, stationContext.stations]);
@@ -204,6 +227,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
         !editingCountryFilter &&
         shouldEnableMouseReporting(screen, itemCountsRef.current[screen] ?? 0, mouseVisibleRows(screen, layout), library.settings.mouseSupport !== false);
     useEffect(() => player.onChange(setPlayback), [player]);
+    useEffect(() => stdin.isTTY ? registerTuiPresence() : undefined, [stdin]);
     const playingStationRef = useRef(null);
     playingStationRef.current = playingStation;
     const activeListeningStationRef = useRef(null);
@@ -259,33 +283,6 @@ export function App({ store: providedStore, providers: providedProviders }) {
             lastStationContextKeyRef.current = renderedStationContextKey;
         }
     }, [renderedStationContextKey, screen, selected]);
-    useEffect(() => {
-        const current = {
-            screen,
-            receiverStyle: library.settings.receiverStyle,
-            playbackState: playback.state,
-            playbackReady: playback.ready
-        };
-        if (shouldResetReceiverPulse(receiverPulseSnapshotRef.current, current)) {
-            setPulse(0);
-        }
-        receiverPulseSnapshotRef.current = current;
-    }, [library.settings.receiverStyle, playback.ready, playback.state, screen]);
-    useEffect(() => {
-        if (!shouldAnimateReceiver(screen, playback) ||
-            library.settings.reduceMotion ||
-            process.env.RADIOCLI_DISABLE_ANIMATION === '1' ||
-            process.env.RADIO_ATLAS_DISABLE_ANIMATION === '1') {
-            return;
-        }
-        const intervalMs = library.settings.receiverStyle === 'skyline'
-            ? SKYLINE_RECEIVER_PULSE_MS
-            : LIVE_RECEIVER_STYLES.has(library.settings.receiverStyle)
-                ? LIVE_RECEIVER_PULSE_MS
-                : AMBIENT_RECEIVER_PULSE_MS;
-        const timer = setInterval(() => setPulse(nextReceiverPulse), intervalMs);
-        return () => clearInterval(timer);
-    }, [library.settings.receiverStyle, library.settings.reduceMotion, playback.ready, playback.state, screen]);
     useEffect(() => {
         if (footerPlayback.state !== 'loading' ||
             library.settings.reduceMotion ||
@@ -363,14 +360,16 @@ export function App({ store: providedStore, providers: providedProviders }) {
         refreshProviderHealth();
     }, [refreshProviderHealth]);
     const refreshUpdateCheck = useCallback(async () => {
-        const updateCheck = await checkForUpdate({ currentVersion: installedVersion });
+        const updateCheck = await updateChecker({ currentVersion: installedVersion });
         setLibrary(store.updateCheckState(updateCheck));
         return updateCheck;
-    }, [installedVersion, store]);
+    }, [installedVersion, store, updateChecker]);
     useEffect(() => {
-        if (!shouldCheckForUpdate(library.updateCheck)) {
+        if (automaticUpdateCheckStartedRef.current ||
+            !automaticUpdateChecksAllowed(library.settings.automaticUpdateChecks !== false)) {
             return;
         }
+        automaticUpdateCheckStartedRef.current = true;
         let cancelled = false;
         void refreshUpdateCheck().then(updateCheck => {
             if (cancelled) {
@@ -384,7 +383,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
         return () => {
             cancelled = true;
         };
-    }, [library.updateCheck, refreshUpdateCheck]);
+    }, [library.settings.automaticUpdateChecks, refreshUpdateCheck]);
     const setStationContextFor = useCallback((key, context) => {
         setStationContexts(current => ({ ...current, [key]: context }));
     }, []);
@@ -432,18 +431,40 @@ export function App({ store: providedStore, providers: providedProviders }) {
         const destination = screenRef.current === 'help' && next === 'home'
             ? helpReturnScreenRef.current
             : next;
+        if (destination === 'settings' &&
+            screenRef.current !== 'settings' &&
+            screenRef.current !== 'airplay-settings' &&
+            screenRef.current !== 'airplay-code') {
+            settingsPageRef.current = 'root';
+            setSettingsPage('root');
+            itemCountsRef.current.settings = settingsItemsForPage('root').length;
+            selectedByScreenRef.current.settings = selectedBySettingsPageRef.current.root ?? 0;
+        }
         selectedByScreenRef.current[screenRef.current] = selectedRef.current;
         const remembered = selectedByScreenRef.current[destination] ?? 0;
         const nextSelection = options.resetSelection ? 0 : remembered;
-        if (destination === 'now-playing' && screenRef.current !== 'now-playing') {
-            setPulse(0);
-        }
         setScreen(destination);
         setSelected(clamp(nextSelection, (itemCountsRef.current[destination] ?? 0) - 1));
         if (options.clearMessage !== false) {
             setMessage(null);
         }
     }, []);
+    const openSettingsPage = useCallback((next) => {
+        selectedBySettingsPageRef.current[settingsPageRef.current] = selectedRef.current;
+        settingsPageRef.current = next;
+        setSettingsPage(next);
+        const nextSelection = clamp(selectedBySettingsPageRef.current[next] ?? 0, settingsItemsForPage(next).length - 1);
+        selectedRef.current = nextSelection;
+        setSelected(nextSelection);
+        setMessage(null);
+    }, []);
+    const closeSettingsPage = useCallback(() => {
+        if (settingsPageRef.current === 'root') {
+            go('home');
+            return;
+        }
+        openSettingsPage('root');
+    }, [go, openSettingsPage]);
     const openAirPlayCode = useCallback(() => {
         setAirPlayCode('');
         go('airplay-code', { resetSelection: true, clearMessage: false });
@@ -488,7 +509,8 @@ export function App({ store: providedStore, providers: providedProviders }) {
         setStationContextFor('explore', {
             title: 'Explore world',
             subtitle: `Scanning all geotagged stations near ${formatExploreCursor(cursor)}`,
-            stations: previousExploreStations
+            stations: previousExploreStations,
+            error: undefined
         });
         try {
             const stations = await providers.nearby(exploreCursorLocation(cursor), 90);
@@ -512,7 +534,13 @@ export function App({ store: providedStore, providers: providedProviders }) {
             if (requestId !== exploreRequestRef.current) {
                 return;
             }
-            setMessage(error instanceof Error ? error.message : 'Could not load world stations.');
+            const loadError = discoveryLoadError('Could not load world stations.', error);
+            setStationContextFor('explore', {
+                ...stationContextsRef.current.explore,
+                subtitle: `World station directory unavailable near ${formatExploreCursor(cursor)}`,
+                error: loadError
+            });
+            setMessage(loadError);
         }
         finally {
             if (requestId === exploreRequestRef.current) {
@@ -765,6 +793,10 @@ export function App({ store: providedStore, providers: providedProviders }) {
         nearbyRequestRef.current = requestId;
         setLoadingStations(true);
         setMessage(null);
+        setStationContextFor('nearby', {
+            ...stationContextsRef.current.nearby,
+            error: undefined
+        });
         go('nearby', { resetSelection: stationContextsRef.current.nearby.stations.length === 0 });
         try {
             if (!settingsRef.current.enableNearbyLocation) {
@@ -775,7 +807,8 @@ export function App({ store: providedStore, providers: providedProviders }) {
                 setStationContextFor('nearby', {
                     title: 'Nearby',
                     subtitle: 'IP-based location is off. Enable it in Settings or use :location on.',
-                    stations: []
+                    stations: [],
+                    error: undefined
                 });
                 return;
             }
@@ -791,7 +824,8 @@ export function App({ store: providedStore, providers: providedProviders }) {
                 setStationContextFor('nearby', {
                     title: 'Nearby',
                     subtitle: 'Location detection was unavailable',
-                    stations: []
+                    stations: [],
+                    error: 'Could not determine an approximate location.'
                 });
                 return;
             }
@@ -807,7 +841,12 @@ export function App({ store: providedStore, providers: providedProviders }) {
         catch (error) {
             if (requestId !== nearbyRequestRef.current)
                 return;
-            setMessage(error instanceof Error ? error.message : 'Could not load nearby stations.');
+            const loadError = discoveryLoadError('Could not load nearby stations.', error);
+            setStationContextFor('nearby', {
+                ...stationContextsRef.current.nearby,
+                error: loadError
+            });
+            setMessage(loadError);
         }
         finally {
             if (requestId === nearbyRequestRef.current)
@@ -841,6 +880,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
             selectedByScreenRef.current[queue.sourceScreen] = index;
         }
         if (screenRef.current === queue.sourceScreen) {
+            selectedRef.current = index;
             setSelected(index);
         }
     }, []);
@@ -867,6 +907,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
             await player.play(station, resolved.url);
             if (requestId !== tuneRequestRef.current)
                 return;
+            playingStationRef.current = station;
             setPlayingStation(station);
             setTuningStation(null);
             playbackQueueRef.current = queue;
@@ -899,7 +940,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
                 skipBrokenTimerRef.current = setTimeout(() => {
                     skipBrokenTimerRef.current = null;
                     playStationRef.current(nextStation, { ...options, queue });
-                }, 250);
+                }, BROKEN_STREAM_AUTO_SKIP_DELAY_MS);
                 return;
             }
             setTuningStation(null);
@@ -923,6 +964,14 @@ export function App({ store: providedStore, providers: providedProviders }) {
         }
     }, [playStation, store]);
     playStationRef.current = playStation;
+    const cancelPendingAutoSkip = useCallback(() => {
+        if (!skipBrokenTimerRef.current)
+            return;
+        clearTimeout(skipBrokenTimerRef.current);
+        skipBrokenTimerRef.current = null;
+        setTuningStation(null);
+        setMessage('Auto-skip canceled. Choose a station and press Enter.');
+    }, []);
     const showTransientFooterMessage = useCallback((nextMessage, durationMs = VISUALIZER_MESSAGE_MS) => {
         if (transientFooterMessageTimerRef.current) {
             clearTimeout(transientFooterMessageTimerRef.current);
@@ -1045,7 +1094,6 @@ export function App({ store: providedStore, providers: providedProviders }) {
     }, [showTransientMessage, updateSettings]);
     const cycleReceiverStyle = useCallback(() => {
         const receiverStyle = nextReceiverStyle(settingsRef.current.receiverStyle);
-        setPulse(0);
         updateSettings({ receiverStyle });
         showTransientMessage(`Receiver style: ${receiverStyle}`);
     }, [showTransientMessage, updateSettings]);
@@ -1066,7 +1114,8 @@ export function App({ store: providedStore, providers: providedProviders }) {
             const current = stationContextsRef.current.nearby;
             setStationContextFor('nearby', {
                 ...current,
-                subtitle: 'Location lookup off · showing the last loaded results'
+                subtitle: 'Location lookup off · showing the last loaded results',
+                error: undefined
             });
         }
     }, [loadNearby, setStationContextFor, updateSettings]);
@@ -1178,6 +1227,59 @@ export function App({ store: providedStore, providers: providedProviders }) {
         updateSettings({ [key]: next });
         setMessage(`${settingToggleLabel[key]} ${next ? 'on' : 'off'}.`);
     }, [updateSettings]);
+    const toggleAgentSetting = useCallback((key) => {
+        const agentControl = settingsRef.current.agentControl ?? defaultAgentControlSettings;
+        const next = !agentControl[key];
+        updateSettings({ agentControl: { ...agentControl, [key]: next } });
+        setMessage(`Agent ${key === 'openUiOnPlay' ? 'TUI launch' : 'Now Playing focus'} ${next ? 'on' : 'off'}.`);
+    }, [updateSettings]);
+    const setAgentIntegrationEnabled = useCallback(async () => {
+        if (configuringMcpRef.current) {
+            setMessage('Agent integration setup is already in progress.');
+            return;
+        }
+        configuringMcpRef.current = true;
+        const enabled = !(settingsRef.current.agentControl ?? defaultAgentControlSettings).enabled;
+        setMessage(enabled ? 'Setting up agent and Codex Voice control...' : 'Disabling agent and voice control...');
+        try {
+            const results = await mcpConfigurator(enabled, mcpRuntime(), null);
+            const failed = results.filter(item => item.status === 'failed');
+            const agentControl = settingsRef.current.agentControl ?? defaultAgentControlSettings;
+            updateSettings({ agentControl: { ...agentControl, enabled } });
+            setMessage(integrationResultMessage(enabled, results, failed));
+        }
+        catch (error) {
+            if (!enabled) {
+                const agentControl = settingsRef.current.agentControl ?? defaultAgentControlSettings;
+                updateSettings({ agentControl: { ...agentControl, enabled: false } });
+            }
+            setMessage(`Agent integration ${enabled ? 'setup' : 'removal'} failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            configuringMcpRef.current = false;
+        }
+    }, [mcpConfigurator, updateSettings]);
+    const repairMcpIntegrations = useCallback(async () => {
+        if (configuringMcpRef.current) {
+            setMessage('Agent integration setup is already in progress.');
+            return;
+        }
+        configuringMcpRef.current = true;
+        setMessage('Checking and repairing agent integrations...');
+        try {
+            const results = await mcpConfigurator(true, mcpRuntime(), null);
+            const failed = results.filter(item => item.status === 'failed');
+            const agentControl = settingsRef.current.agentControl ?? defaultAgentControlSettings;
+            updateSettings({ agentControl: { ...agentControl, enabled: true } });
+            setMessage(integrationResultMessage(true, results, failed));
+        }
+        catch (error) {
+            setMessage(`MCP repair failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            configuringMcpRef.current = false;
+        }
+    }, [mcpConfigurator, updateSettings]);
     const cycleSleepTimer = useCallback(() => {
         const currentMinutes = sleepUntil ? Math.round((sleepUntil - Date.now()) / 60000) : null;
         const next = nextSleepTimerMinutes(currentMinutes);
@@ -1187,6 +1289,23 @@ export function App({ store: providedStore, providers: providedProviders }) {
         go('library', { resetSelection: false });
     }, [go]);
     const selectedStation = displayStations[selected] ?? null;
+    const selectedStationForInput = useCallback(() => displayStationsRef.current[selectedRef.current] ?? null, []);
+    const alarmTui = useAlarmTui({
+        service: alarmService,
+        store,
+        library,
+        setLibrary,
+        screen,
+        selected,
+        setSelected,
+        go,
+        setMessage,
+        playingStation,
+        previewStation: alarmPreview ?? (station => playStation(station))
+    });
+    for (const alarmScreen of ['alarms', 'alarm-editor', 'alarm-picker', 'alarm-ringing']) {
+        itemCountsRef.current[alarmScreen] = alarmTui.itemCount(alarmScreen) ?? 0;
+    }
     const openScreen = useCallback((target) => {
         if (target === 'explore') {
             if (stationContextsRef.current.explore.stations.length > 0) {
@@ -1250,7 +1369,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
             return;
         }
         const currentUpdateCheck = store.snapshot().updateCheck ?? library.updateCheck;
-        if (!currentUpdateCheck?.updateAvailable) {
+        if (!updateAvailableForVersion(currentUpdateCheck, installedVersion)) {
             setMessage('Checking for updates...');
             const latest = await refreshUpdateCheck();
             if (latest.error) {
@@ -1270,12 +1389,25 @@ export function App({ store: providedStore, providers: providedProviders }) {
         const result = await installUpdate(command.command);
         installingUpdateRef.current = false;
         if (result.ok) {
-            setMessage(`Update installed. Restart RadioCLI to use the new version.`);
+            const agentControl = settingsRef.current.agentControl ?? defaultAgentControlSettings;
+            if (agentControl.enabled) {
+                try {
+                    const repaired = await mcpConfigurator(true, mcpRuntime(), null);
+                    const suffix = repaired.some(item => item.status === 'failed') ? ' Some MCP clients need manual repair.' : ' MCP integrations repaired.';
+                    setMessage(`Update installed.${suffix} Restart RadioCLI and open agent clients.`);
+                }
+                catch {
+                    setMessage('Update installed. MCP repair failed; run radiocli mcp repair, then restart RadioCLI and open agent clients.');
+                }
+            }
+            else {
+                setMessage('Update installed. Restart RadioCLI to use the new version.');
+            }
             return;
         }
         const detail = result.output ? ` ${result.output.split('\n').at(-1)}` : '';
         setMessage(`Update install failed. Run manually: ${result.command}.${detail}`);
-    }, [installedVersion, library.updateCheck, refreshUpdateCheck, store]);
+    }, [installedVersion, library.updateCheck, mcpConfigurator, refreshUpdateCheck, store]);
     const executeCommand = useCommandExecutor({
         beginLearningTransportKey,
         countries,
@@ -1327,10 +1459,165 @@ export function App({ store: providedStore, providers: providedProviders }) {
             void playStation(nextStation, { queue });
         }
     }, [playStation, playingStation, queueContainsStation, queueFromCurrentList, rememberQueueSelection]);
+    agentHandlerRef.current = async (command) => {
+        const sessionStatus = () => ({
+            owner: 'tui',
+            playback: player.getState(),
+            station: playingStationRef.current,
+            queue: playbackQueueRef.current?.stations ?? [],
+            output: {
+                preferredBackend: settingsRef.current.preferredBackend,
+                preferredAirPlayDevice: settingsRef.current.preferredAirPlayDevice
+            }
+        });
+        const respond = (message, ok = true, data) => ({ ok, message, status: sessionStatus(), ...(data ? { data } : {}) });
+        if (command.type === 'status')
+            return respond(playingStationRef.current ? `${player.getState().state}: ${playingStationRef.current.name}` : 'RadioCLI is idle.');
+        if (command.type === 'play') {
+            if (command.ifPlaying === 'keep' && ['playing', 'paused', 'loading'].includes(player.getState().state)) {
+                return respond(`Kept current station ${playingStationRef.current?.name ?? ''}.`);
+            }
+            const queue = { title: 'Agent selection', sourceScreen: 'now-playing', sourceContextKey: null, stations: command.queue?.length ? command.queue : [command.station] };
+            await playStation(command.station, { queue, openNowPlaying: command.openNowPlaying });
+            const state = player.getState();
+            const playingRequestedStation = playingStationRef.current
+                && stationKey(playingStationRef.current) === stationKey(command.station)
+                && state.state === 'playing'
+                && state.ready;
+            return playingRequestedStation
+                ? respond(`Playing ${command.station.name}.`)
+                : respond(state.state === 'error' ? state.message ?? `Could not play ${command.station.name}.` : `Could not play ${command.station.name}.`, false);
+        }
+        if (command.type === 'pause') {
+            const control = await player.pause();
+            return respond(control.message ?? 'Paused.', control.ok);
+        }
+        if (command.type === 'resume') {
+            const control = await player.resume();
+            return respond(control.message ?? 'Resumed.', control.ok);
+        }
+        if (command.type === 'stop') {
+            tuneRequestRef.current += 1;
+            setLibrary(store.finishActiveListeningSession());
+            await player.stop();
+            playingStationRef.current = null;
+            setPlayingStation(null);
+            setTuningStation(null);
+            playbackQueueRef.current = null;
+            return respond('Stopped RadioCLI.');
+        }
+        if (command.type === 'alarm-preempt') {
+            tuneRequestRef.current += 1;
+            setLibrary(store.finishActiveListeningSession());
+            await player.stop();
+            playingStationRef.current = null;
+            setPlayingStation(null);
+            setTuningStation(null);
+            playbackQueueRef.current = null;
+            return respond('Interactive playback yielded to the alarm.');
+        }
+        if (command.type === 'set-volume') {
+            const control = await player.setVolume(clampVolume(command.volume));
+            if (control.ok)
+                updateSettings({ volume: player.getState().volume });
+            return respond(control.message ?? `Volume ${player.getState().volume}.`, control.ok);
+        }
+        if (command.type === 'set-muted') {
+            const control = await player.setMuted(command.muted);
+            return respond(control.message ?? (command.muted ? 'Muted.' : 'Unmuted.'), control.ok);
+        }
+        if (command.type === 'set-favorite') {
+            const station = command.station ?? playingStationRef.current;
+            if (!station)
+                return respond('No active station to favorite.', false);
+            const current = store.isFavorite(station);
+            if (current !== command.favorite)
+                toggleFavorite(station);
+            return respond(`${command.favorite ? 'Favorited' : 'Removed favorite'}: ${station.name}.`);
+        }
+        if (command.type === 'airplay-list') {
+            const devices = await refreshAirPlayTargets(false);
+            return respond(devices.length ? `${devices.length} AirPlay receiver(s) found.` : 'No AirPlay receivers found.', true, devices);
+        }
+        if (command.type === 'airplay-select') {
+            const devices = await refreshAirPlayTargets(false);
+            const device = devices.find(item => item.id === command.deviceId);
+            if (!device)
+                return respond('AirPlay receiver not found. Refresh and use an exact receiver ID.', false, devices);
+            if (device.local) {
+                const backend = preferredLocalPlaybackBackend(availableBackends);
+                if (!backend)
+                    return respond('No local playback backend is available. Run radiocli setup to install mpv.', false);
+                updateSettings({ preferredBackend: backend });
+                if (playingStationRef.current && shouldRetuneForAudioOutput(player.getState().state)) {
+                    await playStation(playingStationRef.current, { queue: playbackQueueRef.current ?? queueFromCurrentList(playingStationRef.current) });
+                }
+                return respond(`Audio output set to this device (${backend}).`);
+            }
+            if (!isAirPlayBackendAvailable(availableBackends))
+                return respond('AirPlay playback is unavailable; run radiocli doctor.', false);
+            updateSettings({ preferredAirPlayDevice: device.id });
+            updateSettings({ preferredBackend: 'airplay' });
+            if (playingStationRef.current && shouldRetuneForAudioOutput(player.getState().state)) {
+                await playStation(playingStationRef.current, { queue: playbackQueueRef.current ?? queueFromCurrentList(playingStationRef.current) });
+            }
+            return respond(`Audio output set to AirPlay receiver ${device.name}.`);
+        }
+        if (command.type === 'airplay-local') {
+            const backend = preferredLocalPlaybackBackend(availableBackends);
+            if (!backend)
+                return respond('No local playback backend is available. Run radiocli setup to install mpv.', false);
+            updateSettings({ preferredBackend: backend });
+            if (playingStationRef.current && shouldRetuneForAudioOutput(player.getState().state)) {
+                await playStation(playingStationRef.current, { queue: playbackQueueRef.current ?? queueFromCurrentList(playingStationRef.current) });
+            }
+            return respond(`Audio output set to this device (${backend}).`);
+        }
+        if (command.type === 'airplay-passcode') {
+            const control = player.submitAirPlayPasscode(command.code);
+            return respond(control.message ?? 'AirPlay code sent.', control.ok);
+        }
+        if (command.type === 'update-settings') {
+            updateSettings(command.settings);
+            return respond('RadioCLI settings updated.');
+        }
+        const active = playingStationRef.current;
+        const queue = playbackQueueRef.current;
+        if (!active || !queue?.stations.length)
+            return respond('No playback queue is available.', false);
+        const currentIndex = queue.stations.findIndex(item => stationKey(item) === stationKey(active));
+        const delta = command.type === 'next' ? 1 : -1;
+        const next = queue.stations[(Math.max(0, currentIndex) + delta + queue.stations.length) % queue.stations.length];
+        if (!next)
+            return respond('No adjacent station is available.', false);
+        await playStation(next, { queue });
+        return respond(`Playing ${next.name}.`);
+    };
+    useEffect(() => {
+        if (!stdin.isTTY || !(settingsRef.current.agentControl ?? defaultAgentControlSettings).enabled)
+            return;
+        let disposed = false;
+        let close;
+        void startRadioSession(command => agentHandlerRef.current(command)).then(async (session) => {
+            if (disposed) {
+                await session.close();
+                return;
+            }
+            close = session.close;
+            if (initialAgentCommand)
+                await agentHandlerRef.current(initialAgentCommand);
+        }).catch(error => setMessage(error instanceof Error ? error.message : 'Agent controls could not start.'));
+        return () => {
+            disposed = true;
+            if (close)
+                void close();
+        };
+    }, [initialAgentCommand, library.settings.agentControl?.enabled, stdin]);
     useAppInput({
         adjustVolume,
         airPlayCode,
         canEnterAirPlayCode,
+        cancelPendingAutoSkip,
         copyStationUrl,
         openStationHomepage,
         beginLearningTransportKey,
@@ -1354,7 +1641,12 @@ export function App({ store: providedStore, providers: providedProviders }) {
         openAdjacentTab,
         openAirPlayCode,
         openAirPlaySettings,
+        openSettingsPage,
+        closeSettingsPage,
         openScreen,
+        handleAlarmInput: alarmTui.handleInput,
+        openAlarmForStation: alarmTui.openForStation,
+        openActiveAlarms: alarmTui.openActive,
         playAdjacent,
         playStation,
         player,
@@ -1367,12 +1659,15 @@ export function App({ store: providedStore, providers: providedProviders }) {
             void refreshAirPlayTargets();
         },
         resetLearnedTransportKeys,
+        repairMcpIntegrations,
+        setAgentIntegrationEnabled,
         runSearch,
         saveLearnedTransportKey,
         screen,
+        settingsPage,
         searchQuery,
-        selected,
-        selectedStation,
+        selectedRef,
+        selectedStationForInput,
         selectAirPlayDeviceAt,
         setCapturingTransportAction,
         setCommandMode,
@@ -1393,6 +1688,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
         toggleMute,
         togglePause,
         toggleSetting,
+        toggleAgentSetting,
         toggleNearbyLocation,
         toggleDirectoryVoting,
         toggleRadioGarden,
@@ -1414,7 +1710,7 @@ export function App({ store: providedStore, providers: providedProviders }) {
         width: frameWidth,
         spinnerFrame
     });
-    const pageFooter = pageFooterText({
+    const basePageFooter = pageFooterText({
         canEnterAirPlayCode,
         capturingTransportAction,
         commandMode,
@@ -1422,15 +1718,18 @@ export function App({ store: providedStore, providers: providedProviders }) {
         editingCountryFilter,
         editingSearch,
         playbackBackend: playback.backend,
-        screen
+        screen,
+        settingsPage
     });
+    const pageFooter = alarmTui.activeAlarms.length > 0 && screen !== 'alarm-ringing'
+        ? `ALARM PLAYING · ! controls · ${basePageFooter}`
+        : basePageFooter;
     const pageFooterOwnsCompactRow = Boolean(commandMode ||
         capturingTransportAction ||
         editingCountryFilter ||
         (screen === 'search' && editingSearch) ||
         screen === 'airplay-code');
     const hasActiveMicroPlayback = Boolean(footerStation && (footerPlayback.state === 'playing' || footerPlayback.state === 'paused'));
-    const compactFooter = footerMessage ?? message ?? (pageFooterOwnsCompactRow ? pageFooter : playbackFooter ?? pageFooter);
     const microFooter = footerMessage ?? message ?? (pageFooterOwnsCompactRow
         ? pageFooter
         : footerPlayback.state === 'loading' && playbackFooter
@@ -1438,9 +1737,31 @@ export function App({ store: providedStore, providers: providedProviders }) {
             : hasActiveMicroPlayback
                 ? microPlaybackControlsText(playback.backend)
                 : pageFooter);
-    const compactGlobalFooter = `←/→ tabs · ? help · q quit · v${installedVersion}`;
+    const compactGlobalFooter = '←/→ tabs · ? help · q quit';
+    const versionReserve = versionIndicatorWidth(installedVersion, library.updateCheck) + 2;
     const fullStatusRows = fullStatusFooterRows(screen, message, footerMessage, playbackFooter);
-    return (_jsx(DisplayContext.Provider, { value: displayMode, children: _jsxs(Box, { flexDirection: "column", paddingX: layout.horizontalPadding, height: layout.rows, width: layout.columns, overflow: "hidden", backgroundColor: displayMode.app, children: [hasTopTabs ? (_jsx(Box, { height: 3, flexShrink: 0, backgroundColor: displayMode.app, children: _jsx(TopTabs, { tabs: topTabs, active: activeTabForScreen(screen), theme: theme, width: frameWidth, backendLabel: playbackBackendLabel(playback.backend) }) })) : null, _jsx(Box, { height: layout.contentRows, width: frameWidth, flexDirection: "column", overflowY: "hidden", flexShrink: 0, backgroundColor: displayMode.app, children: _jsx(AppContent, { airPlayDevices: availableAirPlayDevices, airPlayCode: airPlayCode, appVersion: installedVersion, backends: availableBackends, countryFilter: countryFilter, diagnostics: diagnostics, displayStations: displayStations, editingCountryFilter: editingCountryFilter, editingSearch: editingSearch, favoriteKeys: favoriteKeys, filterLabel: filterLabel, filteredCountries: filteredCountries, frameWidth: frameWidth, layout: layout, library: library, loadingCountries: loadingCountries, loadingStations: loadingStations, nowPlaying: nowPlaying, playback: footerPlayback, playingStation: footerStation, providerHealth: providerHealth, pulse: pulse, searchQuery: searchQuery, screen: screen, selected: selected, showDiagnostics: showDiagnostics, sleepLabel: sleepLabel, stationContext: stationContext, exploreCursor: exploreCursor, stationFavorite: store.isFavorite(footerStation), stationTime: stationApproximateTime(footerStation), storePath: store.filePath, theme: theme, updateCheck: library.updateCheck }) }), _jsx(Box, { height: layout.footerRows, width: frameWidth, flexDirection: "column", flexShrink: 0, backgroundColor: displayMode.app, children: layout.mode === 'full' ? (_jsxs(_Fragment, { children: [fullStatusRows.map(statusRow => (_jsx(Text, { color: themeAccent(theme), children: truncate(statusRow.text, frameWidth) }, statusRow.key))), _jsx(Text, { color: commandMode || capturingTransportAction ? themeAccent(theme) : textMuted, children: truncate(pageFooter, frameWidth) }), _jsxs(Box, { children: [_jsx(Text, { color: textDim, children: truncate(globalFooter, Math.max(1, frameWidth - installedVersion.length - 3)) }), _jsx(Box, { flexGrow: 1 }), _jsxs(Text, { color: textDim, children: ["v", installedVersion] })] })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: commandMode || capturingTransportAction || footerMessage || message ? themeAccent(theme) : textMuted, children: truncate(layout.mode === 'micro' ? microFooter : compactFooter, frameWidth) }), layout.footerRows > 1 ? _jsx(Text, { color: textDim, children: truncate(compactGlobalFooter, frameWidth) }) : null] })) })] }) }));
+    const fullLegendRows = balancedFooterLegendRows(pageFooter, globalFooter, frameWidth, 2, versionReserve);
+    const compactStatus = footerMessage ?? message ?? playbackFooter;
+    const compactLegendRowCount = Math.max(1, layout.footerRows - (compactStatus ? 1 : 0));
+    const compactLegendRows = balancedFooterLegendRows(pageFooter, compactGlobalFooter, frameWidth, compactLegendRowCount, versionReserve);
+    const microLegendWidth = Math.max(1, frameWidth - versionReserve);
+    const microLegend = commandMode || capturingTransportAction || footerMessage || message
+        ? microFooter
+        : microShortcutFooterText(microFooter, microLegendWidth);
+    const footerText = (value) => displayMode.ascii ? toAsciiSafe(value) : value;
+    return (_jsx(ReceiverAnimationProvider, { screen: screen, playback: playback, receiverStyle: library.settings.receiverStyle, reduceMotion: Boolean(library.settings.reduceMotion), children: _jsx(DisplayContext.Provider, { value: displayMode, children: _jsxs(Box, { flexDirection: "column", paddingX: layout.horizontalPadding, height: layout.rows, width: layout.columns, overflow: "hidden", backgroundColor: displayMode.app, children: [hasTopTabs ? (_jsx(Box, { height: 3, flexShrink: 0, backgroundColor: displayMode.app, children: _jsx(TopTabs, { tabs: topTabs, active: activeTabForScreen(screen), theme: theme, width: frameWidth, backendLabel: playbackBackendLabel(playback.backend) }) })) : null, _jsx(Box, { height: layout.contentRows, width: frameWidth, flexDirection: "column", overflowY: "hidden", flexShrink: 0, backgroundColor: displayMode.app, children: _jsx(AppContent, { airPlayDevices: availableAirPlayDevices, airPlayCode: airPlayCode, appVersion: installedVersion, backends: availableBackends, countryFilter: countryFilter, diagnostics: diagnostics, displayStations: displayStations, editingCountryFilter: editingCountryFilter, editingSearch: editingSearch, favoriteKeys: favoriteKeys, filterLabel: filterLabel, filteredCountries: filteredCountries, frameWidth: frameWidth, layout: layout, library: library, loadingCountries: loadingCountries, loadingStations: loadingStations, nowPlaying: nowPlaying, playback: footerPlayback, playingStation: footerStation, providerHealth: providerHealth, searchQuery: searchQuery, screen: screen, settingsPage: settingsPage, selected: selected, showDiagnostics: showDiagnostics, sleepLabel: sleepLabel, stationContext: stationContext, exploreCursor: exploreCursor, stationFavorite: store.isFavorite(footerStation), stationTime: stationApproximateTime(footerStation), storePath: store.filePath, theme: theme, updateCheck: library.updateCheck, alarmTui: alarmTui }) }), _jsx(Box, { height: layout.footerRows, width: frameWidth, flexDirection: "column", flexShrink: 0, backgroundColor: displayMode.app, children: layout.mode === 'full' ? (_jsxs(_Fragment, { children: [fullStatusRows.map(statusRow => (_jsx(Text, { color: themeAccent(theme), children: footerText(truncate(statusRow.text, frameWidth)) }, statusRow.key))), _jsx(Text, { color: commandMode || capturingTransportAction ? themeAccent(theme) : textMuted, children: footerText(fullLegendRows[0] ?? ' ') }), _jsxs(Box, { children: [_jsx(Text, { color: textDim, children: footerText(fullLegendRows[1] ?? ' ') }), _jsx(Box, { flexGrow: 1 }), _jsx(VersionIndicator, { currentVersion: installedVersion, updateCheck: library.updateCheck, theme: theme })] })] })) : (_jsx(_Fragment, { children: layout.mode === 'micro' ? _jsxs(Box, { children: [_jsx(Text, { color: commandMode || capturingTransportAction || footerMessage || message ? themeAccent(theme) : textMuted, children: footerText(truncate(microLegend, microLegendWidth)) }), _jsx(Box, { flexGrow: 1 }), _jsx(VersionIndicator, { currentVersion: installedVersion, updateCheck: library.updateCheck, theme: theme })] }) : _jsxs(_Fragment, { children: [compactStatus ? _jsx(Text, { color: footerMessage || message ? themeAccent(theme) : textMuted, children: footerText(truncate(compactStatus, frameWidth)) }) : null, compactLegendRows.map((row, index) => index === compactLegendRows.length - 1 ? _jsxs(Box, { children: [_jsx(Text, { color: textDim, children: footerText(row) }), _jsx(Box, { flexGrow: 1 }), _jsx(VersionIndicator, { currentVersion: installedVersion, updateCheck: library.updateCheck, theme: theme })] }, `legend-${index}`) : _jsx(Text, { color: index === 0 ? textMuted : textDim, children: footerText(row) }, `legend-${index}`))] }) })) })] }) }) }));
+}
+function mcpRuntime() {
+    return { nodePath: process.execPath, cliPath: fileURLToPath(new URL('../cli.js', import.meta.url)) };
+}
+function integrationResultMessage(enabled, results, failed) {
+    if (failed.length > 0) {
+        return `${enabled ? 'Agent control enabled' : 'Agent control disabled'}, but ${failed.map(item => item.client).join(', ')} need attention. Run radiocli mcp status for details.`;
+    }
+    const configured = results.filter(item => item.status === (enabled ? 'configured' : 'removed')).map(item => item.client);
+    if (!enabled)
+        return 'Agent and voice control disabled; detected MCP registrations were removed.';
+    return `Agent and voice control ready${configured.length ? ` for ${configured.join(', ')}` : ''}. Restart open Codex or agent clients, then ask them to control RadioCLI.`;
 }
 function buildLibraryStations(library) {
     const stations = [];
@@ -1512,6 +1833,13 @@ function formatDistanceKm(distanceKm) {
     }
     return `${Math.round(distanceKm).toLocaleString()} km`;
 }
+function discoveryLoadError(fallback, error) {
+    const detail = error instanceof Error ? error.message.trim() : '';
+    if (!detail || detail === fallback || fallback.includes(detail)) {
+        return fallback;
+    }
+    return `${fallback} ${detail}`;
+}
 function nextAvailablePlaybackBackend(current, backends) {
     const options = ['auto'];
     for (const backend of ['mpv', 'ffplay', 'vlc', 'airplay']) {
@@ -1557,6 +1885,12 @@ function librarySubtitle(library) {
 function mouseVisibleRows(screen, layout) {
     if (screen === 'help')
         return Math.max(3, layout.contentRows - 4);
+    if (screen === 'alarms' || screen === 'alarm-editor')
+        return Math.max(1, layout.contentRows - 7);
+    if (screen === 'alarm-picker')
+        return Math.max(1, layout.contentRows - 5);
+    if (screen === 'alarm-ringing')
+        return Math.max(1, layout.contentRows - 7);
     if (layout.compact)
         return Math.max(1, layout.contentRows - 3);
     if (screen === 'countries')