navidrome-mcp 1.0.1

package/dist/tools/lastfm-discovery.js

@@ -0,0 +1,238 @@
+/**
+ * Navidrome MCP Server - Last.fm Music Discovery 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 { z } from 'zod';
+import { logger } from '../utils/logger.js';
+import { DEFAULT_VALUES } from '../constants/defaults.js';
+import { ErrorFormatter } from '../utils/error-formatter.js';
+const LASTFM_API_BASE = 'http://ws.audioscrobbler.com/2.0/';
+async function callLastFmApi(method, params, apiKey) {
+    const url = new URL(LASTFM_API_BASE);
+    url.searchParams.append('method', method);
+    url.searchParams.append('api_key', apiKey);
+    url.searchParams.append('format', 'json');
+    Object.entries(params).forEach(([key, value]) => {
+        url.searchParams.append(key, value);
+    });
+    logger.debug(`Calling Last.fm API: ${method}`, params);
+    const response = await fetch(url.toString());
+    if (!response.ok) {
+        throw new Error(ErrorFormatter.lastfmApi(response));
+    }
+    const data = await response.json();
+    if (data['error']) {
+        throw new Error(ErrorFormatter.lastfmResponse(data['message']));
+    }
+    return data;
+}
+const SimilarArtistsSchema = z.object({
+    artist: z.string().min(1),
+    limit: z.number().min(1).max(100).optional().default(DEFAULT_VALUES.SIMILAR_ARTISTS_LIMIT),
+});
+export async function getSimilarArtists(config, args) {
+    const { artist, limit = 20 } = SimilarArtistsSchema.parse(args);
+    if (!config.lastFmApiKey) {
+        throw new Error(ErrorFormatter.configMissing('Last.fm', 'LASTFM_API_KEY'));
+    }
+    logger.info(`Getting similar artists for: ${artist}`);
+    const data = await callLastFmApi('artist.getSimilar', {
+        artist,
+        limit: limit.toString(),
+        autocorrect: '1',
+    }, config.lastFmApiKey);
+    const similarArtists = data['similarartists']?.artist || [];
+    return {
+        artist,
+        count: similarArtists.length,
+        similarArtists: similarArtists.map((a) => {
+            const artist = a;
+            return {
+                name: String(artist['name'] || ''),
+                match: parseFloat(String(artist['match'] || 0)),
+                url: String(artist['url'] || ''),
+                mbid: artist['mbid'] || null,
+            };
+        }),
+    };
+}
+const SimilarTracksSchema = z.object({
+    artist: z.string().min(1),
+    track: z.string().min(1),
+    limit: z.number().min(1).max(100).optional().default(DEFAULT_VALUES.SIMILAR_TRACKS_LIMIT),
+});
+export async function getSimilarTracks(config, args) {
+    const { artist, track, limit = 20 } = SimilarTracksSchema.parse(args);
+    if (!config.lastFmApiKey) {
+        throw new Error(ErrorFormatter.configMissing('Last.fm', 'LASTFM_API_KEY'));
+    }
+    logger.info(`Getting similar tracks for: ${artist} - ${track}`);
+    const data = await callLastFmApi('track.getSimilar', {
+        artist,
+        track,
+        limit: limit.toString(),
+        autocorrect: '1',
+    }, config.lastFmApiKey);
+    const similarTracks = data['similartracks']?.track || [];
+    return {
+        originalTrack: { artist, track },
+        count: similarTracks.length,
+        similarTracks: similarTracks.map((t) => {
+            const track = t;
+            const trackArtist = track['artist'];
+            return {
+                name: String(track['name'] || ''),
+                artist: String(trackArtist?.['name'] || trackArtist?.['#text'] || 'Unknown'),
+                match: parseFloat(String(track['match'] || 0)),
+                url: String(track['url'] || ''),
+                mbid: track['mbid'] || null,
+            };
+        }),
+    };
+}
+const ArtistInfoSchema = z.object({
+    artist: z.string().min(1),
+    lang: z.string().optional().default('en'),
+});
+export async function getArtistInfo(config, args) {
+    const { artist, lang = 'en' } = ArtistInfoSchema.parse(args);
+    if (!config.lastFmApiKey) {
+        throw new Error(ErrorFormatter.configMissing('Last.fm', 'LASTFM_API_KEY'));
+    }
+    logger.info(`Getting artist info for: ${artist}`);
+    const data = await callLastFmApi('artist.getInfo', {
+        artist,
+        lang,
+        autocorrect: '1',
+    }, config.lastFmApiKey);
+    const artistInfo = data['artist'] || {};
+    const stats = artistInfo['stats'];
+    const bio = artistInfo['bio'];
+    const tags = artistInfo['tags'];
+    const similar = artistInfo['similar'];
+    return {
+        name: String(artistInfo['name'] || ''),
+        mbid: artistInfo['mbid'] || null,
+        url: String(artistInfo['url'] || ''),
+        listeners: parseInt(String(stats?.['listeners'] || '0'), 10),
+        playcount: parseInt(String(stats?.['playcount'] || '0'), 10),
+        biography: bio?.['summary'] ? String(bio['summary']).replace(/<[^>]*>/g, '') : null,
+        tags: (tags?.['tag'] || []).map((t) => ({
+            name: String(t['name'] || ''),
+            url: String(t['url'] || ''),
+        })),
+        similar: (similar?.['artist'] || []).slice(0, 5).map((a) => String(a['name'] || '')),
+    };
+}
+const TopTracksByArtistSchema = z.object({
+    artist: z.string().min(1),
+    limit: z.number().min(1).max(50).optional().default(DEFAULT_VALUES.TOP_TRACKS_BY_ARTIST_LIMIT),
+});
+export async function getTopTracksByArtist(config, args) {
+    const { artist, limit = 10 } = TopTracksByArtistSchema.parse(args);
+    if (!config.lastFmApiKey) {
+        throw new Error(ErrorFormatter.configMissing('Last.fm', 'LASTFM_API_KEY'));
+    }
+    logger.info(`Getting top tracks for artist: ${artist}`);
+    const data = await callLastFmApi('artist.getTopTracks', {
+        artist,
+        limit: limit.toString(),
+        autocorrect: '1',
+    }, config.lastFmApiKey);
+    const topTracks = data['toptracks']?.['track'] || [];
+    return {
+        artist,
+        count: topTracks.length,
+        tracks: topTracks.map((t, index) => ({
+            rank: index + 1,
+            name: String(t['name'] || ''),
+            playcount: parseInt(String(t['playcount'] || '0'), 10),
+            listeners: parseInt(String(t['listeners'] || '0'), 10),
+            url: String(t['url'] || ''),
+            mbid: t['mbid'] || null,
+        })),
+    };
+}
+const GlobalChartsSchema = z.object({
+    type: z.enum(['artists', 'tracks', 'tags']),
+    limit: z.number().min(1).max(100).optional().default(DEFAULT_VALUES.TRENDING_MUSIC_LIMIT),
+    page: z.number().min(1).optional().default(1),
+});
+export async function getTrendingMusic(config, args) {
+    const { type, limit = 20, page = 1 } = GlobalChartsSchema.parse(args);
+    if (!config.lastFmApiKey) {
+        throw new Error(ErrorFormatter.configMissing('Last.fm', 'LASTFM_API_KEY'));
+    }
+    logger.info(`Getting global ${type} chart`);
+    const method = type === 'artists' ? 'chart.getTopArtists' :
+        type === 'tracks' ? 'chart.getTopTracks' :
+            'chart.getTopTags';
+    const data = await callLastFmApi(method, {
+        limit: limit.toString(),
+        page: page.toString(),
+    }, config.lastFmApiKey);
+    if (type === 'artists') {
+        const artists = (data['artists']?.['artist'] || []).map((a, index) => ({
+            rank: (page - 1) * limit + index + 1,
+            name: String(a['name'] || ''),
+            playcount: parseInt(String(a['playcount'] || '0'), 10),
+            listeners: parseInt(String(a['listeners'] || '0'), 10),
+            url: String(a['url'] || ''),
+            mbid: a['mbid'] || null,
+        }));
+        return {
+            type,
+            page,
+            perPage: limit,
+            count: artists.length,
+            items: artists,
+        };
+    }
+    else if (type === 'tracks') {
+        const tracks = (data['tracks']?.['track'] || []).map((t, index) => ({
+            rank: (page - 1) * limit + index + 1,
+            name: String(t['name'] || ''),
+            artist: String((t['artist']?.['name']) || 'Unknown'),
+            playcount: parseInt(String(t['playcount'] || '0'), 10),
+            listeners: parseInt(String(t['listeners'] || '0'), 10),
+            url: String(t['url'] || ''),
+            mbid: t['mbid'] || null,
+        }));
+        return {
+            type,
+            page,
+            perPage: limit,
+            count: tracks.length,
+            items: tracks,
+        };
+    }
+    else {
+        const tags = (data['tags']?.['tag'] || []).map((t, index) => ({
+            rank: (page - 1) * limit + index + 1,
+            name: String(t['name'] || ''),
+            count: parseInt(String(t['count'] || '0'), 10),
+            url: String(t['url'] || ''),
+        }));
+        return {
+            type,
+            page,
+            perPage: limit,
+            count: tags.length,
+            items: tags,
+        };
+    }
+}
+//# sourceMappingURL=lastfm-discovery.js.map

package/dist/tools/lastfm-discovery.js.map

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

package/dist/tools/library.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Navidrome MCP Server - Library 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 { Config } from '../config.js';
+import type { SongDTO } from '../types/index.js';
+import type { ToolCategory } from './handlers/registry.js';
+export type Song = SongDTO;
+export interface ListSongsResult {
+    songs: SongDTO[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+export declare function listSongs(client: NavidromeClient, args: unknown): Promise<ListSongsResult>;
+export declare function createLibraryToolCategory(client: NavidromeClient, config: Config): ToolCategory;
+//# sourceMappingURL=library.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/tools/library.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAa3D,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CA8BhG;AAwMD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CA0B/F"}

package/dist/tools/library.js

@@ -0,0 +1,272 @@
+/**
+ * Navidrome MCP Server - Library 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 } from '../transformers/song-transformer.js';
+import { DEFAULT_VALUES } from '../constants/defaults.js';
+import { listAlbums, listArtists, listGenres, getSong, getAlbum, getArtist, getSongPlaylists, } from './media-library.js';
+import { SongPaginationSchema } from '../schemas/index.js';
+export async function listSongs(client, args) {
+    const params = SongPaginationSchema.parse(args);
+    try {
+        // Build query parameters for Navidrome API
+        const queryParams = new URLSearchParams({
+            _start: params.offset.toString(),
+            _end: (params.offset + params.limit).toString(),
+            _sort: params.sort,
+            _order: params.order,
+        });
+        if (params.starred !== undefined) {
+            queryParams.set('starred', params.starred.toString());
+        }
+        const rawSongs = await client.request(`/song?${queryParams.toString()}`);
+        const songs = transformSongsToDTO(rawSongs);
+        return {
+            songs,
+            total: songs.length, // Note: Navidrome doesn't return total count in this endpoint
+            offset: params.offset,
+            limit: params.limit,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch songs: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Tool definitions for library category
+const tools = [
+    {
+        name: 'list_songs',
+        description: 'List songs from the Navidrome music library with clean, LLM-friendly data (filtering and pagination supported)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of songs to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: DEFAULT_VALUES.SONGS_LIMIT,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of songs to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Field to sort by',
+                    enum: ['title', 'artist', 'album', 'year', 'duration', 'playCount', 'rating'],
+                    default: 'title',
+                },
+                order: {
+                    type: 'string',
+                    description: 'Sort order',
+                    enum: ['ASC', 'DESC'],
+                    default: 'ASC',
+                },
+                starred: {
+                    type: 'boolean',
+                    description: 'Filter for starred songs only',
+                },
+            },
+        },
+    },
+    {
+        name: 'list_albums',
+        description: 'List albums from the Navidrome music library with clean, LLM-friendly data',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of albums to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: DEFAULT_VALUES.ALBUMS_LIMIT,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of albums to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Field to sort by',
+                    default: 'name',
+                },
+                order: {
+                    type: 'string',
+                    description: 'Sort order',
+                    enum: ['ASC', 'DESC'],
+                    default: 'ASC',
+                },
+            },
+        },
+    },
+    {
+        name: 'list_artists',
+        description: 'List artists from the Navidrome music library with clean, LLM-friendly data',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of artists to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of artists to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Field to sort by',
+                    default: 'name',
+                },
+                order: {
+                    type: 'string',
+                    description: 'Sort order',
+                    enum: ['ASC', 'DESC'],
+                    default: 'ASC',
+                },
+            },
+        },
+    },
+    {
+        name: 'list_genres',
+        description: 'List all genres from the Navidrome music library',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of genres to return (1-500)',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of genres to skip for pagination',
+                    minimum: 0,
+                    default: 0,
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Field to sort by',
+                    default: 'name',
+                },
+                order: {
+                    type: 'string',
+                    description: 'Sort order',
+                    enum: ['ASC', 'DESC'],
+                    default: 'ASC',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_song',
+        description: 'Get detailed information about a specific song by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the song',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'get_album',
+        description: 'Get detailed information about a specific album by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the album',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'get_artist',
+        description: 'Get detailed information about a specific artist by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'The unique ID of the artist',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'get_song_playlists',
+        description: 'Get all playlists that contain a specific song',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                songId: {
+                    type: 'string',
+                    description: 'The unique ID of the song',
+                },
+            },
+            required: ['songId'],
+        },
+    },
+];
+// Factory function for creating library tool category with dependencies  
+export function createLibraryToolCategory(client, config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'list_songs':
+                    return await listSongs(client, args);
+                case 'list_albums':
+                    return await listAlbums(client, args);
+                case 'list_artists':
+                    return await listArtists(client, args);
+                case 'list_genres':
+                    return await listGenres(client, config, args);
+                case 'get_song':
+                    return await getSong(client, args);
+                case 'get_album':
+                    return await getAlbum(client, args);
+                case 'get_artist':
+                    return await getArtist(client, args);
+                case 'get_song_playlists':
+                    return await getSongPlaylists(client, args);
+                default:
+                    throw new Error(`Unknown library tool: ${name}`);
+            }
+        }
+    };
+}
+//# sourceMappingURL=library.js.map

package/dist/tools/library.js.map

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

package/dist/tools/listening-history.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Navidrome MCP Server - Listening History 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';
+export interface RecentlyPlayedTrack {
+    id: string;
+    title: string;
+    artist: string;
+    album: string;
+    playCount: number;
+    lastPlayed?: string;
+    duration: number;
+}
+export interface RecentlyPlayedResult {
+    timeRange: string;
+    count: number;
+    tracks: RecentlyPlayedTrack[];
+}
+export interface MostPlayedItem {
+    id: string;
+    title?: string;
+    name?: string;
+    artist?: string;
+    album?: string;
+    playCount: number;
+    songCount?: number;
+    albumCount?: number;
+}
+export interface MostPlayedResult {
+    type: string;
+    minPlayCount: number;
+    count: number;
+    items: MostPlayedItem[];
+}
+export declare function listRecentlyPlayed(client: NavidromeClient, args: unknown): Promise<RecentlyPlayedResult>;
+export declare function listMostPlayed(client: NavidromeClient, args: unknown): Promise<MostPlayedResult>;
+//# sourceMappingURL=listening-history.d.ts.map

package/dist/tools/listening-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listening-history.d.ts","sourceRoot":"","sources":["../../src/tools/listening-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAgBrE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAQD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyC9G;AASD,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyDtG"}