@ciphore/radiocli 0.2.2 → 0.2.3

package/dist/setup.js

@@ -1,8 +1,11 @@
 import { spawn } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import { createInterface } from 'node:readline/promises';
 import { clearCommandCache, commandExists } from './player/command.js';
 import { detectPlaybackBackends, playbackBackendStatusLines } from './player/backend-install.js';
+import { configureMcpIntegrations } from './agent/mcp-install.js';
+import { JsonLibraryStore } from './storage/store.js';
+import { defaultAgentControlSettings } from './types.js';
 const components = ['mpv', 'ffmpeg', 'vlc'];
 const packageManagers = ['brew', 'winget', 'scoop', 'choco', 'apt', 'dnf', 'pacman', 'apk', 'zypper'];
 export async function runSetup(options = {}) {
@@ -21,23 +24,37 @@ export async function runSetup(options = {}) {
     if (!parsed.yes && !parsed.only && isInteractive(input, output)) {
         selected = await promptForComponents({ platform, installed, input, output });
     }
+    let mcp = parsed.mcp;
+    if (mcp === null && !parsed.yes && isInteractive(input, output)) {
+        mcp = await promptYesNo(input, output, '  Agent control via MCP (detected coding agents)', true);
+    }
+    let agentUi = parsed.agentUi;
+    if (mcp === true && agentUi === null && !parsed.yes && isInteractive(input, output)) {
+        const note = platform === 'darwin'
+            ? ' (macOS will ask the agent app to control Terminal on first use)'
+            : ' (opens a separate terminal window)';
+        agentUi = await promptYesNo(input, output, `  Open the RadioCLI TUI for agent playback${note}`, true);
+    }
     const plan = createSetupPlan({ platform, osRelease, packageManager, installed, selected });
     printPlan(plan, output);
     const missing = plan.selected.filter(component => !plan.installed[component]);
     if (missing.length === 0) {
         output.write(plan.selected.length === 0 ? '\nNo components selected.\n' : '\nEverything selected is already installed.\n');
+        await finishMcpSetup(mcp, agentUi, parsed.dryRun, output);
         printVerification(output);
         return;
     }
     if (!plan.packageManager) {
         if (parsed.dryRun) {
             output.write('\nDry run complete. Install the missing components manually; no system packages were changed.\n');
+            await finishMcpSetup(mcp, agentUi, true, output);
             return;
         }
         throw new Error('No supported system package manager was found. Install mpv manually, then run radiocli doctor.');
     }
     if (parsed.dryRun) {
         output.write('\nDry run complete. No system packages were changed.\n');
+        await finishMcpSetup(mcp, agentUi, true, output);
         return;
     }
     if (parsed.packageManager && !hasCommand(parsed.packageManager)) {
@@ -64,6 +81,7 @@ export async function runSetup(options = {}) {
     }
     clearCommandCache();
     output.write('\nSetup complete.\n');
+    await finishMcpSetup(mcp, agentUi, false, output);
     printVerification(output);
 }
 export function createSetupPlan({ platform, osRelease = '', packageManager, installed, selected }) {
@@ -115,6 +133,8 @@ export function parseSetupArgs(args) {
     let yes = false;
     let only = null;
     let packageManager = null;
+    let mcp = null;
+    let agentUi = null;
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
         if (arg === '--all')
@@ -123,6 +143,26 @@ export function parseSetupArgs(args) {
             dryRun = true;
         else if (arg === '--yes' || arg === '-y')
             yes = true;
+        else if (arg === '--mcp') {
+            if (mcp === false)
+                throw new Error('Use either --mcp or --no-mcp, not both.');
+            mcp = true;
+        }
+        else if (arg === '--no-mcp') {
+            if (mcp === true)
+                throw new Error('Use either --mcp or --no-mcp, not both.');
+            mcp = false;
+        }
+        else if (arg === '--agent-ui') {
+            if (agentUi === false)
+                throw new Error('Use either --agent-ui or --headless-agent, not both.');
+            agentUi = true;
+        }
+        else if (arg === '--headless-agent') {
+            if (agentUi === true)
+                throw new Error('Use either --agent-ui or --headless-agent, not both.');
+            agentUi = false;
+        }
         else if (arg === '--only')
             only = parseComponents(args[++index]);
         else if (arg.startsWith('--only='))
@@ -136,7 +176,36 @@ export function parseSetupArgs(args) {
     }
     if (all && only)
         throw new Error('Use either --all or --only, not both.');
-    return { all, dryRun, yes, only, packageManager };
+    if (agentUi !== null && mcp !== true)
+        throw new Error('--agent-ui and --headless-agent require --mcp.');
+    return { all, dryRun, yes, only, packageManager, mcp, agentUi };
+}
+async function finishMcpSetup(enabled, agentUi, dryRun, output) {
+    if (enabled === null)
+        return;
+    if (dryRun) {
+        output.write(`\nAgent integration: would be ${enabled ? 'enabled and installed for detected MCP clients' : 'disabled and removed from detected MCP clients'}.\n`);
+        return;
+    }
+    const entry = process.argv[1];
+    if (!entry)
+        throw new Error('Could not locate the RadioCLI executable for MCP setup.');
+    const results = await configureMcpIntegrations(enabled, { nodePath: process.execPath, cliPath: realpathSync(entry) }, output);
+    const failed = results.filter(result => result.status === 'failed');
+    if (failed.length > 0) {
+        throw new Error(`Playback setup finished, but ${failed.length} agent integration${failed.length === 1 ? '' : 's'} failed: ${failed.map(result => result.client).join(', ')}. Run radiocli mcp status for details.`);
+    }
+    if (enabled) {
+        const store = new JsonLibraryStore();
+        const current = store.snapshot().settings.agentControl ?? defaultAgentControlSettings;
+        const openUiOnPlay = agentUi ?? current.openUiOnPlay;
+        if (openUiOnPlay !== current.openUiOnPlay) {
+            store.updateSettings({ agentControl: { ...current, openUiOnPlay } });
+        }
+        output.write(openUiOnPlay
+            ? '\nAgent playback: terminal TUI enabled (default). The host OS may request app-control permission on first use.\n'
+            : '\nAgent playback: headless; no separate terminal window or app-control permission is needed.\n');
+    }
 }
 function parseComponents(value) {
     const values = value?.split(',').map(item => item.trim().toLowerCase()).filter(Boolean) ?? [];

package/dist/storage/store.js

@@ -61,7 +61,25 @@ const settingsSchema = z.object({
     transparentBackground: z.boolean().default(false),
     asciiMode: z.boolean().default(false),
     reduceMotion: z.boolean().default(false),
-    mouseSupport: z.boolean().default(true)
+    mouseSupport: z.boolean().default(true),
+    automaticUpdateChecks: z.boolean().default(true),
+    agentControl: z.object({
+        enabled: z.boolean().default(false),
+        openUiOnPlay: z.boolean().default(true),
+        focusNowPlaying: z.boolean().default(true),
+        completionPreset: z.object({
+            action: z.enum(['play', 'pause', 'resume', 'stop']).default('play'),
+            source: z.enum(['recent', 'favorite', 'popular', 'country']).default('recent'),
+            countryCode: z.string().length(2).optional(),
+            ifPlaying: z.enum(['keep', 'replace']).default('keep'),
+            openUi: z.boolean().optional()
+        }).default({ action: 'play', source: 'recent', ifPlaying: 'keep' })
+    }).default({
+        enabled: false,
+        openUiOnPlay: true,
+        focusNowPlaying: true,
+        completionPreset: { action: 'play', source: 'recent', ifPlaying: 'keep' }
+    })
 });
 const absoluteInstantSchema = z.string().refine(value => /(?:Z|[+-]\d{2}:\d{2})$/.test(value) && Number.isFinite(Date.parse(value)), { message: 'Expected an absolute ISO-8601 instant with a timezone offset.' });
 const alarmMinuteInstantSchema = absoluteInstantSchema.refine(value => new Date(value).getUTCSeconds() === 0 && new Date(value).getUTCMilliseconds() === 0, { message: 'Alarm occurrences use minute precision; seconds must be zero.' });
@@ -194,6 +212,13 @@ const librarySchema = z.object({
         tuneTimeoutSeconds: 12,
         skipBrokenStreams: true,
         mouseSupport: true,
+        automaticUpdateChecks: true,
+        agentControl: {
+            enabled: false,
+            openUiOnPlay: true,
+            focusNowPlaying: true,
+            completionPreset: { action: 'play', source: 'recent', ifPlaying: 'keep' }
+        },
         mediaKeys: defaultMediaKeys
     })
 });
@@ -636,6 +661,13 @@ function defaultState() {
             tuneTimeoutSeconds: 12,
             skipBrokenStreams: true,
             mouseSupport: true,
+            automaticUpdateChecks: true,
+            agentControl: {
+                enabled: false,
+                openUiOnPlay: true,
+                focusNowPlaying: true,
+                completionPreset: { action: 'play', source: 'recent', ifPlaying: 'keep' }
+            },
             mediaKeys: defaultMediaKeys
         }
     };

package/dist/types.js

@@ -2,3 +2,9 @@ import { defaultReceiverStyle, receiverStyleNames } from './ui/visualizers/recei
 export { defaultReceiverStyle, receiverStyleNames };
 const providerIds = ['radio-browser', 'radio-garden', 'playlist'];
 export const themeNames = ['green', 'amber', 'blue', 'ruby', 'ice', 'teal', 'violet', 'copper', 'cyan', 'lime', 'coral', 'rose', 'slate', 'mono'];
+export const defaultAgentControlSettings = {
+    enabled: false,
+    openUiOnPlay: true,
+    focusNowPlaying: true,
+    completionPreset: { action: 'play', source: 'recent', ifPlaying: 'keep' }
+};

package/dist/ui/AdaptiveContent.js

@@ -5,7 +5,7 @@ import { computeListeningStats } from '../activity/stats.js';
 import { playbackBackendLabel } from '../player/backend-install.js';
 import { visibleWindow } from './list-window.js';
 import { displayWidth, padDisplayEnd, stationLocation, stationTags, stationTech, truncate } from './format.js';
-import { homeItems, settingsItems, settingsSectionFor } from './screen-items.js';
+import { homeItems, settingsGroup, settingsGroups, settingsItemsForPage } from './screen-items.js';
 import { screenTitle } from './screen-meta.js';
 import { keyHelpSections, commandHelp } from './help-content.js';
 import { settingLabel, settingValue } from './screens/SettingsScreen.js';
@@ -23,7 +23,7 @@ export function AdaptiveContent(props) {
     return _jsx(AdaptiveContentBody, { ...props });
 }
 function AdaptiveContentBody(props) {
-    const { mode, screen, selected, height, width, theme, playback, playingStation, nowPlaying, stations, countries, airPlayDevices, airPlayCode, searchQuery, editingSearch, countryFilter, loadingCountries, loadingStations, exploreCursor, library, diagnostics, backends, updateCheck, favoriteKeys, stationTitle, } = props;
+    const { mode, screen, settingsPage = 'root', selected, height, width, theme, playback, playingStation, nowPlaying, stations, countries, airPlayDevices, airPlayCode, searchQuery, editingSearch, countryFilter, loadingCountries, loadingStations, exploreCursor, library, diagnostics, backends, updateCheck, appVersion, favoriteKeys, stationTitle, } = props;
     const accent = themeAccent(theme);
     const { ascii } = useDisplay();
     const { bodyRows } = adaptiveFrameMetrics(mode, height);
@@ -41,6 +41,7 @@ function AdaptiveContentBody(props) {
     if (screen === 'search') {
         const rows = adaptiveRows({
             screen,
+            settingsPage,
             stations,
             countries,
             airPlayDevices,
@@ -48,6 +49,7 @@ function AdaptiveContentBody(props) {
             diagnostics,
             backends,
             updateCheck,
+            appVersion,
             favoriteKeys,
             selected,
             width,
@@ -88,6 +90,7 @@ function AdaptiveContentBody(props) {
     }
     const rows = adaptiveRows({
         screen,
+        settingsPage,
         stations,
         countries,
         airPlayDevices,
@@ -95,6 +98,7 @@ function AdaptiveContentBody(props) {
         diagnostics,
         backends,
         updateCheck,
+        appVersion,
         favoriteKeys,
         selected,
         width,
@@ -255,16 +259,20 @@ function adaptiveRows(input) {
         return homeItems.map(item => ({
             key: item.screen,
             label: item.label,
-            detail: mode === 'compact' && width >= 52 ? item.detail : undefined
+            detail: mode === 'compact' && width >= 52 ? item.detail : undefined,
+            separator: '   '
         }));
     }
     if (screen === 'settings') {
-        const labels = settingsItems.map(item => settingLabel(item, updateCheck));
+        const pageItems = settingsItemsForPage(input.settingsPage);
+        const labels = pageItems.map(item => settingLabel(item, updateCheck, input.appVersion));
         const labelWidth = pairedColumnWidth(labels, width, mode);
-        return settingsItems.map((item, index) => ({
+        return pageItems.map((item, index) => ({
             key: item,
-            label: padDisplayEnd(truncate(settingLabel(item, updateCheck), labelWidth), labelWidth),
-            detail: settingValue(item, library.settings, diagnostics, backends, airPlayDevices, updateCheck),
+            label: padDisplayEnd(truncate(settingLabel(item, updateCheck, input.appVersion), labelWidth), labelWidth),
+            detail: input.settingsPage === 'root'
+                ? adaptiveSettingsRootValue(item)
+                : settingValue(item, library.settings, diagnostics, backends, airPlayDevices, updateCheck, input.appVersion),
             separator: '   ',
             index
         }));
@@ -303,6 +311,10 @@ function adaptiveRows(input) {
     }
     return stationAdaptiveRows(stations, favoriteKeys, selected, width, ascii);
 }
+function adaptiveSettingsRootValue(item) {
+    const group = settingsGroups.find(candidate => candidate.label === item);
+    return group ? `${group.items.length} settings ›` : undefined;
+}
 function stationAdaptiveRows(stations, favoriteKeys, selected, width, ascii) {
     return stations.map((station, index) => {
         const favorite = favoriteKeys.has(`${station.provider}:${station.id}`);
@@ -362,7 +374,7 @@ function adaptiveEmptyState(input) {
     return [{ key: 'empty', label: `No stations in ${stationTitle.toLowerCase()}.` }, { key: 'hint', label: 'Try another view or clear filters.' }];
 }
 function adaptiveStatus(props) {
-    const { screen, playback, playingStation, stations, countries, searchQuery, editingSearch, countryFilter, editingCountryFilter, library, filterLabel, selected } = props;
+    const { screen, playback, playingStation, stations, countries, searchQuery, editingSearch, countryFilter, editingCountryFilter, library, filterLabel } = props;
     if (screen === 'home') {
         return `${library.favorites.length} favorites · ${library.recent.length} recent · ${library.imported.length} imported`;
     }
@@ -370,7 +382,10 @@ function adaptiveStatus(props) {
         return `${playbackBackendLabel(playback.backend)} · ${playback.state} · vol ${playback.volume}`;
     }
     if (screen === 'settings') {
-        return `${settingsSectionFor(settingsItems[selected])} · Enter changes the selected setting`;
+        const group = settingsGroup(props.settingsPage ?? 'root');
+        return group
+            ? `${group.label} · Enter changes setting · b categories`
+            : 'Choose a category · Updates are available here';
     }
     if (screen === 'search') {
         const query = searchQuery || (editingSearch ? 'type to search' : 'press / to search');