sbb-mcp 0.4.2 → 0.4.3

package/README.md

@@ -2,49 +2,36 @@
 
 [![npm version](https://img.shields.io/npm/v/sbb-mcp.svg)](https://www.npmjs.com/package/sbb-mcp)
 [![License: FSL-1.1-MIT](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](https://fsl.software/)
-[![smithery badge](https://smithery.ai/badge/fabsforward2-zhoi/sbb-mcp)](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
+[![smithery](https://smithery.ai/badge/fabsforward2-zhoi/sbb-mcp)](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
 
-MCP server for **Swiss Federal Railways** (SBB/CFF/FFS) -- real-time train schedules, prices, and ticket purchase links for any AI assistant.
+> **Swiss trains in any AI assistant.** Real-time schedules, ticket prices with Half-Fare/GA discounts, and direct purchase links for Claude Desktop, ChatGPT, Cursor, and any MCP-compatible client.
 
-Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, ChatGPT, and any MCP-compatible AI client.
+```
+You: trains from Bern to Zermatt tomorrow at 9am, with Halbtax
+AI:  IC 8 14:32 → 17:24 (2h52, 1 transfer in Visp, Pl. 8) — CHF 42.50
+     IC 8 15:02 → 17:54 (2h52, 1 transfer in Visp, Pl. 8) — CHF 42.50
+     [Buy on SBB.ch ↗]
+```
 
-## Features
+Ask any AI assistant to find Swiss trains. It returns connections, prices with your reduction card applied, and a direct ticket-purchase link to sbb.ch — all through natural language.
 
-- **Search stations** -- find any Swiss train station by name
-- **Train connections** -- real-time schedules with departure/arrival times, platforms, transfers
-- **Ticket prices** -- 1st/2nd class with Half-Fare (Halbtax) and GA travelcard support
-- **Purchase links** -- direct deep links to buy tickets on SBB.ch
-- **Pagination** -- browse earlier/later connections
-- **Trip details** -- intermediate stops, occupancy, platform changes
-- **Journey planning** -- built-in prompt for end-to-end trip planning
-- **Destination weather** -- automatic weather forecast for your destination (powered by [swiss-weather-mcp](https://www.npmjs.com/package/swiss-weather-mcp))
-- **Multi-traveler** -- family trip pricing when connected to SwissTrip (partner, kids, each with their own reduction card)
-- **Multilingual** -- output in 9 languages: de, fr, it, en, es, pt, ru, ar, zh (v0.4.0+)
-- **Rich widgets in ChatGPT** -- connection cards, trip timelines, price tables, and ticket cards via the OpenAI Apps SDK (v0.4.1+)
-- **Mock mode** -- works without credentials for testing and demos
+> **Not affiliated with SBB.** Independent, community-maintained MCP server built on SBB's public Swiss Mobility API (SMAPI). Not affiliated with or endorsed by SBB (Schweizerische Bundesbahnen).
 
-## Quick Start
+---
 
-### Claude Desktop
+## Quick install
 
-Add to your `claude_desktop_config.json`:
+### ChatGPT (no install — hosted)
 
-```json
-{
-  "mcpServers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
-    }
-  }
-}
-```
+ChatGPT Plus / Pro / Business / Enterprise with Developer Mode enabled:
+
+1. **Settings → Connectors** → enable **Developer Mode**
+2. Click **Add custom connector**
+3. **MCP Server URL:** `https://mcp.swisstrip.app/mcp`
+4. **Authentication:** None
+5. Save, then enable via the **+** button in the composer
+
+Tool responses render as native ChatGPT widgets (connection cards, trip timelines, price tables) via the OpenAI Apps SDK.
 
 ### Claude Code
 
@@ -52,288 +39,220 @@ Add to your `claude_desktop_config.json`:
 claude mcp add sbb -- npx -y sbb-mcp
 ```
 
-### Cursor
+Done — try `/mcp` in Claude to confirm it's loaded, then ask about Swiss trains.
 
-Add to `.cursor/mcp.json`:
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
 
 ```json
 {
   "mcpServers": {
     "sbb": {
       "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
+      "args": ["-y", "sbb-mcp"]
     }
   }
 }
 ```
 
-### Windsurf
+Restart Claude Desktop. That's it — works in **mock mode** out of the box with realistic Swiss station data. Add credentials later for live SBB data (see below).
 
-Add to `~/.codeium/windsurf/mcp_config.json`:
+### Cursor / Windsurf / VS Code Copilot
 
-```json
-{
-  "mcpServers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
-    }
-  }
-}
+Same `mcpServers` block as Claude Desktop, in the respective config file:
+
+| Client | Config path |
+|---|---|
+| Cursor | `.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| VS Code Copilot | `.vscode/mcp.json` (use top-level `servers` instead of `mcpServers`) |
+
+### Try it without installing
+
+```bash
+npx sbb-mcp
 ```
 
-### VS Code Copilot
+Runs in mock mode with realistic Swiss station data — no setup, no credentials. Useful for testing the protocol or building demos.
+
+---
+
+## Live SBB data (optional)
+
+Mock mode works out of the box. For real-time schedules and prices, get credentials from the [SBB Developer Portal](https://developer.sbb.ch) (free signup, OAuth 2.0 + business contract).
 
-Add to `.vscode/mcp.json`:
+Add to your config's `env` block:
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "sbb": {
       "command": "npx",
       "args": ["-y", "sbb-mcp"],
       "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
+        "SMAPI_JOURNEY_CLIENT_ID": "...",
+        "SMAPI_JOURNEY_CLIENT_SECRET": "...",
+        "SMAPI_JOURNEY_SCOPE": "api://.../.default",
+        "SMAPI_TICKETING_CLIENT_ID": "...",
+        "SMAPI_TICKETING_CLIENT_SECRET": "...",
+        "SMAPI_TICKETING_SCOPE": "api://.../.default",
+        "SMAPI_CONTRACT_ID": "..."
       }
     }
   }
 }
 ```
 
-### Smithery
+SBB issues separate AAD apps per API. The Journey API is for schedules/stations; the Ticketing API for prices/booking links. Set whichever you have approved — the server falls back to mock data per family if a credential set is missing.
 
-Install via [Smithery](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp):
+For backwards compatibility, single-app setups can use the generic `SMAPI_CLIENT_ID` / `SMAPI_CLIENT_SECRET` / `SMAPI_SCOPE` for both APIs.
 
-```bash
-npx @smithery/cli mcp add fabsforward2-zhoi/sbb-mcp
-```
+---
 
-### Demo Mode (No Credentials)
+## What it does
 
-Run without any environment variables to use mock data:
+- **Search stations** — find any Swiss train station by name, get UIC IDs
+- **Train connections** — schedules with departure/arrival times, platforms, transfer info, occupancy forecasts
+- **Ticket prices** — 1st/2nd class with Half-Fare (Halbtax) and GA travelcard support
+- **Purchase links** — direct deep links to buy on SBB.ch (opens the SBB app on mobile with discounts applied)
+- **Pagination** — browse earlier/later connections without losing context
+- **Trip details** — intermediate stops, platforms, real-time status
+- **Destination weather** — auto-included in connection results via [`swiss-weather-mcp`](https://www.npmjs.com/package/swiss-weather-mcp)
+- **Multilingual** — output in 9 languages (`de fr it en es pt ru ar zh`)
+- **ChatGPT widgets** — connection cards, price tables, ticket cards rendered as native UI via OpenAI Apps SDK
+- **Mock mode** — full demo data without credentials
 
-```bash
-npx sbb-mcp
-```
+---
 
-This lets you test the MCP server with realistic Swiss station data without SBB API credentials.
+## Tools
 
-## Multilingual output (v0.4.0+)
+9 MCP tools, all support an optional `language` argument.
 
-Every tool accepts an optional `language` argument — one of `de`, `fr`, `it`, `en`, `es`, `pt`, `ru`, `ar`, `zh`. This controls the output language for labels, date/time formatting, and the ticket-buy button text. It also sets the `Accept-Language` header on SBB API calls so station names come back in the requested language where the SBB API supports it (de/fr/it/en).
+| Tool | What it does |
+|---|---|
+| `search_stations` | Find stations by name → UIC IDs |
+| `search_connections` | Schedules between two stations (returns trip IDs) |
+| `get_trip_details` | Stop-by-stop info, platforms, occupancy |
+| `get_more_connections` | Earlier/later trains via pagination |
+| `get_prices` | Ticket prices with reduction card applied |
+| `get_ticket_link` | Direct purchase link to SBB.ch (mobile-app deep link) |
+| `save_profile` | Save user's reduction card + DOB locally for auto-apply |
+| `get_profile` | Read saved profile |
+| `list_travelers` | Multi-traveler family pricing (requires SwissTrip account) |
 
-Resolution order: `language` arg → saved profile language (`save_profile`) → English.
+Plus a `plan_journey` prompt for end-to-end trip planning.
 
-```jsonc
-// Example: French output
-{ "from": "Zurich HB", "to": "Bern", "language": "fr" }
-```
+### Multilingual
 
-The SBB deep link path uses `de/fr/it/en` where supported and falls back to `en` for other languages (SBB.ch serves those four).
-
-Save a default language once per user:
+Every tool accepts `language: "de" | "fr" | "it" | "en" | "es" | "pt" | "ru" | "ar" | "zh"`. Sets `Accept-Language` on SBB API calls so station names come back in the requested language; localizes the buy-button text on deep links.
 
 ```jsonc
-{ "tool": "save_profile", "language": "de" }
+// French output
+{ "from": "Zürich HB", "to": "Genève", "language": "fr" }
 ```
 
-## Tools
-
-### search_stations
-
-Search for Swiss train stations by name. Returns station IDs needed for other tools.
-
-**Input:**
-- `query` (string, required) -- Station name, e.g. "Zurich", "Bern", "Interlaken"
-- `limit` (number, optional) -- Max results (default: 10)
-
-**Example:** "Find stations matching Luzern"
-
-### search_connections
-
-Find train connections between two stations. Automatically resolves station names to IDs.
-
-**Input:**
-- `from` (string, required) -- Origin station name or ID (e.g. "Zurich HB" or "8503000")
-- `to` (string, required) -- Destination station name or ID
-- `date` (string, optional) -- Travel date YYYY-MM-DD
-- `time` (string, optional) -- Departure time HH:MM
-- `arrival_time` (boolean, optional) -- Treat time as arrival time
-
-**Example:** "Show me trains from Zurich to Bern tomorrow at 9am"
-
-Results automatically include destination weather when coordinates are available (e.g. **Bern weather:** 6-18°C, mostly sunny, 10% rain).
-
-### get_trip_details
-
-Get detailed stop-by-stop information for a connection including intermediate stops, platforms, and occupancy forecasts.
-
-**Input:**
-- `trip_id` (string, required) -- Trip ID from search_connections
-
-### get_more_connections
-
-Load earlier or later trains for a previous search.
-
-**Input:**
-- `collection_id` (string, required) -- Collection ID from search_connections
-- `direction` ("next" | "previous") -- Later or earlier trains
-
-### get_prices
-
-Get ticket prices with Swiss reduction card support. Supports multi-traveler family pricing when connected to SwissTrip.
-
-**Input:**
-- `trip_ids` (string[], required) -- Trip IDs from search_connections
-- `traveler_type` ("ADULT" | "CHILD", default: "ADULT") -- used when no traveler_names given
-- `reduction_card` ("HALF_FARE" | "GA" | "NONE", default: "HALF_FARE") -- used when no traveler_names given
-- `traveler_names` (string[], optional) -- SwissTrip traveler names for family pricing (requires `SWISSTRIP_TOKEN`)
-
-**Example:** "How much for Zurich to Zermatt for Fabian and Anna?" (with SwissTrip connected, each traveler's reduction card is applied automatically)
-
-### get_ticket_link
-
-Get a direct purchase link to buy the ticket on SBB.ch. On mobile with the SBB app installed, opens directly in the app with Halbtax/GA applied automatically. Supports multi-traveler tickets when connected to SwissTrip.
-
-**Input:**
-- `trip_id` (string, required) -- Trip ID to purchase
-- `from_name` (string, required) -- Origin station name
-- `from_id` (string, required) -- Origin station ID
-- `to_name` (string, required) -- Destination station name
-- `to_id` (string, required) -- Destination station ID
-- `date` (string, required) -- Travel date YYYY-MM-DD
-- `time` (string, required) -- Departure time HH:MM
-- `traveler_type` ("ADULT" | "CHILD", default: "ADULT") -- used when no traveler_names given
-- `reduction_card` ("HALF_FARE" | "GA" | "NONE", default: "HALF_FARE") -- used when no traveler_names given
-- `traveler_names` (string[], optional) -- SwissTrip traveler names for family tickets (requires `SWISSTRIP_TOKEN`)
-
-### list_travelers
-
-List all travelers in the user's SwissTrip account (self, partner, kids). Each traveler has their own reduction card. Requires `SWISSTRIP_TOKEN`.
+Save a default once via `save_profile` — subsequent calls use it automatically.
 
-**Example:** "Who are my travelers?" → shows all saved travelers with their reduction cards
+---
 
-## Prompts
+## Hosted MCP endpoint
 
-### plan_journey
+A public HTTPS endpoint is live at `https://mcp.swisstrip.app/mcp` for clients that prefer remote MCP over local stdio (ChatGPT, Claude Pro remote MCPs, etc.). Same tools, plus rich widgets for ChatGPT.
 
-End-to-end journey planning prompt. Searches connections, compares prices, and provides ticket links.
+```bash
+# Test from your terminal
+curl -X POST https://mcp.swisstrip.app/mcp \
+  -H 'Content-Type: application/json' \
+  -H 'Accept: application/json, text/event-stream' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
+```
 
-**Input:**
-- `from` (string, required) -- Origin station
-- `to` (string, required) -- Destination station
-- `date` (string, optional) -- Travel date
+---
 
-## Environment Variables
+## Environment variables
 
 | Variable | Required | Description |
-|----------|----------|-------------|
-| `SMAPI_CLIENT_ID` | Yes* | OAuth 2.0 client ID from SBB Developer Portal |
-| `SMAPI_CLIENT_SECRET` | Yes* | OAuth 2.0 client secret |
-| `SMAPI_SCOPE` | Yes* | OAuth scope |
-| `SMAPI_CONTRACT_ID` | Yes* | SBB business contract ID |
-| `SMAPI_ENV` | No | `int` (default) or `prod` |
-| `SMAPI_TENANT_ID` | No | Azure AD tenant (defaults to SBB tenant) |
-| `SWISSTRIP_TOKEN` | No | SwissTrip auth token for cloud profiles and multi-traveler support |
-| `SWISSTRIP_URL` | No | SwissTrip API base URL (defaults to `https://swisstrip.ch`) |
+|---|---|---|
+| `SMAPI_JOURNEY_CLIENT_ID` / `_CLIENT_SECRET` / `_SCOPE` | For schedules + stations | OAuth credentials for SBB Journey API |
+| `SMAPI_TICKETING_CLIENT_ID` / `_CLIENT_SECRET` / `_SCOPE` | For prices + booking links | OAuth credentials for SBB Ticketing API (b2p) |
+| `SMAPI_CLIENT_ID` / `_CLIENT_SECRET` / `_SCOPE` | Fallback | Single-app credentials, used for any family without specific vars |
+| `SMAPI_CONTRACT_ID` | With any creds | SBB partner contract identifier |
+| `SMAPI_ENV` | No | `int` (default) \| `prod` \| `mock` |
+| `SMAPI_TENANT_ID` | No | Azure AD tenant override (defaults to SBB's) |
+| `SWISSTRIP_TOKEN` | No | SwissTrip account token for cloud-synced multi-traveler profiles |
 
-*Without SMAPI credentials, the server runs in mock mode with realistic demo data.
+Without any SMAPI credentials → mock mode (realistic demo data).
 
-## SwissTrip Integration (Optional)
+---
 
-Set `SWISSTRIP_TOKEN` to connect sbb-mcp to your [SwissTrip](https://swisstrip.ch) account. This enables:
+## SwissTrip integration (optional)
 
-- **Cloud-synced profiles** -- your travel profile (name, DOB, reduction card) syncs from SwissTrip instead of local `~/.sbb-mcp/profile.json`
-- **Multi-traveler pricing** -- add your partner, kids, or travel companions on SwissTrip and get per-person pricing with correct reduction cards
-- **Family tickets** -- pass `traveler_names` to `get_prices` and `get_ticket_link` for group pricing
+Connect your [SwissTrip](https://swisstrip.app) account via `SWISSTRIP_TOKEN` to enable:
 
-```json
-{
-  "mcpServers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SWISSTRIP_TOKEN": "your-swisstrip-auth-token"
-      }
-    }
-  }
-}
-```
+- Cloud-synced travel profile (name, DOB, reduction card) instead of local file
+- Multi-traveler family pricing (partner, kids, each with their own card)
+- Mint a token at https://swisstrip.app/settings/developer
 
-Without `SWISSTRIP_TOKEN`, sbb-mcp uses local file-based profiles as before -- no SwissTrip account required.
+---
 
-## Available on
+## Available everywhere
 
 - [npm](https://www.npmjs.com/package/sbb-mcp)
 - [Official MCP Registry](https://registry.modelcontextprotocol.io)
 - [Smithery](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
+- [PulseMCP](https://www.pulsemcp.com/servers/fabsbags-sbb)
+- [LobeHub](https://lobehub.com/mcp)
+- ChatGPT custom connector at `https://mcp.swisstrip.app/mcp`
+
+Also published under alias names that all forward to `sbb-mcp`: [swiss-rail-mcp](https://www.npmjs.com/package/swiss-rail-mcp), [sbb-cff-ffs-mcp](https://www.npmjs.com/package/sbb-cff-ffs-mcp), [swiss-train-mcp](https://www.npmjs.com/package/swiss-train-mcp), [swiss-railways-mcp](https://www.npmjs.com/package/swiss-railways-mcp).
 
-Also available as: [sbb-mcp-official](https://www.npmjs.com/package/sbb-mcp-official) | [swiss-rail-mcp](https://www.npmjs.com/package/swiss-rail-mcp) | [sbb-cff-ffs-mcp](https://www.npmjs.com/package/sbb-cff-ffs-mcp) | [swiss-train-mcp](https://www.npmjs.com/package/swiss-train-mcp) | [swiss-railways-mcp](https://www.npmjs.com/package/swiss-railways-mcp)
+---
 
 ## About
 
-Built on the official SBB Swiss Mobility API (SMAPI) with OSDM-compliant journey planning and pricing. Covers the entire Swiss public transport network including SBB, BLS, SOB, and regional operators. Weather data powered by [swiss-weather-mcp](https://www.npmjs.com/package/swiss-weather-mcp) (MeteoSwiss + Open-Meteo).
+Built on SBB's commercial Swiss Mobility API (SMAPI) with OSDM-compliant journey planning and Azure AD OAuth. Covers SBB plus regional operators (BLS, SOB, MOB, RhB, etc.) — the entire Swiss public transport network with 10,000+ daily connections.
 
-**SBB** (Schweizerische Bundesbahnen) / **CFF** (Chemins de fer federaux suisses) / **FFS** (Ferrovie federali svizzere) -- Swiss Federal Railways operates one of the densest rail networks in the world with over 10,000 daily connections.
+Weather data via [`swiss-weather-mcp`](https://www.npmjs.com/package/swiss-weather-mcp) (MeteoSwiss + Open-Meteo).
 
-## ChatGPT (custom connector)
+Repository: [Fabsbags/swisstrip-web](https://github.com/Fabsbags/swisstrip-web/tree/main/packages/sbb-mcp). Issues: [tracker](https://github.com/Fabsbags/swisstrip-web/issues).
 
-A hosted HTTPS endpoint is available at `https://mcp.swisstrip.app/mcp` for use as a custom connector in ChatGPT (requires Plus/Pro/Business/Enterprise with Developer Mode enabled).
+**SBB** (Schweizerische Bundesbahnen) / **CFF** (Chemins de fer fédéraux suisses) / **FFS** (Ferrovie federali svizzere) — Swiss Federal Railways.
 
-1. ChatGPT → **Settings → Connectors** → enable **Developer Mode**
-2. Click **Add custom connector**
-3. **MCP Server URL:** `https://mcp.swisstrip.app/mcp`
-4. **Authentication:** None
-5. Save, then enable the connector via the **+** button in the composer
+---
+
+## License
 
-Tool responses render as interactive widgets (connection cards, trip details, price tables, ticket cards) using the OpenAI Apps SDK.
+[FSL-1.1-MIT](https://fsl.software/) — Functional Source License. Free for any non-competing purpose. Converts to MIT after 2 years. See [LICENSE](LICENSE).
+
+---
 
 ## Changelog
 
+### v0.4.3 — README polish
+
+Launch-focused README rewrite: install-first structure, ChatGPT custom connector promoted to top, mock-mode-by-default messaging, 9-tool reference table, per-family SBB credential env vars documented. No runtime changes — `sbb-mcp@0.4.2` behavior is identical to `0.4.3`.
+
 ### v0.4.2 — Repository metadata
 
-- Point `repository`, `homepage`, and `bugs` fields at the monorepo source of truth (`Fabsbags/swisstrip-web`, directory `packages/sbb-mcp`) so npm and MCP registries link to the active code. No runtime or API changes.
+Point `repository`, `homepage`, and `bugs` at the monorepo source of truth. No runtime changes.
 
 ### v0.4.1 — Apps SDK widgets
 
-- Five Preact widgets registered as `ui://widget/*.html` resources: stations list, connection list, trip details, prices table, ticket card.
-- Tool responses now include `structuredContent` + `_meta["openai/outputTemplate"]` so ChatGPT renders rich UI instead of plain markdown.
-- Hosted endpoint live at `https://mcp.swisstrip.app/mcp` for use as a ChatGPT custom connector.
-- Widget bundle built separately via Vite under `web/` (single IIFE, inlined CSS, ~25 KB total).
-- Server rendering is unchanged for non-Apps-SDK clients (Claude Desktop, Cursor, etc.) — they see the same markdown output as before.
+- Five Preact widgets registered as `ui://widget/*.html` resources: stations list, connection list, trip details, prices table, ticket card
+- Tool responses include `structuredContent` + `_meta["openai/outputTemplate"]` so ChatGPT renders rich UI
+- Hosted endpoint live at `https://mcp.swisstrip.app/mcp` for use as a ChatGPT custom connector
+- Widget bundle ~25KB (single IIFE, inlined CSS) built via Vite under `web/`
+- Server rendering unchanged for stdio clients
 
 ### v0.4.0 — Multilingual
 
-- Every tool now accepts an optional `language` parameter (`de | fr | it | en | es | pt | ru | ar | zh`).
-- Labels, date/time formatting, and the SBB ticket-buy button text are translated.
-- `Accept-Language` is passed to SBB SMAPI so station names come back in the requested language where supported (de/fr/it/en).
-- `save_profile` stores a preferred language; later tool calls default to it when `language` is omitted.
-- **Breaking:** default output locale with no profile and no tool arg is now `en` (was implicitly `de-CH`). Set a profile or pass `language: 'de'` to restore the old behavior.
-- Translations shared with the WhatsApp/Telegram bots via the new [`sbb-i18n`](https://www.npmjs.com/package/sbb-i18n) package.
+- Optional `language` argument on every tool (9 languages)
+- `Accept-Language` passed to SBB SMAPI for localized station names
+- `save_profile` stores preferred language as default
+- **Breaking:** default output locale with no profile is now `en` (was `de-CH`). Set a profile or pass `language: 'de'` to restore previous behavior.
+- Translations shared with WhatsApp/Telegram bots via [`sbb-i18n`](https://www.npmjs.com/package/sbb-i18n)
 
 ### v0.3.0 — Destination weather
 
-- Automatic weather forecast appended to `search_connections` results via [`swiss-weather-mcp`](https://www.npmjs.com/package/swiss-weather-mcp).
-
-## License
-
-[FSL-1.1-MIT](https://fsl.software/) -- Functional Source License. Free to use for any non-competing purpose. Converts to MIT after 2 years. See [LICENSE](LICENSE) for details.
+Auto-include weather forecast in `search_connections` results via [`swiss-weather-mcp`](https://www.npmjs.com/package/swiss-weather-mcp).

package/dist/cache.d.ts

@@ -10,3 +10,5 @@ export declare const TTL: {
     readonly PRICES: number;
     readonly TRIP_DETAILS: number;
 };
+/** Test-only: clear all entries. No effect in production. */
+export declare function __clearCacheForTesting(): void;

package/dist/cache.js

@@ -55,4 +55,8 @@ export const TTL = {
     PRICES: 2 * 60 * 1000, // 2 minutes
     TRIP_DETAILS: 5 * 60 * 1000, // 5 minutes
 };
+/** Test-only: clear all entries. No effect in production. */
+export function __clearCacheForTesting() {
+    store.clear();
+}
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAA;AAEpD,MAAM,WAAW,GAAG,KAAK,CAAA;AAEzB,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjB,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,wDAAwD;IACxD,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,OAAO,IAAI,KAAK;YAAE,MAAK;QAC3B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjB,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,GAAW;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,qDAAqD;IACrD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACjB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACrB,OAAO,KAAK,CAAC,IAAS,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,GAAW,EAAE,IAAO,EAAE,KAAa;IAC7D,IAAI,KAAK,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,YAAY,EAAE,CAAA;QAC9B,0DAA0D;QAC1D,IAAI,OAAO,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,OAAO;AACP,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAK,WAAW;IAC7C,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAS,YAAY;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAc,YAAY;IAC/C,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAQ,YAAY;CACvC,CAAA"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAA;AAEpD,MAAM,WAAW,GAAG,KAAK,CAAA;AAEzB,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjB,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,wDAAwD;IACxD,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,OAAO,IAAI,KAAK;YAAE,MAAK;QAC3B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjB,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,GAAW;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,qDAAqD;IACrD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACjB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACrB,OAAO,KAAK,CAAC,IAAS,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,GAAW,EAAE,IAAO,EAAE,KAAa;IAC7D,IAAI,KAAK,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,YAAY,EAAE,CAAA;QAC9B,0DAA0D;QAC1D,IAAI,OAAO,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,OAAO;AACP,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAK,WAAW;IAC7C,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAS,YAAY;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAc,YAAY;IAC/C,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAQ,YAAY;CACvC,CAAA;AAEV,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB;IACpC,KAAK,CAAC,KAAK,EAAE,CAAA;AACf,CAAC"}

package/dist/formatters.d.ts

@@ -1,5 +1,18 @@
 import type { SmapiPlace, SmapiTrip, SmapiTripsCollection, SmapiPriceResult } from './transport/smapi-types.js';
 import type { Lang } from './i18n.js';
+/**
+ * Terse one-line summary used when the client renders the Apps SDK widget
+ * (see `isWidgetRenderingClient`). Widget clients already show a full card
+ * list — returning the long markdown table here just causes the LLM to
+ * paraphrase it into a redundant narration right next to the iframe. The
+ * structured content still carries all the data the model needs to answer
+ * follow-up questions; this string is purely for the chat bubble above the
+ * widget.
+ */
+export declare function formatStationsTerse(stations: SmapiPlace[], _lang?: Lang): string;
+export declare function formatConnectionsTerse(collection: SmapiTripsCollection, lang?: Lang): string;
+export declare function formatTripDetailsTerse(trip: SmapiTrip, lang?: Lang): string;
+export declare function formatPricesTerse(results: SmapiPriceResult[], lang?: Lang): string;
 export declare function formatStations(stations: SmapiPlace[], lang?: Lang): string;
 export declare function formatConnections(collection: SmapiTripsCollection, lang?: Lang): string;
 export declare function formatTripDetails(trip: SmapiTrip, lang?: Lang): string;