rewind-mcp-server 0.1.1 → 0.4.0

package/dist/__tests__/server.test.js

@@ -13,6 +13,12 @@ async function createTestClient() {
     vi.spyOn(rewindClient, 'get').mockImplementation(async (path) => {
         return getMockResponse(path);
     });
+    // Mock image fetches -- return a tiny fake JPEG payload so imageBlock()
+    // produces a base64 image content block in tool responses.
+    vi.spyOn(rewindClient, 'getBinaryFromUrl').mockResolvedValue({
+        bytes: new Uint8Array([0xff, 0xd8, 0xff, 0xe0]),
+        mimeType: 'image/jpeg',
+    });
     const server = createServer(rewindClient);
     const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
     const client = new Client({
@@ -29,9 +35,27 @@ function getMockResponse(path) {
     if (path === '/listening/now-playing') {
         return {
             is_playing: true,
-            track: { id: 1, name: 'Sabotage' },
-            artist: { name: 'Beastie Boys' },
-            album: { name: 'Ill Communication' },
+            track: {
+                name: 'Sabotage',
+                artist: {
+                    id: 10,
+                    name: 'Beastie Boys',
+                    apple_music_url: 'https://music.apple.com/us/artist/beastie-boys/12',
+                },
+                album: {
+                    id: 20,
+                    name: 'Ill Communication',
+                    image: {
+                        cdn_url: 'https://cdn.rewind.rest/listening/albums/20/original.jpg',
+                        thumbhash: 'x',
+                        dominant_color: '#111',
+                        accent_color: '#222',
+                    },
+                },
+                url: 'https://www.last.fm/music/Beastie+Boys/_/Sabotage',
+                apple_music_url: 'https://music.apple.com/us/album/sabotage/30',
+                preview_url: null,
+            },
             scrobbled_at: new Date().toISOString(),
         };
     }
@@ -39,9 +63,24 @@ function getMockResponse(path) {
         return {
             data: [
                 {
-                    track: { name: 'Sabotage' },
-                    artist: { name: 'Beastie Boys' },
-                    album: { name: 'Ill Communication' },
+                    track: {
+                        id: 1,
+                        name: 'Sabotage',
+                        url: 'https://www.last.fm/x',
+                        apple_music_url: 'https://music.apple.com/us/album/sabotage/30?i=40',
+                        preview_url: null,
+                    },
+                    artist: { id: 10, name: 'Beastie Boys' },
+                    album: {
+                        id: 20,
+                        name: 'Ill Communication',
+                        image: {
+                            cdn_url: 'https://cdn.rewind.rest/listening/albums/20/original.jpg',
+                            thumbhash: 'x',
+                            dominant_color: '#111',
+                            accent_color: '#222',
+                        },
+                    },
                     scrobbled_at: new Date().toISOString(),
                 },
             ],
@@ -53,15 +92,31 @@ function getMockResponse(path) {
             unique_artists: 2100,
             unique_albums: 3800,
             unique_tracks: 12000,
-            scrobbles_per_day: 12.3,
+            registered_date: '2008-01-01',
             years_tracking: 18,
+            scrobbles_per_day: 12.3,
         };
     }
     if (path.startsWith('/listening/top/')) {
         return {
             period: '1month',
             data: [
-                { rank: 1, name: 'Beastie Boys', detail: 'Artist', playcount: 45 },
+                {
+                    rank: 1,
+                    id: 10,
+                    name: 'Beastie Boys',
+                    detail: 'Artist',
+                    playcount: 45,
+                    image: {
+                        cdn_url: 'https://cdn.rewind.rest/listening/artists/10/original.jpg',
+                        thumbhash: 'x',
+                        dominant_color: '#111',
+                        accent_color: '#222',
+                    },
+                    url: 'https://www.last.fm/music/Beastie+Boys',
+                    apple_music_url: 'https://music.apple.com/us/artist/beastie-boys/12',
+                    preview_url: null,
+                },
             ],
         };
     }
@@ -76,22 +131,74 @@ function getMockResponse(path) {
             },
         };
     }
+    if (path === '/listening/genres') {
+        return {
+            data: [
+                { period: '2026-03', genres: { Rock: 120, Pop: 80 }, total: 200 },
+                { period: '2026-04', genres: { Rock: 90, 'Hip-Hop': 60 }, total: 150 },
+            ],
+        };
+    }
     if (path.match(/\/listening\/artists\/\d+/)) {
         return {
+            id: 10,
             name: 'Beastie Boys',
+            mbid: null,
+            url: 'https://www.last.fm/music/Beastie+Boys',
+            apple_music_url: 'https://music.apple.com/us/artist/beastie-boys/12',
             playcount: 500,
             scrobble_count: 500,
             genre: 'Hip Hop',
-            top_albums: [{ name: "Paul's Boutique", playcount: 100 }],
-            top_tracks: [{ name: 'Sabotage', scrobble_count: 50 }],
+            image: {
+                cdn_url: 'https://cdn.rewind.rest/listening/artists/10/original.jpg',
+                thumbhash: 'x',
+                dominant_color: '#111',
+                accent_color: '#222',
+            },
+            top_albums: [
+                {
+                    id: 20,
+                    name: "Paul's Boutique",
+                    playcount: 100,
+                    apple_music_url: null,
+                    image: null,
+                },
+            ],
+            top_tracks: [
+                {
+                    id: 30,
+                    name: 'Sabotage',
+                    scrobble_count: 50,
+                    apple_music_url: null,
+                    preview_url: null,
+                },
+            ],
         };
     }
     if (path.match(/\/listening\/albums\/\d+/)) {
         return {
+            id: 20,
             name: "Paul's Boutique",
-            artist: { name: 'Beastie Boys' },
+            mbid: null,
+            url: 'https://www.last.fm/music/Beastie+Boys/Paul%27s+Boutique',
+            apple_music_url: 'https://music.apple.com/us/album/pauls-boutique/40',
             playcount: 100,
-            tracks: [{ name: 'Shake Your Rump', scrobble_count: 20 }],
+            image: {
+                cdn_url: 'https://cdn.rewind.rest/listening/albums/20/original.jpg',
+                thumbhash: 'x',
+                dominant_color: '#111',
+                accent_color: '#222',
+            },
+            artist: { id: 10, name: 'Beastie Boys' },
+            tracks: [
+                {
+                    id: 30,
+                    name: 'Shake Your Rump',
+                    scrobble_count: 20,
+                    apple_music_url: null,
+                    preview_url: null,
+                },
+            ],
         };
     }
     // Running
@@ -123,6 +230,33 @@ function getMockResponse(path) {
                     city: 'Austin',
                     state: 'TX',
                     is_race: false,
+                    strava_url: 'https://www.strava.com/activities/17956091264',
+                },
+            ],
+        };
+    }
+    if (path === '/running/stats/years') {
+        return {
+            data: [
+                {
+                    year: 2026,
+                    total_runs: 30,
+                    total_distance_mi: 120,
+                    total_elevation_ft: 4000,
+                    total_duration_s: 54000,
+                    avg_pace: '8:00/mi',
+                    longest_run_mi: 13.1,
+                    race_count: 1,
+                },
+                {
+                    year: 2025,
+                    total_runs: 120,
+                    total_distance_mi: 540,
+                    total_elevation_ft: 18000,
+                    total_duration_s: 240000,
+                    avg_pace: '7:55/mi',
+                    longest_run_mi: 13.1,
+                    race_count: 3,
                 },
             ],
         };
@@ -190,20 +324,31 @@ function getMockResponse(path) {
             data: [
                 {
                     movie: {
+                        id: 1,
                         title: 'The Royal Tenenbaums',
                         year: 2001,
                         director: 'Wes Anderson',
+                        tmdb_id: 9428,
+                        image: {
+                            url: 'https://cdn.rewind.rest/watching/movies/1/original.jpg',
+                            thumbhash: 'xhash',
+                            dominant_color: '#222',
+                            accent_color: '#c83',
+                        },
                     },
                     watched_at: new Date().toISOString(),
                     user_rating: 9,
                     rewatch: false,
                     source: 'plex',
+                    review: null,
+                    review_url: 'https://letterboxd.com/patdugan/film/the-royal-tenenbaums/',
                 },
             ],
         };
     }
     if (path.match(/\/watching\/movies\/\d+/)) {
         return {
+            id: 1,
             title: 'The Royal Tenenbaums',
             year: 2001,
             director: 'Wes Anderson',
@@ -211,11 +356,27 @@ function getMockResponse(path) {
             genres: ['Comedy', 'Drama'],
             duration_min: 109,
             rating: 'R',
+            tmdb_id: 9428,
             tmdb_rating: 7.6,
             tagline: "Family isn't a word. It's a sentence.",
             summary: 'A family drama.',
             imdb_id: 'tt0265666',
-            watch_history: [],
+            image: {
+                url: 'https://cdn.rewind.rest/watching/movies/1/original.jpg',
+                thumbhash: 'xhash',
+                dominant_color: '#222',
+                accent_color: '#c83',
+            },
+            watch_history: [
+                {
+                    watched_at: '2026-03-10T02:30:00.000Z',
+                    user_rating: 9,
+                    rewatch: false,
+                    review: null,
+                    review_url: 'https://letterboxd.com/patdugan/film/the-royal-tenenbaums/',
+                    source: 'plex',
+                },
+            ],
         };
     }
     if (path === '/watching/stats') {
@@ -234,6 +395,31 @@ function getMockResponse(path) {
             },
         };
     }
+    if (path === '/watching/stats/genres') {
+        return {
+            data: [
+                { name: 'Drama', count: 120, percentage: 38.5 },
+                { name: 'Comedy', count: 80, percentage: 25.6 },
+            ],
+        };
+    }
+    if (path === '/watching/stats/decades') {
+        return {
+            data: [
+                { decade: 2020, count: 45 },
+                { decade: 2010, count: 90 },
+                { decade: 2000, count: 60 },
+            ],
+        };
+    }
+    if (path === '/watching/stats/directors') {
+        return {
+            data: [
+                { name: 'Wes Anderson', count: 8 },
+                { name: 'Christopher Nolan', count: 6 },
+            ],
+        };
+    }
     if (path === '/watching/movies') {
         return {
             data: [
@@ -242,9 +428,18 @@ function getMockResponse(path) {
                     title: 'The Royal Tenenbaums',
                     year: 2001,
                     director: 'Wes Anderson',
+                    directors: ['Wes Anderson'],
                     genres: ['Comedy'],
                     duration_min: 109,
+                    rating: 'R',
+                    tmdb_id: 9428,
                     tmdb_rating: 7.6,
+                    image: {
+                        url: 'https://cdn.rewind.rest/watching/movies/1/original.jpg',
+                        thumbhash: 'xhash',
+                        dominant_color: '#222',
+                        accent_color: '#c83',
+                    },
                 },
             ],
             pagination: { page: 1, limit: 10, total: 1, total_pages: 1 },
@@ -256,6 +451,7 @@ function getMockResponse(path) {
             data: [
                 {
                     id: 1,
+                    discogs_id: 100,
                     title: 'Hello Nasty',
                     artists: ['Beastie Boys'],
                     year: 2009,
@@ -263,12 +459,42 @@ function getMockResponse(path) {
                     format_detail: 'LP, Reissue',
                     label: 'Capitol Records',
                     genres: ['Hip Hop'],
+                    styles: [],
+                    image: {
+                        cdn_url: 'https://cdn.rewind.rest/collecting/releases/1/original.jpg',
+                        thumbhash: 'x',
+                        dominant_color: '#111',
+                        accent_color: '#222',
+                    },
                     date_added: '2024-01-15',
+                    rating: null,
+                    discogs_url: 'https://www.discogs.com/release/100',
                 },
             ],
             pagination: { page: 1, limit: 10, total: 1, total_pages: 1 },
         };
     }
+    if (path.match(/\/collecting\/vinyl\/\d+/)) {
+        return {
+            id: 1,
+            discogs_id: 100,
+            title: 'Hello Nasty',
+            artists: ['Beastie Boys'],
+            year: 2009,
+            format: 'Vinyl',
+            format_detail: 'LP, Reissue',
+            label: 'Capitol Records',
+            genres: ['Hip Hop'],
+            styles: [],
+            image: {
+                cdn_url: 'https://cdn.rewind.rest/collecting/releases/1/original.jpg',
+            },
+            date_added: '2024-01-15',
+            rating: null,
+            discogs_url: 'https://www.discogs.com/release/100',
+            tracklist: [],
+        };
+    }
     if (path === '/collecting/stats') {
         return {
             data: {
@@ -276,9 +502,11 @@ function getMockResponse(path) {
                 by_format: { vinyl: 120, cd: 25, cassette: 5 },
                 wantlist_count: 30,
                 unique_artists: 95,
+                estimated_value: null,
                 top_genre: 'Rock',
                 oldest_release_year: 1967,
                 newest_release_year: 2025,
+                most_collected_artist: null,
                 added_this_year: 12,
             },
         };
@@ -290,14 +518,48 @@ function getMockResponse(path) {
                     id: 1,
                     title: 'The Killing',
                     year: 1956,
-                    media_type: 'bluray',
+                    tmdb_id: 100,
+                    imdb_id: null,
+                    image: {
+                        cdn_url: 'https://cdn.rewind.rest/collecting/releases/1/original.jpg',
+                    },
+                    runtime: null,
                     tmdb_rating: 7.6,
+                    media_type: 'bluray',
+                    resolution: null,
+                    hdr: null,
+                    audio: null,
+                    audio_channels: null,
                     collected_at: '2026-03-26',
                 },
             ],
             pagination: { page: 1, limit: 10, total: 1, total_pages: 1 },
         };
     }
+    if (path.match(/\/collecting\/media\/\d+$/)) {
+        return {
+            id: 1,
+            title: 'The Killing',
+            year: 1956,
+            tmdb_id: 100,
+            imdb_id: null,
+            tagline: null,
+            summary: null,
+            image: {
+                cdn_url: 'https://cdn.rewind.rest/collecting/releases/1/original.jpg',
+            },
+            runtime: null,
+            tmdb_rating: 7.6,
+            content_rating: null,
+            media_type: 'bluray',
+            resolution: null,
+            hdr: null,
+            audio: null,
+            audio_channels: null,
+            collected_at: '2026-03-26',
+            watch_history: [],
+        };
+    }
     if (path === '/collecting/media/formats') {
         return {
             data: [
@@ -315,15 +577,37 @@ function getMockResponse(path) {
                     id: 1,
                     title: 'How to Build an MCP Server',
                     author: 'Anthropic',
+                    url: 'https://www.anthropic.com/blog/how-to-build-an-mcp-server',
                     domain: 'anthropic.com',
                     estimated_read_min: 12,
                     status: 'archived',
                     progress: 1,
+                    image: {
+                        cdn_url: 'https://cdn.rewind.rest/reading/articles/1/original.jpg',
+                        thumbhash: 'x',
+                        dominant_color: '#111',
+                        accent_color: '#222',
+                    },
                     saved_at: new Date().toISOString(),
                 },
             ],
         };
     }
+    if (path.match(/\/reading\/articles\/\d+/)) {
+        return {
+            id: 1,
+            title: 'How to Build an MCP Server',
+            author: 'Anthropic',
+            url: 'https://www.anthropic.com/blog/how-to-build-an-mcp-server',
+            domain: 'anthropic.com',
+            estimated_read_min: 12,
+            status: 'archived',
+            progress: 1,
+            image: null,
+            highlights: [],
+            saved_at: new Date().toISOString(),
+        };
+    }
     if (path === '/reading/highlights') {
         return {
             data: [
@@ -332,9 +616,11 @@ function getMockResponse(path) {
                     note: null,
                     created_at: '2026-01-15',
                     article: {
+                        id: 99,
                         title: 'Less is More',
                         author: 'Jeff Atwood',
                         domain: 'blog.codinghorror.com',
+                        url: 'https://blog.codinghorror.com/less-is-more/',
                     },
                 },
             ],
@@ -347,9 +633,11 @@ function getMockResponse(path) {
             note: 'Leonardo da Vinci',
             created_at: '2025-06-01',
             article: {
+                id: 100,
                 title: 'Design Principles',
                 author: null,
                 domain: 'example.com',
+                url: 'https://example.com/design-principles',
             },
         };
     }
@@ -404,11 +692,19 @@ function getMockResponse(path) {
                 {
                     domain: 'listening',
                     entity_type: 'artist',
+                    entity_id: '10',
                     title: 'Beastie Boys',
                     subtitle: null,
                 },
+                {
+                    domain: 'watching',
+                    entity_type: 'movie',
+                    entity_id: '1',
+                    title: 'The Royal Tenenbaums',
+                    subtitle: '2001',
+                },
             ],
-            pagination: { total: 1 },
+            pagination: { total: 2 },
         };
     }
     // Health
@@ -457,6 +753,8 @@ describe('MCP Server', () => {
             expect(names).toContain('get_vinyl_collection');
             expect(names).toContain('get_physical_media');
             expect(names).toContain('search');
+            expect(names).toContain('semantic_search');
+            expect(names).toContain('find_similar_articles');
             expect(names).toContain('get_feed');
         });
         it('all tools have readOnlyHint annotation', async () => {
@@ -472,11 +770,24 @@ describe('MCP Server', () => {
         });
         it('lists prompts', async () => {
             const { prompts } = await client.listPrompts();
-            expect(prompts.length).toBe(3);
+            expect(prompts.length).toBe(7);
             const names = prompts.map((p) => p.name);
             expect(names).toContain('weekly-summary');
             expect(names).toContain('year-in-review');
             expect(names).toContain('compare-periods');
+            expect(names).toContain('letterboxd-review-draft');
+            expect(names).toContain('training-report');
+            expect(names).toContain('film-diet');
+            expect(names).toContain('find-article');
+        });
+        it('exposes server instructions', () => {
+            const instructions = client.getInstructions();
+            expect(instructions).toBeTruthy();
+            expect(instructions).toContain('Rewind');
+            expect(instructions).toContain('listening');
+            expect(instructions).toContain('resource link');
+            // Keep under 2KB (Claude Code truncates above that)
+            expect(instructions.length).toBeLessThan(2048);
         });
     });
     describe('tool responses are text, not JSON', () => {
@@ -610,5 +921,391 @@ describe('MCP Server', () => {
             expect(text).toContain('2025');
         });
     });
+    describe('Phase 1 -- watching rich responses', () => {
+        it('lists the three new aggregate watching tools', async () => {
+            const { tools } = await client.listTools();
+            const names = tools.map((t) => t.name);
+            expect(names).toContain('get_watching_genres');
+            expect(names).toContain('get_watching_decades');
+            expect(names).toContain('get_watching_directors');
+        });
+        it('get_movie_details returns text, image, resource_link, and structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_movie_details',
+                arguments: { id: 1 },
+            });
+            const content = result.content;
+            const textBlock = content.find((b) => b.type === 'text');
+            const image = content.find((b) => b.type === 'image');
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(textBlock?.text).toContain('The Royal Tenenbaums');
+            expect(image?.mimeType).toBe('image/jpeg');
+            expect(image?.data).toBeTruthy();
+            expect(link?.uri).toContain('letterboxd.com');
+            const structured = result
+                .structuredContent;
+            expect(structured?.id).toBe(1);
+        });
+        it('get_movie_details with include_images=false omits image blocks', async () => {
+            const result = await client.callTool({
+                name: 'get_movie_details',
+                arguments: { id: 1, include_images: false },
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeUndefined();
+            // resource_link should still be present
+            expect(content.find((b) => b.type === 'resource_link')).toBeDefined();
+        });
+        it('get_recent_watches emits posters and Letterboxd links', async () => {
+            const result = await client.callTool({
+                name: 'get_recent_watches',
+                arguments: {},
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('letterboxd.com');
+            expect(link?.name).toContain('Letterboxd');
+        });
+        it('browse_movies emits posters and structuredContent with pagination', async () => {
+            const result = await client.callTool({
+                name: 'browse_movies',
+                arguments: {},
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            const structured = result.structuredContent;
+            expect(structured?.pagination?.total).toBe(1);
+        });
+        it('get_watching_stats returns structuredContent mirroring the API', async () => {
+            const result = await client.callTool({
+                name: 'get_watching_stats',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.total_movies).toBe(312);
+            expect(structured?.top_director).toBe('Wes Anderson');
+            // No image blocks on stats tools
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeUndefined();
+        });
+        it('get_watching_genres returns percentages and structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_watching_genres',
+                arguments: {},
+            });
+            const text = result.content[0].text;
+            expect(text).toContain('Drama');
+            expect(text).toContain('38.5%');
+            const structured = result.structuredContent;
+            expect(structured?.items[0].name).toBe('Drama');
+        });
+        it('get_watching_decades returns decade breakdown', async () => {
+            const result = await client.callTool({
+                name: 'get_watching_decades',
+                arguments: {},
+            });
+            const text = result.content[0].text;
+            expect(text).toContain('2020s');
+            expect(text).toContain('2010s');
+        });
+        it('get_watching_directors returns ranked directors', async () => {
+            const result = await client.callTool({
+                name: 'get_watching_directors',
+                arguments: {},
+            });
+            const text = result.content[0].text;
+            expect(text).toContain('Wes Anderson');
+            expect(text).toContain('1. Wes Anderson');
+        });
+        it('registers movie and show entity resource templates', async () => {
+            const { resourceTemplates } = await client.listResourceTemplates();
+            const uris = resourceTemplates.map((t) => t.uriTemplate);
+            expect(uris).toContain('rewind://movie/{id}');
+            expect(uris).toContain('rewind://show/{id}');
+        });
+        it('reads a movie entity via rewind://movie/{id}', async () => {
+            const result = await client.readResource({ uri: 'rewind://movie/1' });
+            expect(result.contents.length).toBe(1);
+            const content = result.contents[0];
+            expect(content.mimeType).toBe('application/json');
+            const data = JSON.parse(content.text);
+            expect(data.title).toBe('The Royal Tenenbaums');
+        });
+    });
+    describe('Phase 2 -- listening rich responses', () => {
+        it('lists get_listening_genres tool', async () => {
+            const { tools } = await client.listTools();
+            expect(tools.map((t) => t.name)).toContain('get_listening_genres');
+        });
+        it('get_now_playing returns text, album cover image, and Apple Music links', async () => {
+            const result = await client.callTool({
+                name: 'get_now_playing',
+                arguments: {},
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            const links = content.filter((b) => b.type === 'resource_link');
+            expect(links.length).toBeGreaterThanOrEqual(2);
+            expect(links.some((b) => b.name?.includes('Apple Music'))).toBe(true);
+        });
+        it('get_album_details returns cover, Apple Music link, and structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_album_details',
+                arguments: { id: 20 },
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            expect(content.find((b) => b.type === 'resource_link' && b.name?.includes('Apple Music'))).toBeDefined();
+            const structured = result
+                .structuredContent;
+            expect(structured?.id).toBe(20);
+        });
+        it('get_artist_details returns artist image and links', async () => {
+            const result = await client.callTool({
+                name: 'get_artist_details',
+                arguments: { id: 10 },
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            expect(content.find((b) => b.type === 'resource_link' && b.name?.includes('Apple Music'))).toBeDefined();
+        });
+        it('get_recent_listens emits top-N covers and Apple Music links', async () => {
+            const result = await client.callTool({
+                name: 'get_recent_listens',
+                arguments: {},
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            expect(content.find((b) => b.type === 'resource_link')).toBeDefined();
+        });
+        it('get_top_artists includes structuredContent mirroring API shape', async () => {
+            const result = await client.callTool({
+                name: 'get_top_artists',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.period).toBe('1month');
+            expect(structured?.data[0].id).toBe(10);
+        });
+        it('get_listening_genres returns period breakdown and structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_listening_genres',
+                arguments: {},
+            });
+            const text = result.content[0].text;
+            expect(text).toContain('Rock');
+            const structured = result.structuredContent;
+            expect(structured?.items[0].period).toBe('2026-03');
+        });
+        it('registers album and artist entity resource templates', async () => {
+            const { resourceTemplates } = await client.listResourceTemplates();
+            const uris = resourceTemplates.map((t) => t.uriTemplate);
+            expect(uris).toContain('rewind://album/{id}');
+            expect(uris).toContain('rewind://artist/{id}');
+        });
+        it('reads an album entity via rewind://album/{id}', async () => {
+            const result = await client.readResource({ uri: 'rewind://album/20' });
+            const content = result.contents[0];
+            expect(content.mimeType).toBe('application/json');
+            const data = JSON.parse(content.text);
+            expect(data.name).toBe("Paul's Boutique");
+        });
+    });
+    describe('Phase 3 -- collecting rich responses', () => {
+        it('get_vinyl_collection emits top-N covers + Discogs resource_links', async () => {
+            const result = await client.callTool({
+                name: 'get_vinyl_collection',
+                arguments: {},
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('discogs.com');
+            expect(link?.name).toContain('Discogs');
+        });
+        it('get_collecting_stats includes structuredContent mirroring the API', async () => {
+            const result = await client.callTool({
+                name: 'get_collecting_stats',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.total_items).toBe(150);
+            expect(structured?.by_format.vinyl).toBe(120);
+        });
+        it('get_physical_media emits covers and pagination', async () => {
+            const result = await client.callTool({
+                name: 'get_physical_media',
+                arguments: {},
+            });
+            const content = result.content;
+            expect(content.find((b) => b.type === 'image')).toBeDefined();
+            const structured = result.structuredContent;
+            expect(structured?.pagination?.total).toBe(1);
+        });
+        it('get_physical_media_stats returns total + per-format structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_physical_media_stats',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.total).toBe(97);
+            expect(structured?.formats.length).toBe(3);
+        });
+        it('registers vinyl and physical-media entity templates', async () => {
+            const { resourceTemplates } = await client.listResourceTemplates();
+            const uris = resourceTemplates.map((t) => t.uriTemplate);
+            expect(uris).toContain('rewind://vinyl/{id}');
+            expect(uris).toContain('rewind://physical-media/{id}');
+        });
+        it('reads a vinyl entity via rewind://vinyl/{id}', async () => {
+            const result = await client.readResource({ uri: 'rewind://vinyl/1' });
+            const content = result.contents[0];
+            expect(content.mimeType).toBe('application/json');
+            const data = JSON.parse(content.text);
+            expect(data.title).toBe('Hello Nasty');
+        });
+    });
+    describe('Phase 4 -- reading rich responses', () => {
+        it('get_recent_reads emits article URL resource_links and structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_recent_reads',
+                arguments: {},
+            });
+            const content = result.content;
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('anthropic.com');
+            const structured = result.structuredContent;
+            expect(structured?.items[0].id).toBe(1);
+        });
+        it('get_reading_highlights emits article URLs as resource_links', async () => {
+            const result = await client.callTool({
+                name: 'get_reading_highlights',
+                arguments: {},
+            });
+            const content = result.content;
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('codinghorror.com');
+        });
+        it('get_random_highlight emits article URL resource_link', async () => {
+            const result = await client.callTool({
+                name: 'get_random_highlight',
+                arguments: {},
+            });
+            const content = result.content;
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('example.com');
+        });
+        it('get_reading_stats returns structuredContent mirroring API', async () => {
+            const result = await client.callTool({
+                name: 'get_reading_stats',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.total_articles).toBe(350);
+            expect(structured?.total_highlights).toBe(420);
+        });
+        it('registers article entity template', async () => {
+            const { resourceTemplates } = await client.listResourceTemplates();
+            const uris = resourceTemplates.map((t) => t.uriTemplate);
+            expect(uris).toContain('rewind://article/{id}');
+        });
+        it('reads an article entity via rewind://article/{id}', async () => {
+            const result = await client.readResource({ uri: 'rewind://article/1' });
+            const content = result.contents[0];
+            expect(content.mimeType).toBe('application/json');
+            const data = JSON.parse(content.text);
+            expect(data.title).toBe('How to Build an MCP Server');
+        });
+    });
+    describe('Phase 5 -- running rich responses', () => {
+        it('lists the new get_running_years tool', async () => {
+            const { tools } = await client.listTools();
+            expect(tools.map((t) => t.name)).toContain('get_running_years');
+        });
+        it('get_recent_runs emits Strava resource_links', async () => {
+            const result = await client.callTool({
+                name: 'get_recent_runs',
+                arguments: {},
+            });
+            const content = result.content;
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('strava.com');
+        });
+        it('get_activity_details emits Strava resource_link and structuredContent', async () => {
+            const result = await client.callTool({
+                name: 'get_activity_details',
+                arguments: { id: 123 },
+            });
+            const content = result.content;
+            const link = content.find((b) => b.type === 'resource_link');
+            expect(link?.uri).toContain('strava.com');
+            expect(link?.name).toContain('Strava');
+            const structured = result
+                .structuredContent;
+            expect(structured?.name).toBe('Thursday Afternoon Run');
+        });
+        it('get_running_stats returns structuredContent mirroring API', async () => {
+            const result = await client.callTool({
+                name: 'get_running_stats',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.total_runs).toBe(423);
+            expect(structured?.eddington_number).toBe(12);
+        });
+        it('get_running_years returns per-year breakdown', async () => {
+            const result = await client.callTool({
+                name: 'get_running_years',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.items.length).toBe(2);
+            expect(structured?.items[0].year).toBe(2026);
+        });
+        it('registers activity entity template', async () => {
+            const { resourceTemplates } = await client.listResourceTemplates();
+            const uris = resourceTemplates.map((t) => t.uriTemplate);
+            expect(uris).toContain('rewind://activity/{id}');
+        });
+    });
+    describe('Phase 6 -- cross-domain rich responses', () => {
+        it('search emits rewind:// resource_links per match', async () => {
+            const result = await client.callTool({
+                name: 'search',
+                arguments: { query: 'beastie' },
+            });
+            const content = result.content;
+            const links = content.filter((b) => b.type === 'resource_link');
+            expect(links.length).toBeGreaterThanOrEqual(2);
+            expect(links.map((l) => l.uri)).toContain('rewind://artist/10');
+            expect(links.map((l) => l.uri)).toContain('rewind://movie/1');
+        });
+        it('search structuredContent mirrors API', async () => {
+            const result = await client.callTool({
+                name: 'search',
+                arguments: { query: 'beastie' },
+            });
+            const structured = result.structuredContent;
+            expect(structured?.items.length).toBe(2);
+            expect(structured?.pagination.total).toBe(2);
+        });
+        it('get_feed returns structuredContent with items + pagination', async () => {
+            const result = await client.callTool({
+                name: 'get_feed',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.items[0].domain).toBe('listening');
+        });
+        it('get_on_this_day returns structuredContent grouped by year', async () => {
+            const result = await client.callTool({
+                name: 'get_on_this_day',
+                arguments: {},
+            });
+            const structured = result.structuredContent;
+            expect(structured?.years[0].year).toBe(2025);
+        });
+    });
 });
 //# sourceMappingURL=server.test.js.map