navidrome-mcp 1.0.1

package/dist/tools/radio.js

@@ -0,0 +1,315 @@
+import crypto from 'crypto';
+import { logger } from '../utils/logger.js';
+import { getMessageManager } from '../utils/message-manager.js';
+import { BATCH_VALIDATION_TIMEOUT } from '../constants/timeouts.js';
+import { ErrorFormatter } from '../utils/error-formatter.js';
+function createSubsonicAuth(config) {
+    const salt = crypto.randomBytes(16).toString('hex');
+    const token = crypto.createHash('md5').update(config.navidromePassword + salt).digest('hex');
+    return new URLSearchParams({
+        u: config.navidromeUsername,
+        t: token,
+        s: salt,
+        v: '1.16.1',
+        c: 'NavidromeMCP',
+        f: 'json',
+    });
+}
+/**
+ * List all internet radio stations
+ */
+export async function listRadioStations(config, args) {
+    try {
+        logger.debug('Listing radio stations', args);
+        const authParams = createSubsonicAuth(config);
+        const httpResponse = await fetch(`${config.navidromeUrl}/rest/getInternetRadioStations?${authParams.toString()}`);
+        if (!httpResponse.ok) {
+            throw new Error(ErrorFormatter.subsonicApi(httpResponse));
+        }
+        const data = await httpResponse.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            const errorMsg = data['subsonic-response'].error?.message || 'Unknown error';
+            throw new Error(ErrorFormatter.subsonicResponse(errorMsg));
+        }
+        const radioStations = data['subsonic-response'].internetRadioStations?.internetRadioStation || [];
+        const stations = radioStations.map(station => {
+            const stationDto = {
+                id: station.id,
+                name: station.name,
+                streamUrl: station.streamUrl,
+                createdAt: new Date().toISOString(), // Subsonic API doesn't provide timestamps
+                updatedAt: new Date().toISOString(),
+            };
+            if (station.homePageUrl) {
+                stationDto.homePageUrl = station.homePageUrl;
+            }
+            return stationDto;
+        });
+        // Get one-time message for radio list tip
+        const messageManager = getMessageManager();
+        const tip = messageManager.getMessage('radio.list_tip');
+        const apiResponse = {
+            stations,
+            total: stations.length,
+        };
+        // Add tip if this is the first time showing the list
+        if (tip) {
+            apiResponse.tip = tip;
+        }
+        return apiResponse;
+    }
+    catch (error) {
+        logger.error('Error listing radio stations:', error);
+        throw new Error(ErrorFormatter.toolExecution('listRadioStations', error));
+    }
+}
+/**
+ * Create a new radio station
+ */
+export async function createRadioStation(config, args) {
+    try {
+        const params = args;
+        if (!params.name || !params.streamUrl) {
+            throw new Error('Name and streamUrl are required');
+        }
+        logger.debug('Creating radio station:', params);
+        // If validation is requested, validate the stream first
+        if (params.validateBeforeAdd) {
+            const { validateRadioStream } = await import('./radio-validation.js');
+            const { NavidromeClient } = await import('../client/navidrome-client.js');
+            const client = new NavidromeClient(config);
+            await client.initialize();
+            const validationResult = await validateRadioStream(client, {
+                url: params.streamUrl,
+                timeout: BATCH_VALIDATION_TIMEOUT
+            });
+            if (!validationResult.success) {
+                return {
+                    success: false,
+                    error: `Stream validation failed: ${validationResult.status}. Station was not added.`,
+                };
+            }
+        }
+        const authParams = createSubsonicAuth(config);
+        authParams.set('streamUrl', params.streamUrl);
+        authParams.set('name', params.name);
+        if (params.homePageUrl) {
+            authParams.set('homePageUrl', params.homePageUrl);
+        }
+        const httpResponse = await fetch(`${config.navidromeUrl}/rest/createInternetRadioStation?${authParams.toString()}`, {
+            method: 'POST',
+        });
+        if (!httpResponse.ok) {
+            throw new Error(ErrorFormatter.subsonicApi(httpResponse));
+        }
+        const data = await httpResponse.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            const errorMsg = data['subsonic-response'].error?.message || 'Unknown error';
+            throw new Error(ErrorFormatter.subsonicResponse(errorMsg));
+        }
+        const createdStation = {
+            id: 'created', // Subsonic API doesn't return the created station details
+            name: params.name,
+            streamUrl: params.streamUrl,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        if (params.homePageUrl) {
+            createdStation.homePageUrl = params.homePageUrl;
+        }
+        // Get one-time validation reminder message
+        const messageManager = getMessageManager();
+        const validationReminder = messageManager.getMessage('radio.validation_reminder');
+        const apiResponse = {
+            success: true,
+            station: createdStation,
+        };
+        // Add validation reminder if this is the first time creating a station
+        if (validationReminder) {
+            apiResponse.validation_reminder = validationReminder;
+        }
+        return apiResponse;
+    }
+    catch (error) {
+        logger.error('Error creating radio station:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Delete a radio station by ID
+ */
+export async function deleteRadioStation(config, args) {
+    try {
+        const params = args;
+        if (!params.id) {
+            throw new Error('Radio station ID is required');
+        }
+        logger.debug('Deleting radio station:', params.id);
+        const authParams = createSubsonicAuth(config);
+        authParams.set('id', params.id);
+        const httpResponse = await fetch(`${config.navidromeUrl}/rest/deleteInternetRadioStation?${authParams.toString()}`, {
+            method: 'POST',
+        });
+        if (!httpResponse.ok) {
+            throw new Error(ErrorFormatter.subsonicApi(httpResponse));
+        }
+        const data = await httpResponse.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            const errorMsg = data['subsonic-response'].error?.message || 'Unknown error';
+            throw new Error(ErrorFormatter.subsonicResponse(errorMsg));
+        }
+        return {
+            success: true,
+            id: params.id,
+        };
+    }
+    catch (error) {
+        logger.error('Error deleting radio station:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Get a specific radio station by ID
+ */
+export async function getRadioStation(config, args) {
+    try {
+        const params = args;
+        if (!params.id) {
+            throw new Error('Radio station ID is required');
+        }
+        logger.debug('Getting radio station:', params.id);
+        // Since Subsonic API doesn't have a get single station endpoint,
+        // we'll get all stations and filter by ID
+        const allStations = await listRadioStations(config, {});
+        const station = allStations.stations.find(s => s.id === params.id);
+        if (!station) {
+            throw new Error(`Radio station with ID ${params.id} not found`);
+        }
+        return station;
+    }
+    catch (error) {
+        logger.error('Error getting radio station:', error);
+        throw new Error(ErrorFormatter.toolExecution('getRadioStation', error));
+    }
+}
+/**
+ * Play a radio station (sets it in the queue)
+ */
+export async function playRadioStation(config, args) {
+    try {
+        const params = args;
+        if (!params.id) {
+            throw new Error('Radio station ID is required');
+        }
+        logger.debug('Playing radio station:', params.id);
+        // First get the station details
+        const station = await getRadioStation(config, params);
+        // Note: The actual playback implementation would require additional Subsonic API calls
+        // to set up playback. For now, we'll return success with the station info.
+        // In a full implementation, this might involve:
+        // 1. Calling setQueue to set up radio playback
+        // 2. Using stream endpoint to start playing
+        return {
+            success: true,
+            message: `Radio station "${station.name}" is ready to play. Stream URL: ${station.streamUrl}`,
+            station,
+        };
+    }
+    catch (error) {
+        logger.error('Error playing radio station:', error);
+        return {
+            success: false,
+            message: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Batch create multiple radio stations
+ */
+export async function batchCreateRadioStations(config, args) {
+    const params = args;
+    if (!params.stations || !Array.isArray(params.stations)) {
+        throw new Error('Stations array is required');
+    }
+    if (params.stations.length === 0) {
+        throw new Error('At least one station must be provided');
+    }
+    logger.debug(`Batch creating ${params.stations.length} radio stations`);
+    const results = [];
+    let successCount = 0;
+    let failedCount = 0;
+    let validationFailedCount = 0;
+    for (const station of params.stations) {
+        try {
+            const result = await createRadioStation(config, {
+                ...station,
+                validateBeforeAdd: params.validateBeforeAdd
+            });
+            results.push(result);
+            if (result.success) {
+                successCount++;
+            }
+            else {
+                failedCount++;
+                if (result.error?.includes('validation failed')) {
+                    validationFailedCount++;
+                }
+            }
+        }
+        catch (error) {
+            results.push({
+                success: false,
+                error: `Failed to add ${station.name}: ${error instanceof Error ? error.message : 'Unknown error'}`
+            });
+            failedCount++;
+        }
+    }
+    let summary = `Added ${successCount} of ${params.stations.length} stations.`;
+    if (failedCount > 0) {
+        summary += ` ${failedCount} failed`;
+        if (validationFailedCount > 0) {
+            summary += ` (${validationFailedCount} due to validation)`;
+        }
+        summary += '.';
+    }
+    return {
+        results,
+        summary
+    };
+}
+/**
+ * Get current radio playback information
+ */
+export async function getCurrentRadioInfo(_config, _args) {
+    try {
+        logger.debug('Getting current radio info');
+        // Note: This implementation depends on Navidrome's current playback status API
+        // The Subsonic API has getNowPlaying but it's for regular tracks, not radio streams
+        // This is a placeholder implementation that would need to be adjusted based on
+        // the actual Navidrome radio status endpoints
+        // For now, we'll return a basic response indicating no radio is currently playing
+        // In a real implementation, this would query the current playback status
+        return {
+            playing: false,
+            metadata: {
+                description: 'Radio playback status not available - use getNowPlaying for regular track status',
+            },
+        };
+    }
+    catch (error) {
+        logger.error('Error getting current radio info:', error);
+        return {
+            playing: false,
+            metadata: {
+                description: `Error getting radio info: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=radio.js.map

package/dist/tools/radio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../src/tools/radio.ts"],"names":[],"mappings":"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"}

package/dist/tools/search.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Navidrome MCP Server - Search Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { Config } from '../config.js';
+import type { SongDTO, AlbumDTO, ArtistDTO } from '../types/index.js';
+/**
+ * Search across all content types (artists, albums, songs)
+ */
+export declare function searchAll(config: Config, args: unknown): Promise<{
+    artists: ArtistDTO[];
+    albums: AlbumDTO[];
+    songs: SongDTO[];
+    query: string;
+    totalResults: number;
+}>;
+/**
+ * Search for songs only
+ */
+export declare function searchSongs(config: Config, args: unknown): Promise<{
+    songs: SongDTO[];
+    query: string;
+    total: number;
+}>;
+/**
+ * Search for albums only
+ */
+export declare function searchAlbums(config: Config, args: unknown): Promise<{
+    albums: AlbumDTO[];
+    query: string;
+    total: number;
+}>;
+/**
+ * Search for artists only
+ */
+export declare function searchArtists(config: Config, args: unknown): Promise<{
+    artists: ArtistDTO[];
+    query: string;
+    total: number;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAuCtE;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACtE,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAsCD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxE,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAmCD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACzE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAmCD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1E,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAmCD"}

package/dist/tools/search.js

@@ -0,0 +1,165 @@
+/**
+ * Navidrome MCP Server - Search Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { transformSongsToDTO, transformAlbumsToDTO, transformArtistsToDTO } from '../transformers/song-transformer.js';
+import crypto from 'crypto';
+import { ErrorFormatter } from '../utils/error-formatter.js';
+import { SearchAllSchema, SearchSongsSchema, SearchAlbumsSchema, SearchArtistsSchema, } from '../schemas/index.js';
+/**
+ * Create Subsonic API authentication parameters
+ */
+function createSubsonicAuth(config) {
+    const salt = crypto.randomBytes(16).toString('hex');
+    const token = crypto.createHash('md5').update(config.navidromePassword + salt).digest('hex');
+    return new URLSearchParams({
+        u: config.navidromeUsername,
+        t: token,
+        s: salt,
+        v: '1.16.1',
+        c: 'NavidromeMCP',
+        f: 'json',
+    });
+}
+/**
+ * Search across all content types (artists, albums, songs)
+ */
+export async function searchAll(config, args) {
+    const params = SearchAllSchema.parse(args);
+    try {
+        const searchParams = createSubsonicAuth(config);
+        searchParams.set('query', params.query);
+        searchParams.set('artistCount', params.artistCount.toString());
+        searchParams.set('albumCount', params.albumCount.toString());
+        searchParams.set('songCount', params.songCount.toString());
+        const response = await fetch(`${config.navidromeUrl}/rest/search3?${searchParams.toString()}`);
+        if (!response.ok) {
+            throw new Error(ErrorFormatter.apiRequest('search', response));
+        }
+        const data = await response.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            throw new Error(ErrorFormatter.apiResponse('search'));
+        }
+        const searchResult = data['subsonic-response'].searchResult3 || {};
+        const artists = transformArtistsToDTO(searchResult.artist || []);
+        const albums = transformAlbumsToDTO(searchResult.album || []);
+        const songs = transformSongsToDTO(searchResult.song || []);
+        return {
+            artists,
+            albums,
+            songs,
+            query: params.query,
+            totalResults: artists.length + albums.length + songs.length,
+        };
+    }
+    catch (error) {
+        throw new Error(ErrorFormatter.operationFailed('search', error));
+    }
+}
+/**
+ * Search for songs only
+ */
+export async function searchSongs(config, args) {
+    const params = SearchSongsSchema.parse(args);
+    try {
+        const searchParams = createSubsonicAuth(config);
+        searchParams.set('query', params.query);
+        searchParams.set('artistCount', '0');
+        searchParams.set('albumCount', '0');
+        searchParams.set('songCount', params.limit.toString());
+        const response = await fetch(`${config.navidromeUrl}/rest/search3?${searchParams.toString()}`);
+        if (!response.ok) {
+            throw new Error(ErrorFormatter.apiRequest('search', response));
+        }
+        const data = await response.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            throw new Error(ErrorFormatter.apiResponse('search'));
+        }
+        const searchResult = data['subsonic-response'].searchResult3 || {};
+        const songs = transformSongsToDTO(searchResult.song || []);
+        return {
+            songs,
+            query: params.query,
+            total: songs.length,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to search songs: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Search for albums only
+ */
+export async function searchAlbums(config, args) {
+    const params = SearchAlbumsSchema.parse(args);
+    try {
+        const searchParams = createSubsonicAuth(config);
+        searchParams.set('query', params.query);
+        searchParams.set('artistCount', '0');
+        searchParams.set('albumCount', params.limit.toString());
+        searchParams.set('songCount', '0');
+        const response = await fetch(`${config.navidromeUrl}/rest/search3?${searchParams.toString()}`);
+        if (!response.ok) {
+            throw new Error(ErrorFormatter.apiRequest('search', response));
+        }
+        const data = await response.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            throw new Error(ErrorFormatter.apiResponse('search'));
+        }
+        const searchResult = data['subsonic-response'].searchResult3 || {};
+        const albums = transformAlbumsToDTO(searchResult.album || []);
+        return {
+            albums,
+            query: params.query,
+            total: albums.length,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to search albums: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Search for artists only
+ */
+export async function searchArtists(config, args) {
+    const params = SearchArtistsSchema.parse(args);
+    try {
+        const searchParams = createSubsonicAuth(config);
+        searchParams.set('query', params.query);
+        searchParams.set('artistCount', params.limit.toString());
+        searchParams.set('albumCount', '0');
+        searchParams.set('songCount', '0');
+        const response = await fetch(`${config.navidromeUrl}/rest/search3?${searchParams.toString()}`);
+        if (!response.ok) {
+            throw new Error(ErrorFormatter.apiRequest('search', response));
+        }
+        const data = await response.json();
+        if (data['subsonic-response'].status !== 'ok') {
+            throw new Error(ErrorFormatter.apiResponse('search'));
+        }
+        const searchResult = data['subsonic-response'].searchResult3 || {};
+        const artists = transformArtistsToDTO(searchResult.artist || []);
+        return {
+            artists,
+            query: params.query,
+            total: artists.length,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to search artists: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}

package/dist/tools/tags.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Navidrome MCP Server - Tag Management Tools
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { NavidromeClient } from '../client/navidrome-client.js';
+import type { TagDTO, ListTagsResponse, TagDistributionResponse } from '../types/index.js';
+export type ListTagsResult = ListTagsResponse;
+export interface GetTagResult {
+    tag: TagDTO;
+}
+export interface SearchByTagsResult {
+    tagName: string;
+    tagValue: string | undefined;
+    matches: TagDTO[];
+    total: number;
+}
+export type GetTagDistributionResult = TagDistributionResponse;
+export interface ListUniqueTagsResult {
+    tagNames: Array<{
+        name: string;
+        totalValues: number;
+        totalSongs: number;
+        totalAlbums: number;
+        topValues: TagDTO[];
+    }>;
+    total: number;
+}
+/**
+ * List all tags with optional filtering and pagination
+ * Note: API filtering is broken, so we use client-side filtering
+ */
+export declare function listTags(client: NavidromeClient, args: unknown): Promise<ListTagsResult>;
+/**
+ * Get a specific tag by ID
+ */
+export declare function getTag(client: NavidromeClient, args: unknown): Promise<GetTagResult>;
+/**
+ * Search for tags by tag name and optionally tag value
+ * Note: API filtering is broken, so we use client-side filtering
+ */
+export declare function searchByTags(client: NavidromeClient, args: unknown): Promise<SearchByTagsResult>;
+/**
+ * Get distribution analysis of tags, optionally filtered by tag names
+ */
+export declare function getTagDistribution(client: NavidromeClient, args: unknown): Promise<GetTagDistributionResult>;
+/**
+ * List all unique tag names with statistics
+ */
+export declare function listUniqueTags(client: NavidromeClient, args: unknown): Promise<ListUniqueTagsResult>;
+//# sourceMappingURL=tags.d.ts.map

package/dist/tools/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EACV,MAAM,EACN,gBAAgB,EAChB,uBAAuB,EAExB,MAAM,mBAAmB,CAAC;AAS3B,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAgCD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CA8D9F;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAa1F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiCtG;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAgElH;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2D1G"}