navidrome-mcp 1.0.1

package/dist/schemas/validation.js

@@ -0,0 +1,143 @@
+/**
+ * Navidrome MCP Server - Validation Schema Definitions
+ * 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 { DEFAULT_VALUES } from '../constants/defaults.js';
+import { SearchQuerySchema, ItemTypeSchema, RatingSchema, UrlSchema, StringArraySchema, OptionalStringArraySchema, NonEmptyStringArraySchema, OptionalBooleanSchema, createLimitSchema, createTimeoutSchema, } from './common.js';
+// User preferences validation
+export const StarItemSchema = z.object({
+    id: z.string().min(1),
+    type: ItemTypeSchema,
+});
+export const SetRatingSchema = z.object({
+    id: z.string().min(1),
+    type: ItemTypeSchema,
+    rating: RatingSchema,
+});
+// Playlist management validation
+export const CreatePlaylistSchema = z.object({
+    name: z.string().min(1, 'Playlist name is required'),
+    comment: z.string().optional(),
+    public: OptionalBooleanSchema.default(false),
+});
+export const UpdatePlaylistSchema = z.object({
+    id: z.string().min(1, 'Playlist ID is required'),
+    name: z.string().min(1).optional(),
+    comment: z.string().optional(),
+    public: OptionalBooleanSchema,
+});
+export const AddTracksToPlaylistSchema = z.object({
+    playlistId: z.string().min(1, 'Playlist ID is required'),
+    ids: OptionalStringArraySchema,
+    albumIds: OptionalStringArraySchema,
+    artistIds: OptionalStringArraySchema,
+    discs: z.array(z.object({
+        albumId: z.string(),
+        discNumber: z.number(),
+    })).optional(),
+});
+export const RemoveTracksFromPlaylistSchema = z.object({
+    playlistId: z.string().min(1, 'Playlist ID is required'),
+    trackIds: NonEmptyStringArraySchema,
+});
+export const ReorderPlaylistTrackSchema = z.object({
+    playlistId: z.string().min(1, 'Playlist ID is required'),
+    trackId: z.string().min(1, 'Track ID is required'),
+    insert_before: z.number().min(0, 'Insert position must be non-negative'),
+});
+// Queue management validation
+export const SetQueueSchema = z.object({
+    songIds: StringArraySchema,
+    current: z.number().min(0).optional().default(0),
+    position: z.number().min(0).optional().default(0),
+});
+// Search validation schemas
+export const SearchAllSchema = SearchQuerySchema.extend({
+    artistCount: z.number().min(0).max(100).optional().default(DEFAULT_VALUES.SEARCH_ALL_LIMIT),
+    albumCount: z.number().min(0).max(100).optional().default(DEFAULT_VALUES.SEARCH_ALL_LIMIT),
+    songCount: z.number().min(0).max(100).optional().default(DEFAULT_VALUES.SEARCH_ALL_LIMIT),
+});
+export const SearchSongsSchema = SearchQuerySchema.extend({
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.SEARCH_LIMIT),
+});
+export const SearchAlbumsSchema = SearchQuerySchema.extend({
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.SEARCH_LIMIT),
+});
+export const SearchArtistsSchema = SearchQuerySchema.extend({
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.SEARCH_LIMIT),
+});
+// Tag validation schemas
+export const SearchByTagsSchema = z.object({
+    tagName: z.string().min(1),
+    tagValue: z.string().optional(),
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.TAG_SEARCH_LIMIT),
+});
+export const TagDistributionSchema = z.object({
+    tagNames: z.array(z.string()).optional(),
+    limit: createLimitSchema(1, 50, DEFAULT_VALUES.TAG_DISTRIBUTION_LIMIT),
+    distributionLimit: createLimitSchema(1, 100, DEFAULT_VALUES.TAG_DISTRIBUTION_VALUES_LIMIT),
+});
+export const UniqueTagsSchema = z.object({
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.UNIQUE_TAGS_LIMIT),
+    minUsage: z.number().min(1).optional().default(1),
+});
+// Radio validation schemas
+export const ValidateRadioStreamSchema = z.object({
+    url: UrlSchema,
+    timeout: createTimeoutSchema(1000, 30000, 8000),
+    followRedirects: OptionalBooleanSchema.default(true),
+});
+// Last.fm validation schemas
+export const SimilarArtistsSchema = z.object({
+    artist: z.string(),
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.SIMILAR_ARTISTS_LIMIT),
+});
+export const SimilarTracksSchema = z.object({
+    artist: z.string(),
+    track: z.string(),
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.SIMILAR_TRACKS_LIMIT),
+});
+export const ArtistInfoSchema = z.object({
+    artist: z.string(),
+    lang: z.string().optional().default('en'),
+});
+export const TopTracksByArtistSchema = z.object({
+    artist: z.string(),
+    limit: createLimitSchema(1, 50, DEFAULT_VALUES.TOP_TRACKS_BY_ARTIST_LIMIT),
+});
+export const TrendingMusicSchema = z.object({
+    type: z.enum(['artists', 'tracks', 'tags']),
+    limit: createLimitSchema(1, 100, DEFAULT_VALUES.TRENDING_MUSIC_LIMIT),
+    page: z.number().min(1).optional().default(1),
+});
+// Lyrics validation schema
+export const GetLyricsSchema = z.object({
+    title: z.string(),
+    artist: z.string(),
+    album: z.string().optional(),
+    durationMs: z.number().min(0).optional(),
+    id: z.string().optional(),
+});
+// Test connection schema
+export const TestConnectionSchema = z.object({
+    includeServerInfo: OptionalBooleanSchema.default(false),
+});
+// Song playlists schema
+export const GetSongPlaylistsSchema = z.object({
+    songId: z.string().min(1, 'Song ID is required'),
+});
+//# sourceMappingURL=validation.js.map

package/dist/schemas/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/schemas/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,cAAc;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,YAAY;CACrB,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,qBAAqB;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACxD,GAAG,EAAE,yBAAyB;IAC9B,QAAQ,EAAE,yBAAyB;IACnC,SAAS,EAAE,yBAAyB;IACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC,CAAC,CAAC,QAAQ,EAAE;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACxD,QAAQ,EAAE,yBAAyB;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;IAClD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;CACzE,CAAC,CAAC;AAEH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAClD,CAAC,CAAC;AAEH,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;IAC3F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;IAC1F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACzD,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC1D,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC;CAC9D,CAAC,CAAC;AAEH,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,gBAAgB,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,sBAAsB,CAAC;IACtE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,6BAA6B,CAAC;CAC3F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,iBAAiB,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAClD,CAAC,CAAC;AAEH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;IAC/C,eAAe,EAAE,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC;CACrD,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,qBAAqB,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,oBAAoB,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,0BAA0B,CAAC;CAC3E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,oBAAoB,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9C,CAAC,CAAC;AAEH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC1B,CAAC,CAAC;AAEH,yBAAyB;AACzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,iBAAiB,EAAE,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC;CACxD,CAAC,CAAC;AAEH,wBAAwB;AACxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;CACjD,CAAC,CAAC"}

package/dist/tools/handlers/lastfm-handlers.d.ts

@@ -0,0 +1,5 @@
+import type { NavidromeClient } from '../../client/navidrome-client.js';
+import type { Config } from '../../config.js';
+import type { ToolCategory } from './registry.js';
+export declare function createLastFmToolCategory(_client: NavidromeClient, config: Config): ToolCategory;
+//# sourceMappingURL=lastfm-handlers.d.ts.map

package/dist/tools/handlers/lastfm-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lastfm-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/lastfm-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAmIlD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAoB/F"}

package/dist/tools/handlers/lastfm-handlers.js

@@ -0,0 +1,143 @@
+import { ErrorFormatter } from '../../utils/error-formatter.js';
+// Import tool functions
+import { getSimilarArtists, getSimilarTracks, getArtistInfo, getTopTracksByArtist, getTrendingMusic, } from '../lastfm-discovery.js';
+// Tool definitions for LastFM discovery category
+const tools = [
+    {
+        name: 'get_similar_artists',
+        description: 'Get similar artists using Last.fm API',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                artist: {
+                    type: 'string',
+                    description: 'Name of the artist to find similar artists for',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of similar artists to return (1-100)',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 100,
+                },
+            },
+            required: ['artist'],
+        },
+    },
+    {
+        name: 'get_similar_tracks',
+        description: 'Get similar tracks using Last.fm API',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                artist: {
+                    type: 'string',
+                    description: 'Name of the track artist',
+                },
+                track: {
+                    type: 'string',
+                    description: 'Name of the track',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of similar tracks to return (1-100)',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 100,
+                },
+            },
+            required: ['artist', 'track'],
+        },
+    },
+    {
+        name: 'get_artist_info',
+        description: 'Get detailed artist information from Last.fm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                artist: {
+                    type: 'string',
+                    description: 'Name of the artist to get information for',
+                },
+                lang: {
+                    type: 'string',
+                    description: 'Language for the biography (ISO 639 code)',
+                    default: 'en',
+                },
+            },
+            required: ['artist'],
+        },
+    },
+    {
+        name: 'get_top_tracks_by_artist',
+        description: 'Get top tracks for an artist from Last.fm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                artist: {
+                    type: 'string',
+                    description: 'Name of the artist',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of top tracks to return (1-50)',
+                    minimum: 1,
+                    maximum: 50,
+                    default: 10,
+                },
+            },
+            required: ['artist'],
+        },
+    },
+    {
+        name: 'get_trending_music',
+        description: 'Get trending music charts from Last.fm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    description: 'Type of chart to get',
+                    enum: ['artists', 'tracks', 'tags'],
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of items to return (1-100)',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 100,
+                },
+                page: {
+                    type: 'number',
+                    description: 'Page number for pagination',
+                    minimum: 1,
+                    default: 1,
+                },
+            },
+            required: ['type'],
+        },
+    },
+];
+// Factory function for creating LastFM tool category with dependencies  
+export function createLastFmToolCategory(_client, config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'get_similar_artists':
+                    return await getSimilarArtists(config, args);
+                case 'get_similar_tracks':
+                    return await getSimilarTracks(config, args);
+                case 'get_artist_info':
+                    return await getArtistInfo(config, args);
+                case 'get_top_tracks_by_artist':
+                    return await getTopTracksByArtist(config, args);
+                case 'get_trending_music':
+                    return await getTrendingMusic(config, args);
+                default:
+                    throw new Error(ErrorFormatter.toolUnknown(`Last.fm ${name}`));
+            }
+        }
+    };
+}
+//# sourceMappingURL=lastfm-handlers.js.map

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

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

package/dist/tools/handlers/lyrics-handlers.d.ts

@@ -0,0 +1,5 @@
+import type { NavidromeClient } from '../../client/navidrome-client.js';
+import type { Config } from '../../config.js';
+import type { ToolCategory } from './registry.js';
+export declare function createLyricsToolCategory(_client: NavidromeClient, config: Config): ToolCategory;
+//# sourceMappingURL=lyrics-handlers.d.ts.map

package/dist/tools/handlers/lyrics-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lyrics-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/lyrics-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAyClD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAY/F"}

package/dist/tools/handlers/lyrics-handlers.js

@@ -0,0 +1,51 @@
+// Import tool functions
+import { getLyrics } from '../lyrics.js';
+// Tool definitions for lyrics category
+const tools = [
+    {
+        name: 'get_lyrics',
+        description: 'Get lyrics for a song (both synced and unsynced). Returns timed lyrics for karaoke-style display when available.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: {
+                    type: 'string',
+                    description: 'Song title',
+                },
+                artist: {
+                    type: 'string',
+                    description: 'Artist name',
+                },
+                album: {
+                    type: 'string',
+                    description: 'Album name (improves match accuracy)',
+                },
+                durationMs: {
+                    type: 'number',
+                    description: 'Song duration in milliseconds (improves match accuracy)',
+                    minimum: 0,
+                },
+                id: {
+                    type: 'string',
+                    description: 'LRCLIB record ID if known',
+                },
+            },
+            required: ['title', 'artist'],
+        },
+    },
+];
+// Factory function for creating lyrics tool category with dependencies  
+export function createLyricsToolCategory(_client, config) {
+    return {
+        tools,
+        async handleToolCall(name, args) {
+            switch (name) {
+                case 'get_lyrics':
+                    return await getLyrics(config, args);
+                default:
+                    throw new Error(`Unknown lyrics tool: ${name}`);
+            }
+        }
+    };
+}
+//# sourceMappingURL=lyrics-handlers.js.map

package/dist/tools/handlers/lyrics-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lyrics-handlers.js","sourceRoot":"","sources":["../../../src/tools/handlers/lyrics-handlers.ts"],"names":[],"mappings":"AAKA,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,uCAAuC;AACvC,MAAM,KAAK,GAAW;IACpB;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,kHAAkH;QAC/H,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,YAAY;iBAC1B;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,aAAa;iBAC3B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yDAAyD;oBACtE,OAAO,EAAE,CAAC;iBACX;gBACD,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;SAC9B;KACF;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,wBAAwB,CAAC,OAAwB,EAAE,MAAc;IAC/E,OAAO;QACL,KAAK;QACL,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAAa;YAC9C,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,YAAY;oBACf,OAAO,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC;oBACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/handlers/playlist-handlers.d.ts

@@ -0,0 +1,5 @@
+import type { NavidromeClient } from '../../client/navidrome-client.js';
+import type { Config } from '../../config.js';
+import type { ToolCategory } from './registry.js';
+export declare function createPlaylistToolCategory(client: NavidromeClient, _config: Config): ToolCategory;
+//# sourceMappingURL=playlist-handlers.d.ts.map

package/dist/tools/handlers/playlist-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlist-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/playlist-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA2SlD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CA8BjG"}