@ciphore/radiocli 0.2.2 → 0.2.3

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 { 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 { 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';
@@ -22,15 +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 { 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;
@@ -44,9 +49,10 @@ 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 }) {
     const { exit } = useApp();
     const { stdin } = useStdin();
     const { stdout } = useStdout();
@@ -64,6 +70,7 @@ 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 [footerMessage, setFooterMessage] = useState(null);
     const [countries, setCountries] = useState([]);
@@ -89,7 +96,9 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
     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);
@@ -99,6 +108,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,6 +129,9 @@ 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 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, alarmS
     }), [library, libraryStations, stationContexts]);
     screenRef.current = screen;
     selectedRef.current = selected;
+    settingsPageRef.current = settingsPage;
     loadingStationsRef.current = loadingStations;
     stationContextsRef.current = activeStationContexts;
     exploreCursorRef.current = exploreCursor;
@@ -171,7 +186,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 +206,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]);
@@ -345,14 +360,16 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         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) {
@@ -366,7 +383,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         return () => {
             cancelled = true;
         };
-    }, [library.updateCheck, refreshUpdateCheck]);
+    }, [library.settings.automaticUpdateChecks, refreshUpdateCheck]);
     const setStationContextFor = useCallback((key, context) => {
         setStationContexts(current => ({ ...current, [key]: context }));
     }, []);
@@ -414,6 +431,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,6 +449,22 @@ 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(() => {
         setAirPlayCode('');
         go('airplay-code', { resetSelection: true, clearMessage: false });
@@ -865,6 +907,7 @@ 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;
@@ -1184,6 +1227,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);
@@ -1273,7 +1369,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 +1389,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,
@@ -1350,6 +1459,160 @@ 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 (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,
@@ -1378,6 +1641,8 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         openAdjacentTab,
         openAirPlayCode,
         openAirPlaySettings,
+        openSettingsPage,
+        closeSettingsPage,
         openScreen,
         handleAlarmInput: alarmTui.handleInput,
         openAlarmForStation: alarmTui.openForStation,
@@ -1394,9 +1659,12 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
             void refreshAirPlayTargets();
         },
         resetLearnedTransportKeys,
+        repairMcpIntegrations,
+        setAgentIntegrationEnabled,
         runSearch,
         saveLearnedTransportKey,
         screen,
+        settingsPage,
         searchQuery,
         selectedRef,
         selectedStationForInput,
@@ -1420,6 +1688,7 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         toggleMute,
         togglePause,
         toggleSetting,
+        toggleAgentSetting,
         toggleNearbyLocation,
         toggleDirectoryVoting,
         toggleRadioGarden,
@@ -1449,7 +1718,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}`
@@ -1468,8 +1738,7 @@ 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 versionReserve = versionIndicatorWidth(installedVersion, library.updateCheck) + 2;
     const fullStatusRows = fullStatusFooterRows(screen, message, footerMessage, playbackFooter);
     const fullLegendRows = balancedFooterLegendRows(pageFooter, globalFooter, frameWidth, 2, versionReserve);
     const compactStatus = footerMessage ?? message ?? playbackFooter;
@@ -1480,7 +1749,19 @@ export function App({ store: providedStore, providers: providedProviders, alarmS
         ? 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: 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 = [];

package/dist/ui/AppContent.js

@@ -15,7 +15,7 @@ import { AirPlayCodeScreen } from './screens/AirPlayCodeScreen.js';
 import { selectedAirPlayDevice } from './airplay-settings.js';
 import { AdaptiveContent } from './AdaptiveContent.js';
 import { AlarmsScreen, AlarmEditorScreen, AlarmPickerScreen, AlarmRingingScreen } from './screens/AlarmsScreen.js';
-export function AppContent({ airPlayDevices, airPlayCode, appVersion, backends, countryFilter, diagnostics, displayStations, editingCountryFilter, editingSearch, exploreCursor, favoriteKeys, filterLabel, filteredCountries, frameWidth, layout, library, loadingCountries, loadingStations, nowPlaying, playback, playingStation, providerHealth, searchQuery, screen, selected, showDiagnostics, sleepLabel, stationContext, stationFavorite, stationTime, storePath, theme, updateCheck, alarmTui }) {
+export function AppContent({ airPlayDevices, airPlayCode, appVersion, backends, countryFilter, diagnostics, displayStations, editingCountryFilter, editingSearch, exploreCursor, favoriteKeys, filterLabel, filteredCountries, frameWidth, layout, library, loadingCountries, loadingStations, nowPlaying, playback, playingStation, providerHealth, searchQuery, screen, settingsPage, selected, showDiagnostics, sleepLabel, stationContext, stationFavorite, stationTime, storePath, theme, updateCheck, alarmTui }) {
     if (layout.compact) {
         if (screen === 'alarms')
             return _jsx(AlarmsScreen, { alarms: library.alarms, selected: selected, runtime: alarmTui.runtime, verification: alarmTui.verification, deletingId: alarmTui.deletingId, busyAlarmIds: alarmTui.busyAlarmIds, theme: theme, width: frameWidth, height: layout.contentRows, mode: layout.mode });
@@ -25,7 +25,7 @@ export function AppContent({ airPlayDevices, airPlayCode, appVersion, backends,
             return _jsx(AlarmPickerScreen, { choices: alarmTui.pickerChoices, selected: selected, fallback: alarmTui.pickerFallback, theme: theme, width: frameWidth, height: layout.contentRows });
         if (screen === 'alarm-ringing')
             return _jsx(AlarmRingingScreen, { sessions: alarmTui.activeAlarms, alarms: library.alarms, selected: alarmTui.activeSelected, snoozeMinutes: alarmTui.snoozeMinutes, theme: theme, width: frameWidth, height: layout.contentRows });
-        return (_jsx(AdaptiveContent, { mode: layout.mode === 'micro' ? 'micro' : 'compact', screen: screen, selected: selected, height: layout.contentRows, width: frameWidth, theme: theme, playback: playback, playingStation: playingStation, nowPlaying: nowPlaying, stations: displayStations, countries: filteredCountries, airPlayDevices: airPlayDevices, airPlayCode: airPlayCode, searchQuery: searchQuery, editingSearch: editingSearch, countryFilter: countryFilter, editingCountryFilter: editingCountryFilter, loadingCountries: loadingCountries, loadingStations: loadingStations, exploreCursor: exploreCursor, library: library, diagnostics: diagnostics, backends: backends, updateCheck: updateCheck, favoriteKeys: favoriteKeys, stationTitle: stationContext.title, stationError: stationContext.error, filterLabel: filterLabel, sleepLabel: sleepLabel }));
+        return (_jsx(AdaptiveContent, { mode: layout.mode === 'micro' ? 'micro' : 'compact', screen: screen, settingsPage: settingsPage, selected: selected, height: layout.contentRows, width: frameWidth, theme: theme, playback: playback, playingStation: playingStation, nowPlaying: nowPlaying, stations: displayStations, countries: filteredCountries, airPlayDevices: airPlayDevices, airPlayCode: airPlayCode, searchQuery: searchQuery, editingSearch: editingSearch, countryFilter: countryFilter, editingCountryFilter: editingCountryFilter, loadingCountries: loadingCountries, loadingStations: loadingStations, exploreCursor: exploreCursor, library: library, diagnostics: diagnostics, backends: backends, updateCheck: updateCheck, appVersion: appVersion, favoriteKeys: favoriteKeys, stationTitle: stationContext.title, stationError: stationContext.error, filterLabel: filterLabel, sleepLabel: sleepLabel }));
     }
     if (screen === 'alarms')
         return _jsx(AlarmsScreen, { alarms: library.alarms, selected: selected, runtime: alarmTui.runtime, verification: alarmTui.verification, deletingId: alarmTui.deletingId, busyAlarmIds: alarmTui.busyAlarmIds, theme: theme, width: frameWidth, height: layout.contentRows, mode: layout.mode });
@@ -39,7 +39,7 @@ export function AppContent({ airPlayDevices, airPlayCode, appVersion, backends,
         return _jsx(HomeScreen, { selected: selected, theme: theme, library: library });
     }
     if (screen === 'countries') {
-        return (_jsx(CountriesScreen, { countries: filteredCountries, selected: selected, loading: loadingCountries, filter: countryFilter, editingFilter: editingCountryFilter, theme: theme, pageSize: layout.countryRows, width: frameWidth }));
+        return (_jsx(CountriesScreen, { countries: filteredCountries, selected: selected, loading: loadingCountries, filter: countryFilter, editingFilter: editingCountryFilter, theme: theme, pageSize: layout.countryRows, width: frameWidth, reduceMotion: Boolean(library.settings.reduceMotion) }));
     }
     if (screen === 'map') {
         return (_jsx(MapScreen, { countries: filteredCountries, selected: selected, loading: loadingCountries, filter: countryFilter, editingFilter: editingCountryFilter, theme: theme, pageSize: layout.mapCountryRows, mode: layout.mapMode, width: frameWidth }));
@@ -60,7 +60,7 @@ export function AppContent({ airPlayDevices, airPlayCode, appVersion, backends,
         return _jsx(StatsScreen, { library: library, theme: theme, width: frameWidth, height: layout.contentRows });
     }
     if (screen === 'settings') {
-        return (_jsx(SettingsScreen, { selected: selected, settings: library.settings, appVersion: appVersion, updateCheck: updateCheck, storePath: storePath, playback: playback, backends: backends, airPlayDevices: airPlayDevices, providerHealth: providerHealth, theme: theme, diagnostics: diagnostics, width: frameWidth, height: layout.contentRows }));
+        return (_jsx(SettingsScreen, { page: settingsPage, selected: selected, settings: library.settings, appVersion: appVersion, updateCheck: updateCheck, storePath: storePath, playback: playback, backends: backends, airPlayDevices: airPlayDevices, providerHealth: providerHealth, theme: theme, diagnostics: diagnostics, width: frameWidth, height: layout.contentRows }));
     }
     if (screen === 'airplay-settings') {
         return (_jsx(AirPlaySettingsScreen, { selected: selected, settings: library.settings, backends: backends, devices: airPlayDevices, theme: theme, width: frameWidth, height: layout.contentRows }));

package/dist/ui/components/StationList.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
-import { displayWidth, stationLocation, stationTags, stationTech, truncate } from '../format.js';
+import { stationLocation, stationTags, stationTech, truncate } from '../format.js';
 import { textMuted, themeAccent } from '../theme.js';
 import { Menu, Pointer } from './Menu.js';
 import { visibleWindow } from '../list-window.js';
@@ -21,12 +21,10 @@ export function StationList({ stations, selected, theme, favorites, pageSize, wi
                         const compactNameWidth = Math.max(1, width - 2 - (favorite ? 2 : 0));
                         return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: _jsx(AdaptiveMarquee, { text: station.name, width: compactNameWidth, active: active, reduceMotion: reduceMotion }) }), favorite ? _jsx(Text, { color: "yellow", children: " \u2605" }) : null] }));
                     }
-                    const stationName = truncate(station.name, favorite ? Math.max(1, nameWidth - 2) : nameWidth);
+                    const stationNameWidth = favorite ? Math.max(1, nameWidth - 2) : nameWidth;
                     const titleWidth = nameWidth + 2;
-                    const titleUsed = displayWidth(stationName) + (favorite ? 2 : 0);
-                    const titlePadding = ' '.repeat(Math.max(1, titleWidth - titleUsed));
                     const standardMetadata = `${stationLocation(station)} · ${stationTech(station)}`;
                     const selectedMetadata = station.tags.length > 0 ? stationTags(station) : standardMetadata;
-                    return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: stationName }), favorite ? _jsx(Text, { color: "yellow", children: " \u2605" }) : null, _jsx(Text, { children: titlePadding }), _jsx(Text, { color: active ? themeAccent(theme) : textMuted, children: truncate(active ? selectedMetadata : standardMetadata, metaWidth) })] }));
+                    return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsxs(Box, { width: titleWidth, children: [_jsx(Box, { width: stationNameWidth, children: _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: _jsx(AdaptiveMarquee, { text: station.name, width: stationNameWidth, active: active, reduceMotion: reduceMotion }) }) }), favorite ? _jsx(Text, { color: "yellow", children: " \u2605" }) : null] }), _jsx(Text, { color: active ? themeAccent(theme) : textMuted, children: truncate(active ? selectedMetadata : standardMetadata, metaWidth) })] }));
                 } })] }));
 }

package/dist/ui/components/VersionIndicator.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { updateAvailableForVersion } from '../../update-check.js';
+import { displayWidth } from '../format.js';
+import { appBackground, textDim, themeAccent } from '../theme.js';
+export function availableUpdateLabel(currentVersion, updateCheck) {
+    return updateAvailableForVersion(updateCheck, currentVersion) && updateCheck?.latestVersion
+        ? `v${updateCheck.latestVersion} available`
+        : undefined;
+}
+export function versionIndicatorWidth(currentVersion, updateCheck) {
+    const versionWidth = displayWidth(`v${currentVersion}`);
+    const updateLabel = availableUpdateLabel(currentVersion, updateCheck);
+    return updateLabel ? displayWidth(updateLabel) + 3 + versionWidth : versionWidth;
+}
+export function VersionIndicator({ currentVersion, updateCheck, theme }) {
+    const updateLabel = availableUpdateLabel(currentVersion, updateCheck);
+    return (_jsxs(Box, { flexShrink: 0, children: [updateLabel ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: appBackground, backgroundColor: themeAccent(theme), bold: true, children: ` ${updateLabel} ` }), _jsx(Text, { children: " " })] })) : null, _jsx(Text, { color: textDim, children: `v${currentVersion}` })] }));
+}

package/dist/ui/page-footer.js

@@ -13,7 +13,7 @@ export function fullStatusFooterRows(screen, message, footerMessage, playbackSta
         { key: 'playback', text: footerMessage ?? playbackStatus ?? ' ' }
     ];
 }
-export function pageFooterText({ capturingTransportAction, commandMode, commandText, editingCountryFilter, editingSearch, canEnterAirPlayCode, playbackBackend, screen }) {
+export function pageFooterText({ capturingTransportAction, commandMode, commandText, editingCountryFilter, editingSearch, canEnterAirPlayCode, playbackBackend, screen, settingsPage = 'root' }) {
     if (capturingTransportAction) {
         return `Learn ${mediaActionLabel(capturingTransportAction)} key: press key · Esc cancel`;
     }
@@ -58,7 +58,9 @@ export function pageFooterText({ capturingTransportAction, commandMode, commandT
         return 'space/F8 pause · f favorite · m mute · s sleep · d diagnostics · b Overview';
     }
     if (screen === 'settings') {
-        return 'Enter change selected · g Radio Garden · l location · x skip · o output · a AirPlay · r health · b Overview';
+        return settingsPage === 'root'
+            ? '↑/↓ choose · Enter open · o output · a AirPlay · b Overview'
+            : '↑/↓ choose · Enter change · b Settings · shortcuts still work';
     }
     if (screen === 'airplay-settings') {
         return canEnterAirPlayCode