sbb-mcp 0.4.0 → 0.4.2

package/dist/tools.js

@@ -1,30 +1,21 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { isSmapiConfigured, searchPlaces, searchTrips, getTrip, paginateTrips, getTripPrices, getTripOffers, mockSearchPlaces, mockSearchTrips, mockGetTripPrices, } from './transport/index.js';
-import { formatStations, formatConnections, formatTripDetails, formatPrices, formatTicketLink, buildSbbDeepLink, appendWeatherToConnections, } from './formatters.js';
+import { formatStations, formatConnections, formatTripDetails, formatPrices, formatTicketLink, buildSbbDeepLink, } from './formatters.js';
 import { cacheGet, cacheSet, TTL } from './cache.js';
 import { SmapiError } from './transport/smapi-client.js';
 import { loadProfile, saveProfile, formatProfileSummary, isReductionCardExpired } from './profile.js';
 import { isSwissTripConfigured, fetchProfile as fetchCloudProfile, fetchTravelers, toSmapiTraveler, formatTravelersList, formatCloudProfile, } from './swisstrip.js';
-import { resolveLang } from './i18n.js';
+import { getWeatherSummary } from 'swiss-weather-mcp';
+import { toStationsListDTO, toConnectionListDTO, toTripDetailsDTO, toPricesTableDTO, toTicketCardDTO, } from './structured.js';
+import { registerWidgets, widgetResponseMeta, widgetToolMeta, WIDGETS } from './widgets.js';
 const useMock = !isSmapiConfigured();
 const useCloud = isSwissTripConfigured();
-const LANG_ENUM = z.enum(['de', 'fr', 'it', 'en', 'es', 'pt', 'ru', 'ar', 'zh']);
-const LANG_DESC = "Output language (de/fr/it/en/es/pt/ru/ar/zh). Defaults to the user's saved profile language or English.";
-/** Pick the effective language: tool arg > saved profile > English. */
-function effectiveLang(arg, profile) {
-    if (arg)
-        return resolveLang(arg);
-    if (profile?.language)
-        return resolveLang(profile.language);
-    return 'en';
-}
 /** Match SwissTrip travelers by first name (case-insensitive, fuzzy) */
 function matchTravelersByName(all, names) {
     const matched = [];
     for (const name of names) {
         const lower = name.toLowerCase();
-        // Try exact first_name match, then label match, then partial match
         const found = all.find(t => t.first_name?.toLowerCase() === lower ||
             t.label?.toLowerCase() === lower) || all.find(t => t.first_name?.toLowerCase().startsWith(lower) ||
             t.last_name?.toLowerCase() === lower);
@@ -43,12 +34,24 @@ function errorResult(err) {
     const message = err instanceof Error ? err.message : String(err);
     return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
 }
+/** Compute Europe/Zurich ISO timestamp for a (date, HH:MM) pair. */
+function zurichIso(date, time) {
+    const probe = new Date(`${date}T${time}:00Z`);
+    const zurichStr = probe.toLocaleString('en-US', { timeZone: 'Europe/Zurich' });
+    const zurichTime = new Date(zurichStr + ' UTC');
+    const offsetMs = zurichTime.getTime() - probe.getTime();
+    const offsetHours = Math.round(offsetMs / (60 * 60 * 1000));
+    const offsetStr = `${offsetHours >= 0 ? '+' : '-'}${String(Math.abs(offsetHours)).padStart(2, '0')}:00`;
+    return new Date(`${date}T${time}:00${offsetStr}`).toISOString();
+}
 export function createSbbMcpServer() {
     const server = new McpServer({
         name: 'sbb-mcp',
-        version: '0.4.0',
+        version: '0.4.2',
         description: 'Swiss Federal Railways (SBB/CFF/FFS) — real-time train schedules, prices, and ticket purchase links for Switzerland',
     });
+    // ─── Widget resources (ChatGPT Apps SDK) ───────────────────────────────
+    registerWidgets(server);
     // ─── Prompts ───────────────────────────────────────────────────────────
     server.prompt('plan_journey', 'Plan a train journey in Switzerland — finds connections, compares prices, and provides ticket links', {
         from: z.string().describe('Origin station (e.g. "Zurich")'),
@@ -68,7 +71,6 @@ export function createSbbMcpServer() {
         description: 'The user\'s saved travel profile (name, DOB, reduction card). Read this before showing prices or generating ticket links. If empty, ask the user for their details and save with save_profile.',
         mimeType: 'text/plain',
     }, async () => {
-        // Cloud profile takes precedence when SWISSTRIP_TOKEN is set
         if (useCloud) {
             try {
                 const cloudProfile = await fetchCloudProfile();
@@ -81,7 +83,7 @@ export function createSbbMcpServer() {
                 };
             }
             catch {
-                // Fall through to local profile on cloud error
+                // Fall through
             }
         }
         const profile = loadProfile();
@@ -108,14 +110,18 @@ export function createSbbMcpServer() {
         };
     });
     // ─── Tool: save_profile ──────────────────────────────────────────────
-    server.tool('save_profile', 'Save the user\'s travel profile locally for future sessions. Call this after asking the user for their details (name, date of birth, reduction card). Data is stored at ~/.sbb-mcp/profile.json.', {
-        first_name: z.string().optional().describe('First name (for ticket booking)'),
-        last_name: z.string().optional().describe('Last name (for ticket booking)'),
-        date_of_birth: z.string().optional().describe('Date of birth YYYY-MM-DD (for age-based pricing)'),
-        reduction_card: z.enum(['HALF_FARE', 'GA', 'NONE']).optional().describe('Swiss reduction card: HALF_FARE (Halbtax), GA (General Abonnement), or NONE'),
-        reduction_card_valid_until: z.string().optional().describe('Reduction card expiry date YYYY-MM-DD (ask the user when their Halbtax/GA expires)'),
-        language: LANG_ENUM.optional().describe('Preferred output language — saved as the default for all future tool calls. ' + LANG_DESC),
-    }, { title: 'Save Travel Profile', readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ first_name, last_name, date_of_birth, reduction_card, reduction_card_valid_until, language }) => {
+    server.registerTool('save_profile', {
+        title: 'Save Travel Profile',
+        description: 'Save the user\'s travel profile locally for future sessions. Call this after asking the user for their details (name, date of birth, reduction card). Data is stored at ~/.sbb-mcp/profile.json.',
+        inputSchema: {
+            first_name: z.string().optional().describe('First name (for ticket booking)'),
+            last_name: z.string().optional().describe('Last name (for ticket booking)'),
+            date_of_birth: z.string().optional().describe('Date of birth YYYY-MM-DD (for age-based pricing)'),
+            reduction_card: z.enum(['HALF_FARE', 'GA', 'NONE']).optional().describe('Swiss reduction card: HALF_FARE (Halbtax), GA (General Abonnement), or NONE'),
+            reduction_card_valid_until: z.string().optional().describe('Reduction card expiry date YYYY-MM-DD (ask the user when their Halbtax/GA expires)'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ first_name, last_name, date_of_birth, reduction_card, reduction_card_valid_until }) => {
         try {
             const updates = {};
             if (first_name)
@@ -128,40 +134,43 @@ export function createSbbMcpServer() {
                 updates.reduction_card = reduction_card;
             if (reduction_card_valid_until)
                 updates.reduction_card_valid_until = reduction_card_valid_until;
-            if (language)
-                updates.language = language;
             saveProfile(updates);
             const profile = loadProfile();
-            const lang = effectiveLang(language, profile);
-            return { content: [{ type: 'text', text: formatProfileSummary(profile, lang) }] };
+            return { content: [{ type: 'text', text: formatProfileSummary(profile) }] };
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // ─── Tool: get_profile ───────────────────────────────────────────────
-    server.tool('get_profile', 'Read the user\'s saved travel profile. Check this before showing prices to use correct reduction card. If no profile exists, ask the user for their details.', {
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Get Travel Profile', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ language }) => {
-        // Cloud profile takes precedence
+    server.registerTool('get_profile', {
+        title: 'Get Travel Profile',
+        description: 'Read the user\'s saved travel profile. Check this before showing prices to use correct reduction card. If no profile exists, ask the user for their details.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async () => {
         if (useCloud) {
             try {
                 const cloudProfile = await fetchCloudProfile();
                 return { content: [{ type: 'text', text: formatCloudProfile(cloudProfile) }] };
             }
             catch {
-                // Fall through to local
+                // Fall through
             }
         }
         const profile = loadProfile();
         if (!profile) {
             return { content: [{ type: 'text', text: 'No travel profile saved. Ask the user: "Do you have a Halbtax or GA travelcard?" Then use save_profile to store their details for next time.' }] };
         }
-        const lang = effectiveLang(language, profile);
-        return { content: [{ type: 'text', text: formatProfileSummary(profile, lang) }] };
+        return { content: [{ type: 'text', text: formatProfileSummary(profile) }] };
     });
     // ─── Tool: list_travelers (SwissTrip cloud only) ─────────────────────
-    server.tool('list_travelers', 'List all travelers in the user\'s SwissTrip account (self, partner, kids). Each traveler has their own reduction card. Use their names with get_prices for family trip pricing. Requires SWISSTRIP_TOKEN.', {}, { title: 'List Travelers', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
+    server.registerTool('list_travelers', {
+        title: 'List Travelers',
+        description: 'List all travelers in the user\'s SwissTrip account (self, partner, kids). Each traveler has their own reduction card. Use their names with get_prices for family trip pricing. Requires SWISSTRIP_TOKEN.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async () => {
         if (!useCloud) {
             return { content: [{ type: 'text', text: 'list_travelers requires a SwissTrip account connection (SWISSTRIP_TOKEN). Without it, use save_profile/get_profile for single-traveler local profiles.' }] };
         }
@@ -172,7 +181,7 @@ export function createSbbMcpServer() {
                 return { content: [{ type: 'text', text: cached }] };
             const travelers = await fetchTravelers();
             const text = formatTravelersList(travelers);
-            cacheSet(cacheKey, text, TTL.STATIONS); // ~1h cache
+            cacheSet(cacheKey, text, TTL.STATIONS);
             return { content: [{ type: 'text', text }] };
         }
         catch (err) {
@@ -180,45 +189,51 @@ export function createSbbMcpServer() {
         }
     });
     // ─── Tool 1: search_stations ──────────────────────────────────────────
-    server.tool('search_stations', 'Search for Swiss train stations, addresses, or points of interest by name. Returns station IDs needed for other tools.', {
-        query: z.string().describe('Station name to search for (e.g. "Zurich", "Bern", "Interlaken")'),
-        limit: z.number().min(1).max(20).default(10).describe('Maximum number of results'),
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Search Stations', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ query, limit, language }) => {
+    server.registerTool('search_stations', {
+        title: 'Search Stations',
+        description: 'Search for Swiss train stations, addresses, or points of interest by name. Returns station IDs needed for other tools.',
+        inputSchema: {
+            query: z.string().describe('Station name to search for (e.g. "Zurich", "Bern", "Interlaken")'),
+            limit: z.number().min(1).max(20).default(10).describe('Maximum number of results'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        _meta: widgetToolMeta(WIDGETS.STATIONS_LIST, 'Searching stations…', 'Stations ready'),
+    }, async ({ query, limit }) => {
         try {
-            const lang = effectiveLang(language, loadProfile());
-            const cacheKey = `stations:${query.toLowerCase()}:${limit}:${lang}`;
-            const cached = cacheGet(cacheKey);
-            if (cached)
-                return { content: [{ type: 'text', text: cached }] };
             const stations = useMock
                 ? await mockSearchPlaces({ name: query })
-                : await searchPlaces({ name: query, type: 'STOP', numberOfResults: limit, lang });
-            const text = formatStations(stations, lang);
-            cacheSet(cacheKey, text, TTL.STATIONS);
-            return { content: [{ type: 'text', text }] };
+                : await searchPlaces({ name: query, type: 'STOP', numberOfResults: limit });
+            return {
+                content: [{ type: 'text', text: formatStations(stations) }],
+                structuredContent: toStationsListDTO(query, stations),
+                _meta: widgetResponseMeta(WIDGETS.STATIONS_LIST),
+            };
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // ─── Tool 2: search_connections ───────────────────────────────────────
-    server.tool('search_connections', 'Find train connections between two Swiss stations. Returns schedules with departure/arrival times, duration, transfers, and trip IDs for pricing.', {
-        from: z.string().describe('Origin station name or ID (e.g. "Zurich HB" or "8503000")'),
-        to: z.string().describe('Destination station name or ID (e.g. "Bern" or "8507000")'),
-        date: z.string().optional().describe('Travel date in YYYY-MM-DD format (default: today)'),
-        time: z.string().optional().describe('Departure time in HH:MM format (default: now)'),
-        arrival_time: z.boolean().optional().describe('If true, the time parameter is treated as desired arrival time'),
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Search Connections', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ from, to, date, time, arrival_time, language }) => {
+    server.registerTool('search_connections', {
+        title: 'Search Connections',
+        description: 'Find train connections between two Swiss stations. Returns schedules with departure/arrival times, duration, transfers, and trip IDs for pricing.',
+        inputSchema: {
+            from: z.string().describe('Origin station name or ID (e.g. "Zurich HB" or "8503000")'),
+            to: z.string().describe('Destination station name or ID (e.g. "Bern" or "8507000")'),
+            date: z.string().optional().describe('Travel date in YYYY-MM-DD format (default: today)'),
+            time: z.string().optional().describe('Departure time in HH:MM format (default: now)'),
+            arrival_time: z.boolean().optional().describe('If true, the time parameter is treated as desired arrival time'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        _meta: widgetToolMeta(WIDGETS.CONNECTION_LIST, 'Finding trains…', 'Connections ready'),
+    }, async ({ from, to, date, time, arrival_time }) => {
         try {
-            const lang = effectiveLang(language, loadProfile());
             let fromId = from;
             let toId = to;
             if (!/^\d{5,8}$/.test(from)) {
                 const stations = useMock
                     ? await mockSearchPlaces({ name: from })
-                    : await searchPlaces({ name: from, type: 'STOP', numberOfResults: 1, lang });
+                    : await searchPlaces({ name: from, type: 'STOP', numberOfResults: 1 });
                 if (stations.length === 0) {
                     return { content: [{ type: 'text', text: `No station found matching "${from}". Try a different name.` }] };
                 }
@@ -227,7 +242,7 @@ export function createSbbMcpServer() {
             if (!/^\d{5,8}$/.test(to)) {
                 const stations = useMock
                     ? await mockSearchPlaces({ name: to })
-                    : await searchPlaces({ name: to, type: 'STOP', numberOfResults: 1, lang });
+                    : await searchPlaces({ name: to, type: 'STOP', numberOfResults: 1 });
                 if (stations.length === 0) {
                     return { content: [{ type: 'text', text: `No station found matching "${to}". Try a different name.` }] };
                 }
@@ -238,25 +253,12 @@ export function createSbbMcpServer() {
             if (date || time) {
                 const d = date || new Date().toISOString().split('T')[0];
                 const t = time || '08:00';
-                // Compute correct Europe/Zurich offset (CET +01:00 or CEST +02:00)
-                const probe = new Date(`${d}T${t}:00Z`);
-                const zurichStr = probe.toLocaleString('en-US', { timeZone: 'Europe/Zurich' });
-                const zurichTime = new Date(zurichStr + ' UTC');
-                const offsetMs = zurichTime.getTime() - probe.getTime();
-                const offsetHours = Math.round(offsetMs / (60 * 60 * 1000));
-                const offsetStr = `${offsetHours >= 0 ? '+' : '-'}${String(Math.abs(offsetHours)).padStart(2, '0')}:00`;
-                const dt = new Date(`${d}T${t}:00${offsetStr}`).toISOString();
-                if (arrival_time) {
+                const dt = zurichIso(d, t);
+                if (arrival_time)
                     arrivalTime = dt;
-                }
-                else {
+                else
                     departureTime = dt;
-                }
             }
-            const cacheKey = `connections:${fromId}:${toId}:${departureTime || ''}:${arrivalTime || ''}:${lang}`;
-            const cached = cacheGet(cacheKey);
-            if (cached)
-                return { content: [{ type: 'text', text: cached }] };
             const collection = useMock
                 ? await mockSearchTrips({ origin: fromId, destination: toId, departureTime })
                 : await searchTrips({
@@ -264,129 +266,149 @@ export function createSbbMcpServer() {
                     destination: toId,
                     ...(departureTime && { departureTime }),
                     ...(arrivalTime && { arrivalTime }),
-                    lang,
                 });
-            let text = formatConnections(collection, lang);
-            // Append destination weather if coordinates available
+            let text = formatConnections(collection);
+            let weatherSummary;
             if (collection.trips.length > 0) {
                 const dest = collection.trips[0].destination;
                 if (dest.geoPosition) {
                     const travelDate = date || new Date().toISOString().split('T')[0];
-                    text = await appendWeatherToConnections(text, dest.geoPosition.latitude, dest.geoPosition.longitude, travelDate, dest.name || to);
+                    const name = dest.name || to;
+                    try {
+                        const summary = await getWeatherSummary(dest.geoPosition.latitude, dest.geoPosition.longitude, travelDate);
+                        if (summary) {
+                            weatherSummary = summary;
+                            text = text + `\n\n**${name} weather:** ${summary}`;
+                        }
+                    }
+                    catch {
+                        // Non-fatal
+                    }
                 }
             }
-            cacheSet(cacheKey, text, TTL.CONNECTIONS);
-            return { content: [{ type: 'text', text }] };
+            return {
+                content: [{ type: 'text', text }],
+                structuredContent: toConnectionListDTO(collection, weatherSummary ? { summary: weatherSummary } : undefined),
+                _meta: widgetResponseMeta(WIDGETS.CONNECTION_LIST),
+            };
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // ─── Tool 3: get_trip_details ─────────────────────────────────────────
-    server.tool('get_trip_details', 'Get detailed information about a specific train connection including all intermediate stops, platforms, and occupancy. Use a trip ID from search_connections results.', {
-        trip_id: z.string().describe('Trip ID from search_connections results'),
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Get Trip Details', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ trip_id, language }) => {
+    server.registerTool('get_trip_details', {
+        title: 'Get Trip Details',
+        description: 'Get detailed information about a specific train connection including all intermediate stops, platforms, and occupancy. Use a trip ID from search_connections results.',
+        inputSchema: {
+            trip_id: z.string().describe('Trip ID from search_connections results'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        _meta: widgetToolMeta(WIDGETS.TRIP_DETAILS, 'Loading trip details…', 'Trip details ready'),
+    }, async ({ trip_id }) => {
         try {
-            const lang = effectiveLang(language, loadProfile());
             if (useMock) {
                 return { content: [{ type: 'text', text: 'Detailed trip information is available with live API access. In mock mode, use search_connections to see trip summaries.' }] };
             }
-            const cacheKey = `trip:${trip_id}:${lang}`;
-            const cached = cacheGet(cacheKey);
-            if (cached)
-                return { content: [{ type: 'text', text: cached }] };
-            const trip = await getTrip(trip_id, 'REAL_BOARDING_ALIGHTING', lang);
-            const text = formatTripDetails(trip, lang);
-            cacheSet(cacheKey, text, TTL.TRIP_DETAILS);
-            return { content: [{ type: 'text', text }] };
+            const trip = await getTrip(trip_id, 'REAL_BOARDING_ALIGHTING');
+            return {
+                content: [{ type: 'text', text: formatTripDetails(trip) }],
+                structuredContent: toTripDetailsDTO(trip),
+                _meta: widgetResponseMeta(WIDGETS.TRIP_DETAILS),
+            };
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // ─── Tool 4: get_more_connections ─────────────────────────────────────
-    server.tool('get_more_connections', 'Load earlier or later train connections for a previous search. Use the collection ID from search_connections results.', {
-        collection_id: z.string().describe('Collection ID from search_connections results'),
-        direction: z.enum(['next', 'previous']).describe('"next" for later trains, "previous" for earlier trains'),
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Get More Connections', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ collection_id, direction, language }) => {
+    server.registerTool('get_more_connections', {
+        title: 'Get More Connections',
+        description: 'Load earlier or later train connections for a previous search. Use the collection ID from search_connections results.',
+        inputSchema: {
+            collection_id: z.string().describe('Collection ID from search_connections results'),
+            direction: z.enum(['next', 'previous']).describe('"next" for later trains, "previous" for earlier trains'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        _meta: widgetToolMeta(WIDGETS.CONNECTION_LIST, 'Loading more trains…', 'More connections ready'),
+    }, async ({ collection_id, direction }) => {
         try {
-            const lang = effectiveLang(language, loadProfile());
-            if (useMock) {
-                const offset = direction === 'next' ? 3 * 60 * 60 * 1000 : -3 * 60 * 60 * 1000;
-                const baseTime = new Date(Date.now() + offset).toISOString();
-                const collection = await mockSearchTrips({ origin: '8503000', destination: '8507000', departureTime: baseTime });
-                return { content: [{ type: 'text', text: formatConnections(collection, lang) }] };
-            }
-            const collection = await paginateTrips(collection_id, direction, lang);
-            return { content: [{ type: 'text', text: formatConnections(collection, lang) }] };
+            const collection = useMock
+                ? await mockSearchTrips({
+                    origin: '8503000',
+                    destination: '8507000',
+                    departureTime: new Date(Date.now() + (direction === 'next' ? 3 : -3) * 60 * 60 * 1000).toISOString(),
+                })
+                : await paginateTrips(collection_id, direction);
+            return {
+                content: [{ type: 'text', text: formatConnections(collection) }],
+                structuredContent: toConnectionListDTO(collection),
+                _meta: widgetResponseMeta(WIDGETS.CONNECTION_LIST),
+            };
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // ─── Tool 5: get_prices ───────────────────────────────────────────────
-    server.tool('get_prices', 'Get ticket prices for one or more train connections. Supports Half-Fare card (Halbtax) and GA travelcard discounts. When connected to SwissTrip (SWISSTRIP_TOKEN), pass traveler_names to get family pricing for multiple travelers.', {
-        trip_ids: z.array(z.string()).min(1).max(10).describe('Trip IDs from search_connections results'),
-        traveler_type: z.enum(['ADULT', 'CHILD']).default('ADULT').describe('Traveler type (used when no traveler_names given)'),
-        reduction_card: z.enum(['HALF_FARE', 'GA', 'NONE']).default('HALF_FARE').describe('Swiss reduction card (used when no traveler_names given)'),
-        traveler_names: z.array(z.string()).optional().describe('Names of SwissTrip travelers to price for (e.g. ["Fabian", "Anna"]). Requires SWISSTRIP_TOKEN. Each traveler\'s reduction card is applied automatically.'),
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Get Prices', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ trip_ids, traveler_type, reduction_card, traveler_names, language }) => {
+    server.registerTool('get_prices', {
+        title: 'Get Prices',
+        description: 'Get ticket prices for one or more train connections. Supports Half-Fare card (Halbtax) and GA travelcard discounts. When connected to SwissTrip (SWISSTRIP_TOKEN), pass traveler_names to get family pricing for multiple travelers.',
+        inputSchema: {
+            trip_ids: z.array(z.string()).min(1).max(10).describe('Trip IDs from search_connections results'),
+            traveler_type: z.enum(['ADULT', 'CHILD']).default('ADULT').describe('Traveler type (used when no traveler_names given)'),
+            reduction_card: z.enum(['HALF_FARE', 'GA', 'NONE']).default('HALF_FARE').describe('Swiss reduction card (used when no traveler_names given)'),
+            traveler_names: z.array(z.string()).optional().describe('Names of SwissTrip travelers to price for (e.g. ["Fabian", "Anna"]). Requires SWISSTRIP_TOKEN. Each traveler\'s reduction card is applied automatically.'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        _meta: widgetToolMeta(WIDGETS.PRICES_TABLE, 'Fetching prices…', 'Prices ready'),
+    }, async ({ trip_ids, traveler_type, reduction_card, traveler_names }) => {
         try {
-            const lang = effectiveLang(language, loadProfile());
-            // Build travelers list — cloud multi-traveler or single manual
             let travelers;
-            let cacheKey;
             if (traveler_names && traveler_names.length > 0 && useCloud) {
-                // Fetch travelers from SwissTrip and match by name
                 const allTravelers = await fetchTravelers();
                 const matched = matchTravelersByName(allTravelers, traveler_names);
                 if (matched.length === 0) {
                     return { content: [{ type: 'text', text: `No matching travelers found. Available: ${allTravelers.map(t => t.first_name).filter(Boolean).join(', ')}. Use list_travelers to see all.` }] };
                 }
                 travelers = matched.map((t, i) => toSmapiTraveler(t, i));
-                cacheKey = `prices:${trip_ids.join(',')}:cloud:${matched.map(t => t.id).join(',')}:${lang}`;
             }
             else {
                 travelers = [{ id: 'traveler-1', type: traveler_type, reductionCard: reduction_card }];
-                cacheKey = `prices:${trip_ids.join(',')}:${traveler_type}:${reduction_card}:${lang}`;
             }
-            const cached = cacheGet(cacheKey);
-            if (cached)
-                return { content: [{ type: 'text', text: cached }] };
-            if (useMock) {
-                const prices = await mockGetTripPrices(trip_ids);
-                const text = formatPrices(prices, lang);
-                cacheSet(cacheKey, text, TTL.PRICES);
-                return { content: [{ type: 'text', text }] };
-            }
-            const prices = await getTripPrices(trip_ids, travelers, lang);
-            const text = formatPrices(prices, lang);
-            cacheSet(cacheKey, text, TTL.PRICES);
-            return { content: [{ type: 'text', text }] };
+            const prices = useMock
+                ? await mockGetTripPrices(trip_ids)
+                : await getTripPrices(trip_ids, travelers);
+            return {
+                content: [{ type: 'text', text: formatPrices(prices) }],
+                structuredContent: toPricesTableDTO(prices),
+                _meta: widgetResponseMeta(WIDGETS.PRICES_TABLE),
+            };
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // ─── Tool 6: get_ticket_link ──────────────────────────────────────────
-    server.tool('get_ticket_link', 'Get a direct purchase link to buy a train ticket on SBB.ch. Only call this when the user wants to buy a specific ticket. On mobile with SBB app installed, opens directly in the app with Halbtax/GA applied automatically. Pass traveler_names for family tickets when connected to SwissTrip.', {
-        trip_id: z.string().describe('Trip ID to purchase'),
-        from_name: z.string().describe('Origin station name (e.g. "Zürich HB")'),
-        from_id: z.string().describe('Origin station ID (e.g. "8503000")'),
-        to_name: z.string().describe('Destination station name (e.g. "Bern")'),
-        to_id: z.string().describe('Destination station ID (e.g. "8507000")'),
-        date: z.string().describe('Travel date YYYY-MM-DD'),
-        time: z.string().describe('Departure time HH:MM'),
-        traveler_type: z.enum(['ADULT', 'CHILD']).default('ADULT').describe('Traveler type (used when no traveler_names given)'),
-        reduction_card: z.enum(['HALF_FARE', 'GA', 'NONE']).default('HALF_FARE').describe('Swiss reduction card (used when no traveler_names given)'),
-        traveler_names: z.array(z.string()).optional().describe('SwissTrip traveler names for family tickets. Requires SWISSTRIP_TOKEN.'),
-        language: LANG_ENUM.optional().describe(LANG_DESC),
-    }, { title: 'Get Ticket Link', readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ trip_id, from_name, from_id, to_name, to_id, date, time, traveler_type, reduction_card, traveler_names, language }) => {
+    server.registerTool('get_ticket_link', {
+        title: 'Get Ticket Link',
+        description: 'Get a direct purchase link to buy a train ticket on SBB.ch. Only call this when the user wants to buy a specific ticket. On mobile with SBB app installed, opens directly in the app with Halbtax/GA applied automatically. Pass traveler_names for family tickets when connected to SwissTrip.',
+        inputSchema: {
+            trip_id: z.string().describe('Trip ID to purchase'),
+            from_name: z.string().describe('Origin station name (e.g. "Zürich HB")'),
+            from_id: z.string().describe('Origin station ID (e.g. "8503000")'),
+            to_name: z.string().describe('Destination station name (e.g. "Bern")'),
+            to_id: z.string().describe('Destination station ID (e.g. "8507000")'),
+            date: z.string().describe('Travel date YYYY-MM-DD'),
+            time: z.string().describe('Departure time HH:MM'),
+            traveler_type: z.enum(['ADULT', 'CHILD']).default('ADULT').describe('Traveler type (used when no traveler_names given)'),
+            reduction_card: z.enum(['HALF_FARE', 'GA', 'NONE']).default('HALF_FARE').describe('Swiss reduction card (used when no traveler_names given)'),
+            traveler_names: z.array(z.string()).optional().describe('SwissTrip traveler names for family tickets. Requires SWISSTRIP_TOKEN.'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+        _meta: widgetToolMeta(WIDGETS.TICKET_CARD, 'Preparing ticket link…', 'Ticket link ready'),
+    }, async ({ trip_id, from_name, from_id, to_name, to_id, date, time, traveler_type, reduction_card, traveler_names }) => {
         try {
-            const lang = effectiveLang(language, loadProfile());
             const sbbLink = buildSbbDeepLink({
                 fromName: from_name,
                 fromId: from_id,
@@ -394,9 +416,7 @@ export function createSbbMcpServer() {
                 toId: to_id,
                 date,
                 time,
-                lang,
             });
-            // Build travelers — cloud multi-traveler or single manual
             let travelers;
             if (traveler_names && traveler_names.length > 0 && useCloud) {
                 const allTravelers = await fetchTravelers();
@@ -408,18 +428,32 @@ export function createSbbMcpServer() {
             else {
                 travelers = [{ id: 'traveler-1', type: traveler_type, reductionCard: reduction_card }];
             }
-            // Try to get affiliate deep link from SMAPI (if live)
             let affiliateLink;
             if (!useMock) {
                 try {
-                    const result = await getTripOffers(trip_id, travelers, lang);
+                    const result = await getTripOffers(trip_id, travelers);
                     affiliateLink = result.affiliateDeepLink;
                 }
                 catch {
-                    // Affiliate link is optional — SBB direct link always works
+                    // Non-fatal
                 }
             }
-            return { content: [{ type: 'text', text: formatTicketLink(trip_id, affiliateLink, sbbLink, lang) }] };
+            const depIso = zurichIso(date, time);
+            return {
+                content: [{ type: 'text', text: formatTicketLink(trip_id, affiliateLink, sbbLink) }],
+                structuredContent: toTicketCardDTO({
+                    tripId: trip_id,
+                    fromName: from_name,
+                    fromId: from_id,
+                    toName: to_name,
+                    toId: to_id,
+                    departureTime: depIso,
+                    arrivalTime: depIso,
+                    primaryLink: sbbLink,
+                    affiliateLink,
+                }),
+                _meta: widgetResponseMeta(WIDGETS.TICKET_CARD),
+            };
         }
         catch (err) {
             return errorResult(err);