@ciphore/radiocli 0.2.2 → 0.2.4

package/dist/ui/App.js

@@ -1,17 +1,19 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { Box, Text, useApp, useStdin, useStdout, useWindowSize } from 'ink';
+import { fileURLToPath } from 'node:url';
+import { Box, Text, useApp, useIsScreenReaderEnabled, 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 { airPlayMacOSOnlyMessage, isAirPlayPlatformSupported, playbackBackendInstallHint, playbackBackendLabel } from '../player/backend-install.js';
 import { JsonLibraryStore, stationKey } from '../storage/store.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 { displayWidth, truncate } from './format.js';
+import { truncate } from './format.js';
 import { playbackFooterText, playbackStateForPendingStation } from './playback-footer.js';
 import { balancedFooterLegendRows, fullFooterRowCount, fullStatusFooterRows, microPlaybackControlsText, microShortcutFooterText, pageFooterText } from './page-footer.js';
 import { disableMouseReporting, enableMouseReporting, exploreCursorForMouseCell, shouldEnableMouseReporting } from './terminal-mouse.js';
@@ -19,20 +21,25 @@ import { useAppInput } from './use-app-input.js';
 import { useCommandExecutor } from './use-command-executor.js';
 import { isAirPlayCodePromptActive } from './screens/AirPlayCodeScreen.js';
 import { isAirPlayBackendAvailable } from './airplay-settings.js';
+import { networkPolicy } from '../platform/network.js';
 import { audioOutputLabel, resolvedAudioOutput } from './audio-output.js';
 import { copyToClipboard, openExternal } from './system-actions.js';
+import { safeExternalHttpUrl, safeMediaTarget, sanitizeTerminalText } from '../safety.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 { 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 TRANSIENT_NOTICE_MS = 4500;
 const LISTENING_HEARTBEAT_MS = 30_000;
 const COUNTRY_STATIONS_PAGE_SIZE = 120;
 const COUNTRY_STATIONS_LOAD_AHEAD = 12;
@@ -44,17 +51,20 @@ const settingToggleLabel = {
     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, alarmService: providedAlarmService, alarmPreview }) {
+export function App({ store: providedStore, providers: providedProviders, alarmService: providedAlarmService, alarmPreview, initialAgentCommand, mcpConfigurator = configureMcpIntegrations, updateChecker = checkForUpdate, platform = process.platform }) {
     const { exit } = useApp();
     const { stdin } = useStdin();
     const { stdout } = useStdout();
     const { columns, rows } = useWindowSize();
+    const screenReader = useIsScreenReaderEnabled();
     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 airPlaySupported = isAirPlayPlatformSupported(platform);
     const [library, setLibrary] = useState(() => store.snapshot());
     const settingsRef = useRef(library.settings);
     settingsRef.current = library.settings;
@@ -64,7 +74,10 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     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 [persistenceWarning, setPersistenceWarning] = useState(null);
+    const [presenceWarning, setPresenceWarning] = useState(null);
     const [footerMessage, setFooterMessage] = useState(null);
     const [countries, setCountries] = useState([]);
     const [countryFilter, setCountryFilter] = useState('');
@@ -88,8 +101,27 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     const [sleepUntil, setSleepUntil] = useState(null);
     const [showDiagnostics, setShowDiagnostics] = useState(false);
     const [capturingTransportAction, setCapturingTransportAction] = useState(null);
+    const reportActionError = useCallback((error) => {
+        setMessage(sanitizeTerminalText(error instanceof Error ? error.message : String(error)) ?? 'Could not complete this action.');
+    }, []);
+    // Optional history cannot change the result of playback or navigation. Keep
+    // its warning until an explicit save succeeds; a no-op checkpoint proves nothing.
+    const persistLibrary = useCallback((write) => {
+        try {
+            const nextLibrary = write();
+            setLibrary(nextLibrary);
+            return nextLibrary;
+        }
+        catch (error) {
+            const detail = sanitizeTerminalText(error instanceof Error ? error.message : String(error));
+            setPersistenceWarning(`Library not saved. Set RADIOCLI_HOME to a writable directory.${detail ? ` ${detail}` : ''}`);
+            return undefined;
+        }
+    }, []);
     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);
@@ -99,6 +131,8 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     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');
@@ -118,8 +152,21 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     const nearbyRequestRef = useRef(0);
     const skipBrokenTimerRef = useRef(null);
     const volumeRequestRef = useRef(0);
+    const agentHandlerRef = useRef(async () => {
+        throw new Error('RadioCLI is still starting.');
+    });
+    const showTransientMessage = useCallback((nextMessage) => {
+        if (transientMessageTimerRef.current) {
+            clearTimeout(transientMessageTimerRef.current);
+        }
+        setMessage(nextMessage);
+        transientMessageTimerRef.current = setTimeout(() => {
+            setMessage(currentMessage => currentMessage === nextMessage ? null : currentMessage);
+            transientMessageTimerRef.current = null;
+        }, TRANSIENT_NOTICE_MS);
+    }, []);
     const theme = library.settings.theme;
-    const displayMode = useMemo(() => resolveDisplayMode(library.settings), [library.settings.transparentBackground, library.settings.asciiMode, library.settings.reduceMotion]);
+    const displayMode = useMemo(() => resolveDisplayMode(library.settings, process.env, { screenReader, isTTY: Boolean(stdout.isTTY), colorDepth: stdout.getColorDepth?.() }), [library.settings.transparentBackground, library.settings.asciiMode, library.settings.reduceMotion, screenReader, stdout]);
     const favoriteKeys = useMemo(() => new Set(library.favorites.map(stationKey)), [library.favorites]);
     const diagnostics = player.diagnostics();
     const filterLabel = formatFilterLabel(filters);
@@ -141,6 +188,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     }), [library, libraryStations, stationContexts]);
     screenRef.current = screen;
     selectedRef.current = selected;
+    settingsPageRef.current = settingsPage;
     loadingStationsRef.current = loadingStations;
     stationContextsRef.current = activeStationContexts;
     exploreCursorRef.current = exploreCursor;
@@ -171,7 +219,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         'alarm-ringing': 0,
         'airplay-settings': 0,
         'airplay-code': 1,
-        settings: settingsItems.length,
+        settings: settingsItemsForPage(settingsPage).length,
         help: helpItemCount
     });
     itemCountsRef.current = {
@@ -191,7 +239,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         '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]);
@@ -207,12 +255,31 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         Boolean(isAirPlayBackendAvailable(availableBackends) && selectedAirPlayDevice?.requiresPassword && !selectedAirPlayDevice.local);
     const layout = computeTerminalLayout(columns, rows, footerRows);
     const frameWidth = layout.frameWidth;
-    const mouseReportingActive = !commandMode &&
+    const mouseReportingActive = !displayMode.screenReader &&
+        process.env.TERM?.toLowerCase() !== 'dumb' &&
+        !commandMode &&
         !capturingTransportAction &&
         !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]);
+    useEffect(() => {
+        if (!stdin.isTTY)
+            return;
+        try {
+            const unregister = registerTuiPresence();
+            return () => {
+                try {
+                    unregister();
+                }
+                catch {
+                    console.error('RadioCLI could not remove its alarm-control presence marker. Stale markers are checked on the next launch.');
+                }
+            };
+        }
+        catch {
+            setPresenceWarning('Alarm controls cannot register this terminal in the runtime directory. Browsing and playback remain available.');
+        }
+    }, [stdin]);
     const playingStationRef = useRef(null);
     playingStationRef.current = playingStation;
     const activeListeningStationRef = useRef(null);
@@ -224,24 +291,24 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             const key = stationKey(station);
             if (activeListeningStationRef.current !== key) {
                 activeListeningStationRef.current = key;
-                setLibrary(store.startListeningSession(station));
+                persistLibrary(() => store.startListeningSession(station));
             }
             return;
         }
         if (activeListeningStationRef.current) {
             activeListeningStationRef.current = null;
-            setLibrary(store.finishActiveListeningSession());
+            persistLibrary(() => store.finishActiveListeningSession());
         }
-    }, [playback.ready, playback.state, playingStation, store]);
+    }, [persistLibrary, playback.ready, playback.state, playingStation, store]);
     useEffect(() => {
         if (playback.state !== 'playing' || !playback.ready || !playingStation) {
             return;
         }
         const timer = setInterval(() => {
-            setLibrary(store.checkpointActiveListeningSession());
+            persistLibrary(() => store.checkpointActiveListeningSession());
         }, LISTENING_HEARTBEAT_MS);
         return () => clearInterval(timer);
-    }, [playback.ready, playback.state, playingStation, store]);
+    }, [persistLibrary, playback.ready, playback.state, playingStation, store]);
     useEffect(() => player.onMetadata(metadata => {
         setNowPlaying(metadata);
         const station = playingStationRef.current;
@@ -250,9 +317,9 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             if (lastRecordedTrackRef.current === trackKey)
                 return;
             lastRecordedTrackRef.current = trackKey;
-            setLibrary(store.recordTrack(station, metadata.title));
+            persistLibrary(() => store.recordTrack(station, metadata.title));
         }
-    }), [player, store]);
+    }), [persistLibrary, player, store]);
     useEffect(() => {
         if (!stdout.isTTY || !mouseReportingActive) {
             return;
@@ -270,7 +337,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     }, [renderedStationContextKey, screen, selected]);
     useEffect(() => {
         if (footerPlayback.state !== 'loading' ||
-            library.settings.reduceMotion ||
+            displayMode.reduceMotion ||
             process.env.RADIOCLI_DISABLE_ANIMATION === '1' ||
             process.env.RADIO_ATLAS_DISABLE_ANIMATION === '1') {
             setSpinnerFrame(0);
@@ -278,7 +345,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         }
         const timer = setInterval(() => setSpinnerFrame(value => (value + 1) % 1000), LOADING_SPINNER_MS);
         return () => clearInterval(timer);
-    }, [footerPlayback.state, library.settings.reduceMotion]);
+    }, [footerPlayback.state, displayMode.reduceMotion]);
     useEffect(() => {
         if ((screen === 'countries' || screen === 'map') &&
             countries.length === 0 &&
@@ -317,27 +384,30 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         const delayMs = sleepUntil - Date.now();
         if (delayMs <= 0) {
             tuneRequestRef.current += 1;
-            setLibrary(store.finishActiveListeningSession());
-            void player.stop();
+            persistLibrary(() => store.finishActiveListeningSession());
+            void player.stop().catch(reportActionError);
             setSleepUntil(null);
             return;
         }
         const timer = setTimeout(() => {
             tuneRequestRef.current += 1;
-            setLibrary(store.finishActiveListeningSession());
-            void player.stop();
+            persistLibrary(() => store.finishActiveListeningSession());
+            void player.stop().catch(reportActionError);
             setSleepUntil(null);
         }, delayMs);
         return () => clearTimeout(timer);
-    }, [player, sleepUntil, store]);
+    }, [persistLibrary, player, reportActionError, sleepUntil, store]);
     useEffect(() => {
         const backends = player.refreshDetectedBackends();
         setAvailableBackends(backends);
-        void player.refreshAirPlayDevices().then(setAvailableAirPlayDevices).catch(() => setAvailableAirPlayDevices([]));
+        const network = networkPolicy();
+        if (airPlaySupported && !network.offline && !network.lowBandwidth) {
+            void player.refreshAirPlayDevices().then(setAvailableAirPlayDevices).catch(() => setAvailableAirPlayDevices([]));
+        }
         if (backends.length === 0) {
             setMessage(`No playback backend found. ${playbackBackendInstallHint()}`);
         }
-    }, [player]);
+    }, [airPlaySupported, player]);
     const refreshProviderHealth = useCallback(() => {
         providers.health(settingsRef.current).then(setProviderHealth).catch(() => setProviderHealth({}));
     }, [providers]);
@@ -345,14 +415,16 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         refreshProviderHealth();
     }, [refreshProviderHealth]);
     const refreshUpdateCheck = useCallback(async () => {
-        const updateCheck = await checkForUpdate({ currentVersion: installedVersion });
-        setLibrary(store.updateCheckState(updateCheck));
+        const updateCheck = await updateChecker({ currentVersion: installedVersion });
+        persistLibrary(() => store.updateCheckState(updateCheck));
         return updateCheck;
-    }, [installedVersion, store]);
+    }, [installedVersion, persistLibrary, 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) {
@@ -362,11 +434,14 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
                 announcedUpdateRef.current = true;
                 setMessage(`Update available: v${updateCheck.latestVersion} · run :update`);
             }
+        }).catch(error => {
+            if (!cancelled)
+                reportActionError(error);
         });
         return () => {
             cancelled = true;
         };
-    }, [library.updateCheck, refreshUpdateCheck]);
+    }, [library.settings.automaticUpdateChecks, refreshUpdateCheck, reportActionError]);
     const setStationContextFor = useCallback((key, context) => {
         setStationContexts(current => ({ ...current, [key]: context }));
     }, []);
@@ -376,6 +451,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         const nextLibrary = store.updateSettings(settings);
         settingsRef.current = nextLibrary.settings;
         setLibrary(nextLibrary);
+        setPersistenceWarning(null);
         return nextLibrary;
     }, [store]);
     useEffect(() => {
@@ -387,9 +463,14 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             setMessage(`${selectedAirPlayDevice.name} is this Mac. Install mpv to use local playback instead of AirPlay.`);
             return;
         }
-        updateSettings({ preferredBackend });
-        setMessage(`${selectedAirPlayDevice.name} is this Mac. Audio output: ${audioOutputLabel(preferredBackend)}.`);
-    }, [availableBackends, selectedAirPlayDevice, updateSettings]);
+        try {
+            updateSettings({ preferredBackend });
+            setMessage(`${selectedAirPlayDevice.name} is this Mac. Audio output: ${audioOutputLabel(preferredBackend)}.`);
+        }
+        catch (error) {
+            reportActionError(error);
+        }
+    }, [availableBackends, reportActionError, selectedAirPlayDevice, updateSettings]);
     const updateMediaKeys = useCallback((mediaKeys) => {
         updateSettings({ mediaKeys: normalizeMediaKeyBindings(mediaKeys) });
     }, [updateSettings]);
@@ -414,6 +495,15 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         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;
@@ -423,10 +513,30 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             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(() => {
+        if (!airPlaySupported) {
+            showTransientMessage(airPlayMacOSOnlyMessage);
+            return;
+        }
         setAirPlayCode('');
         go('airplay-code', { resetSelection: true, clearMessage: false });
-    }, [go]);
+    }, [airPlaySupported, go, showTransientMessage]);
     useEffect(() => {
         if (isAirPlayCodePromptActive(playback) && screenRef.current !== 'airplay-code') {
             openAirPlayCode();
@@ -434,13 +544,13 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     }, [openAirPlayCode, playback.backend, playback.message]);
     const shutdown = useCallback(() => {
         tuneRequestRef.current += 1;
-        store.finishActiveListeningSession();
-        player.stop().finally(exit);
-    }, [exit, player, store]);
+        persistLibrary(() => store.finishActiveListeningSession());
+        void player.stop().catch(reportActionError).finally(exit);
+    }, [exit, persistLibrary, player, reportActionError, store]);
     useEffect(() => {
         const finishForSignal = () => {
-            store.finishActiveListeningSession();
-            void player.stop().finally(() => process.exit(0));
+            persistLibrary(() => store.finishActiveListeningSession());
+            void player.stop().catch(reportActionError).finally(() => process.exit(0));
         };
         process.once('SIGTERM', finishForSignal);
         process.once('SIGHUP', finishForSignal);
@@ -448,7 +558,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             process.off('SIGTERM', finishForSignal);
             process.off('SIGHUP', finishForSignal);
         };
-    }, [player, store]);
+    }, [persistLibrary, player, reportActionError, store]);
     const showStationContext = useCallback((context, next = 'stations', options = {}) => {
         setStationContextFor(stationContextKeyForScreen(next) ?? 'stations', context);
         go(next, { resetSelection: options.resetSelection ?? true, clearMessage: options.clearMessage });
@@ -650,7 +760,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             });
             selectedByScreenRef.current.search = 0;
             lastSubmittedSearchRef.current = query.trim();
-            setLibrary(store.addSearch(query));
+            persistLibrary(() => store.addSearch(query));
             searchHistoryRef.current = { cursor: -1, draft: '' };
             setSelected(0);
             setEditingSearch(true);
@@ -664,7 +774,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             if (requestId === searchRequestRef.current)
                 setLoadingStations(false);
         }
-    }, [filters, providers, searchQuery, setStationContextFor, store]);
+    }, [filters, persistLibrary, providers, searchQuery, setStationContextFor, store]);
     const loadMoreSearchResults = useCallback(async () => {
         const context = stationContextsRef.current.search;
         const query = context.query;
@@ -865,11 +975,12 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             await player.play(station, resolved.url);
             if (requestId !== tuneRequestRef.current)
                 return;
+            playingStationRef.current = station;
             setPlayingStation(station);
             setTuningStation(null);
             playbackQueueRef.current = queue;
-            const nextLibrary = store.addRecent(station);
-            if (screenRef.current === 'library') {
+            const nextLibrary = persistLibrary(() => store.addRecent(station));
+            if (nextLibrary && screenRef.current === 'library') {
                 const nextLibraryStations = applyStationFilters(buildLibraryStations(nextLibrary), filters);
                 const nextLibraryIndex = nextLibraryStations.findIndex(item => stationMatches(item, station));
                 if (nextLibraryIndex >= 0) {
@@ -877,7 +988,6 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
                     setSelected(nextLibraryIndex);
                 }
             }
-            setLibrary(nextLibrary);
             if (options.openNowPlaying) {
                 go('now-playing');
             }
@@ -903,7 +1013,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             setTuningStation(null);
             setMessage(message);
         }
-    }, [filters, go, player, providers, queueFromCurrentList, rememberQueueSelection, stationMatches, store]);
+    }, [filters, go, persistLibrary, player, providers, queueFromCurrentList, rememberQueueSelection, stationMatches, store]);
     // Resume the most recent station on launch when opted in, like a radio
     // powering back on to its last frequency. Runs once and never auto-navigates.
     const didResumeRef = useRef(false);
@@ -929,7 +1039,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         setTuningStation(null);
         setMessage('Auto-skip canceled. Choose a station and press Enter.');
     }, []);
-    const showTransientFooterMessage = useCallback((nextMessage, durationMs = VISUALIZER_MESSAGE_MS) => {
+    const showTransientFooterMessage = useCallback((nextMessage, durationMs = TRANSIENT_NOTICE_MS) => {
         if (transientFooterMessageTimerRef.current) {
             clearTimeout(transientFooterMessageTimerRef.current);
         }
@@ -955,31 +1065,37 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         }
         const wasFavorite = store.isFavorite(station);
         setLibrary(store.toggleFavorite(station));
+        setPersistenceWarning(null);
         const favoriteMessage = `${wasFavorite ? 'Removed from' : 'Added to'} favorites: ${station.name}`;
-        if (screenRef.current === 'library') {
+        if (screenRef.current === 'library' || screenRef.current === 'search') {
             showTransientFooterMessage(favoriteMessage);
         }
         else {
-            setMessage(favoriteMessage);
+            showTransientMessage(favoriteMessage);
         }
         if (!wasFavorite && settingsRef.current.shareDirectoryVotes) {
             // Best-effort upvote back to the directory; never blocks favoriting.
-            void providers.vote(station);
+            void providers.vote(station).catch(reportActionError);
         }
-    }, [providers, showTransientFooterMessage, store]);
+    }, [providers, reportActionError, showTransientFooterMessage, showTransientMessage, store]);
     const showControlResult = useCallback((result) => {
         if (!result.ok && result.message) {
             setMessage(result.message);
         }
     }, []);
-    const openStationHomepage = useCallback((station) => {
+    const openStationHomepage = useCallback(async (station) => {
         if (!station?.homepage) {
             setMessage('This station has no homepage.');
             return;
         }
-        setMessage(openExternal(station.homepage)
+        const url = safeExternalHttpUrl(station.homepage);
+        if (!url) {
+            setMessage('This station has no valid HTTP(S) homepage.');
+            return;
+        }
+        setMessage(await openExternal(url)
             ? `Opening homepage: ${station.name}`
-            : 'That station homepage is not a valid HTTP(S) URL.');
+            : `Could not open a browser in this session. Homepage: ${sanitizeTerminalText(url) ?? ''}`);
     }, []);
     const copyStationUrl = useCallback(async (station) => {
         if (!station) {
@@ -990,12 +1106,13 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         if (!url) {
             url = await providers.resolve(station).then(resolved => resolved.url).catch(() => undefined);
         }
-        if (!url) {
-            setMessage(`No stream URL available for ${station.name}.`);
+        const safeUrl = url ? safeMediaTarget(url) : null;
+        if (!safeUrl) {
+            setMessage(`No safe stream URL available for ${station.name}.`);
             return;
         }
-        const copied = copyToClipboard(url);
-        setMessage(copied ? `Copied stream URL: ${station.name}` : `Stream URL: ${url}`);
+        const copied = await copyToClipboard(safeUrl);
+        setMessage(copied ? `Copied stream URL: ${station.name}` : `Stream URL: ${sanitizeTerminalText(safeUrl) ?? ''}`);
     }, [providers]);
     const submitAirPlayCode = useCallback((code) => {
         const result = player.submitAirPlayPasscode(code);
@@ -1016,8 +1133,8 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
                 updateSettings({ volume: player.getState().volume });
             }
             showControlResult(result);
-        });
-    }, [player, showControlResult, updateSettings]);
+        }).catch(reportActionError);
+    }, [player, reportActionError, showControlResult, updateSettings]);
     const adjustVolume = useCallback((delta) => {
         const requestId = volumeRequestRef.current + 1;
         volumeRequestRef.current = requestId;
@@ -1026,24 +1143,14 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
                 updateSettings({ volume: player.getState().volume });
             }
             showControlResult(result);
-        });
-    }, [player, showControlResult, updateSettings]);
+        }).catch(reportActionError);
+    }, [player, reportActionError, showControlResult, updateSettings]);
     const toggleMute = useCallback(() => {
-        void player.toggleMute().then(showControlResult);
-    }, [player, showControlResult]);
+        void player.toggleMute().then(showControlResult).catch(reportActionError);
+    }, [player, reportActionError, showControlResult]);
     const togglePause = useCallback(() => {
-        void player.togglePause().then(showControlResult);
-    }, [player, showControlResult]);
-    const showTransientMessage = useCallback((nextMessage) => {
-        if (transientMessageTimerRef.current) {
-            clearTimeout(transientMessageTimerRef.current);
-        }
-        setMessage(nextMessage);
-        transientMessageTimerRef.current = setTimeout(() => {
-            setMessage(currentMessage => currentMessage === nextMessage ? null : currentMessage);
-            transientMessageTimerRef.current = null;
-        }, VISUALIZER_MESSAGE_MS);
-    }, []);
+        void player.togglePause().then(showControlResult).catch(reportActionError);
+    }, [player, reportActionError, showControlResult]);
     const cycleDisplayColor = useCallback(() => {
         const theme = nextTheme(settingsRef.current.theme);
         updateSettings({ theme });
@@ -1082,6 +1189,15 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         setMessage(`Radio Browser favorite votes ${shareDirectoryVotes ? 'enabled' : 'disabled'}.`);
     }, [updateSettings]);
     const refreshAirPlayTargets = useCallback(async (announce = true) => {
+        if (!airPlaySupported) {
+            if (announce)
+                showTransientMessage(airPlayMacOSOnlyMessage);
+            return [];
+        }
+        if (networkPolicy().offline) {
+            setMessage('AirPlay discovery is disabled by RADIOCLI_OFFLINE=1.');
+            return [];
+        }
         try {
             const devices = await player.refreshAirPlayDevices();
             setAvailableAirPlayDevices(devices);
@@ -1104,13 +1220,17 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             }
             return [];
         }
-    }, [player]);
+    }, [airPlaySupported, player, showTransientMessage]);
     const openAirPlaySettings = useCallback(() => {
+        if (!airPlaySupported) {
+            showTransientMessage(airPlayMacOSOnlyMessage);
+            return;
+        }
         const preferredIndex = availableAirPlayDevices.findIndex(device => device.id === settingsRef.current.preferredAirPlayDevice);
         selectedByScreenRef.current['airplay-settings'] = Math.max(0, preferredIndex);
         go('airplay-settings', { resetSelection: false });
         void refreshAirPlayTargets(false);
-    }, [availableAirPlayDevices, go, refreshAirPlayTargets]);
+    }, [airPlaySupported, availableAirPlayDevices, go, refreshAirPlayTargets, showTransientMessage]);
     const selectAirPlayDeviceAt = useCallback((index) => {
         const device = availableAirPlayDevices[index];
         if (!device) {
@@ -1184,6 +1304,59 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         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);
@@ -1261,7 +1434,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             }
         }
         const command = updateCommandForInstall();
-        const copied = copyToClipboard(command.command);
+        const copied = await copyToClipboard(command.command);
         const latestVersion = store.snapshot().updateCheck?.latestVersion ?? updateCheck?.latestVersion;
         const prefix = latestVersion ? `Latest v${latestVersion}. ` : '';
         const method = command.method === 'homebrew' ? 'Homebrew' : command.method === 'npm' ? 'npm' : 'your install method';
@@ -1273,7 +1446,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             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) {
@@ -1293,12 +1466,25 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         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,
@@ -1306,6 +1492,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         loadCountry,
         openAirPlaySettings,
         openLibrary,
+        persistLibrary,
         player,
         playingStation,
         providers,
@@ -1350,6 +1537,167 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             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 (['airplay-list', 'airplay-select', 'airplay-passcode'].includes(command.type) && !airPlaySupported) {
+            return respond(airPlayMacOSOnlyMessage, false, command.type === 'airplay-list' ? [] : undefined);
+        }
+        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;
+            persistLibrary(() => 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;
+            persistLibrary(() => 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') {
+            if (networkPolicy().offline)
+                return respond('AirPlay discovery is disabled by RADIOCLI_OFFLINE=1.', false, []);
+            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') {
+            if (networkPolicy().offline)
+                return respond('AirPlay discovery is disabled by RADIOCLI_OFFLINE=1.', false);
+            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,
@@ -1378,6 +1726,8 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         openAdjacentTab,
         openAirPlayCode,
         openAirPlaySettings,
+        openSettingsPage,
+        closeSettingsPage,
         openScreen,
         handleAlarmInput: alarmTui.handleInput,
         openAlarmForStation: alarmTui.openForStation,
@@ -1394,9 +1744,12 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             void refreshAirPlayTargets();
         },
         resetLearnedTransportKeys,
+        repairMcpIntegrations,
+        setAgentIntegrationEnabled,
         runSearch,
         saveLearnedTransportKey,
         screen,
+        settingsPage,
         searchQuery,
         selectedRef,
         selectedStationForInput,
@@ -1420,6 +1773,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         toggleMute,
         togglePause,
         toggleSetting,
+        toggleAgentSetting,
         toggleNearbyLocation,
         toggleDirectoryVoting,
         toggleRadioGarden,
@@ -1442,6 +1796,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         spinnerFrame
     });
     const basePageFooter = pageFooterText({
+        airPlaySupported,
         canEnterAirPlayCode,
         capturingTransportAction,
         commandMode,
@@ -1449,7 +1804,8 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         editingCountryFilter,
         editingSearch,
         playbackBackend: playback.backend,
-        screen
+        screen,
+        settingsPage
     });
     const pageFooter = alarmTui.activeAlarms.length > 0 && screen !== 'alarm-ringing'
         ? `ALARM PLAYING · ! controls · ${basePageFooter}`
@@ -1460,7 +1816,8 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         (screen === 'search' && editingSearch) ||
         screen === 'airplay-code');
     const hasActiveMicroPlayback = Boolean(footerStation && (footerPlayback.state === 'playing' || footerPlayback.state === 'paused'));
-    const microFooter = footerMessage ?? message ?? (pageFooterOwnsCompactRow
+    const statusMessage = message ?? persistenceWarning ?? presenceWarning;
+    const microFooter = footerMessage ?? statusMessage ?? (pageFooterOwnsCompactRow
         ? pageFooter
         : footerPlayback.state === 'loading' && playbackFooter
             ? playbackFooter
@@ -1468,19 +1825,30 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
                 ? microPlaybackControlsText(playback.backend)
                 : pageFooter);
     const compactGlobalFooter = '←/→ tabs · ? help · q quit';
-    const versionLabel = `v${installedVersion}`;
-    const versionReserve = displayWidth(versionLabel) + 2;
-    const fullStatusRows = fullStatusFooterRows(screen, message, footerMessage, playbackFooter);
+    const versionReserve = versionIndicatorWidth(installedVersion, library.updateCheck) + 2;
+    const fullStatusRows = fullStatusFooterRows(screen, statusMessage, footerMessage, playbackFooter);
     const fullLegendRows = balancedFooterLegendRows(pageFooter, globalFooter, frameWidth, 2, versionReserve);
-    const compactStatus = footerMessage ?? message ?? playbackFooter;
+    const compactStatus = footerMessage ?? statusMessage ?? 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
+    const microLegend = commandMode || capturingTransportAction || footerMessage || statusMessage
         ? 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, 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(Text, { color: textDim, children: versionLabel })] })] })) : (_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(Text, { color: textDim, children: versionLabel })] }) : _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(Text, { color: textDim, children: versionLabel })] }, `legend-${index}`) : _jsx(Text, { color: index === 0 ? textMuted : textDim, children: footerText(row) }, `legend-${index}`))] }) })) })] }) }) }));
+    return (_jsx(ReceiverAnimationProvider, { screen: screen, playback: playback, receiverStyle: library.settings.receiverStyle, reduceMotion: displayMode.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, airPlaySupported: airPlaySupported, 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 || statusMessage ? 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 || statusMessage ? 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 = [];
@@ -1496,12 +1864,12 @@ function buildLibraryStations(library) {
     for (const station of library.favorites) {
         addStation(station);
     }
-    for (const item of library.recent) {
-        addStation(item.station);
-    }
     for (const station of library.imported) {
         addStation(station);
     }
+    for (const item of library.recent) {
+        addStation(item.station);
+    }
     return stations;
 }
 function exploreCursorLocation(cursor) {
@@ -1599,7 +1967,7 @@ function audioOutputSwitchLabel(output, backends) {
     return audioOutputLabel(output);
 }
 function librarySubtitle(library) {
-    return `${library.favorites.length} favorites · ${library.recent.length} recent · ${library.imported.length} imported · favorites first`;
+    return `${library.favorites.length} favorites · ${library.imported.length} imported · ${library.recent.length} recent · new imports before recents`;
 }
 function mouseVisibleRows(screen, layout) {
     if (screen === 'help')