@claudinho/mcp 0.8.19 → 0.9.1

package/dist/index.js

@@ -385,7 +385,8 @@ function normalizeLang(lang) {
 }
 function t(lang, key, vars) {
   const dict = CATALOGS[normalizeLang(lang)];
-  let s = dict[key] ?? EN[key] ?? key;
+  const en = EN;
+  let s = dict[key] ?? en[key] ?? key;
   if (vars) {
     for (const [k, v] of Object.entries(vars)) s = s.replaceAll(`{${k}}`, v);
   }
@@ -2907,11 +2908,27 @@ function rosterAtZero(matches) {
 var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = "fifa.world";
 var DEFAULT_BASE = `${ESPN_SOCCER}/${DEFAULT_COMPETITION}`;
-var USER_AGENT = "claudinho/0.0 (+https://github.com/arturogarrido/claudinho)";
+var USER_AGENT = `claudinho/${"0.9.1"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
 }
+var DEFAULT_TIMEOUT_MS = 6e3;
+var STANDINGS_SHARE_MS = 3e4;
+var ProviderError = class extends Error {
+  kind;
+  status;
+  constructor(message, kind, status) {
+    super(message);
+    this.name = "ProviderError";
+    this.kind = kind;
+    this.status = status;
+  }
+  /** 429/403 — the upstream is refusing us; retrying at the live cadence makes it worse. */
+  get throttled() {
+    return this.kind === "http" && (this.status === 429 || this.status === 403);
+  }
+};
 function mapStatus(st) {
   const name = (st?.type?.name ?? "").toUpperCase();
   const state = st?.type?.state ?? "";
@@ -3053,6 +3070,20 @@ var EspnAdapter = class {
   capabilities = { push: false, latencyHintSec: 45 };
   /** Cached team-code -> group-letter map (built lazily from standings). */
   groupMap;
+  /**
+   * One in-flight/recent standings fetch shared by fetchStandings and
+   * fetchGroupMap, so a command like `bracket` hits the endpoint once instead
+   * of twice, and a long-lived MCP server stays fresh (short TTL). A rejected
+   * fetch clears the slot — a transient failure is never cached.
+   */
+  standingsShared;
+  /**
+   * The most recent request failure (best-effort under concurrency; cleared
+   * when a new request starts). A post-hoc hint for callers whose result path
+   * fails closed to `degraded` booleans but who still need to distinguish a
+   * throttle (persist a backoff) from an ordinary blip.
+   */
+  lastError;
   async fetchByDate(dateISO) {
     return this.fetchScoreboard(toEspnDate(dateISO));
   }
@@ -3074,37 +3105,58 @@ var EspnAdapter = class {
     const base = this.opts.baseUrl ?? DEFAULT_BASE;
     return `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
   }
+  /** The shared standings fetch (see {@link standingsShared}). */
+  sharedStandings() {
+    const now = Date.now();
+    if (this.standingsShared && now - this.standingsShared.at < STANDINGS_SHARE_MS) {
+      return this.standingsShared.promise;
+    }
+    const promise = this.get(this.standingsUrl()).then(
+      (d) => parseStandings(d)
+    );
+    this.standingsShared = { at: now, promise };
+    promise.catch(() => {
+      if (this.standingsShared?.promise === promise) this.standingsShared = void 0;
+    });
+    return promise;
+  }
   /**
    * Authoritative, cumulative group tables from the standings endpoint. Throws
    * on fetch/parse failure (the caller decides the fallback). Group-stage only:
    * non-group `children` are filtered out by {@link parseStandings}.
    */
   async fetchStandings() {
-    return parseStandings(await this.get(this.standingsUrl()));
+    return this.sharedStandings();
   }
   /**
    * Build (and cache) a team-code -> group-letter map from the standings
-   * endpoint. Best-effort: returns {} if standings are unavailable. Reuses the
-   * same parse as {@link fetchStandings}, so the two never drift.
+   * endpoint. Best-effort: returns {} if standings are unavailable — but a
+   * transient failure is NOT cached (only a successful parse pins the map), so
+   * one blip can't silently drop group letters for the adapter's lifetime.
+   * Reuses the same parse/fetch as {@link fetchStandings}, so the two never
+   * drift and one command never fetches standings twice.
    */
   async fetchGroupMap(force = false) {
     if (this.groupMap && !force) return this.groupMap;
-    const map = {};
     try {
-      const tables = parseStandings(await this.get(this.standingsUrl()));
+      const tables = await this.sharedStandings();
+      const map = {};
       for (const t2 of tables) for (const r of t2.rows) map[r.team.code] = t2.group;
+      this.groupMap = map;
+      return map;
     } catch {
+      return {};
     }
-    this.groupMap = map;
-    return map;
   }
   async fetchScoreboard(dates) {
     const base = this.opts.baseUrl ?? DEFAULT_BASE;
     const url = new URL(`${base}/scoreboard`);
     url.searchParams.set("limit", "300");
     if (dates) url.searchParams.set("dates", dates);
-    const groupByTeam = this.opts.enrichGroups === false ? {} : await this.fetchGroupMap();
-    const data = await this.get(url.toString());
+    const [groupByTeam, data] = await Promise.all([
+      this.opts.enrichGroups === false ? Promise.resolve({}) : this.fetchGroupMap(),
+      this.get(url.toString())
+    ]);
     return (data.events ?? []).map((ev) => mapEspnEvent(ev, { groupByTeam }));
   }
   async get(url) {
@@ -3112,24 +3164,51 @@ var EspnAdapter = class {
     const controller = new AbortController();
     const timer = setTimeout(
       () => controller.abort(),
-      this.opts.timeoutMs ?? 15e3
+      this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS
     );
+    this.lastError = void 0;
     try {
-      const res = await doFetch(url, {
-        signal: controller.signal,
-        // ESPN never legitimately redirects; following one would sidestep the
-        // fixed-host guarantee, so treat any redirect as a failure (degraded).
-        redirect: "error",
-        headers: { Accept: "application/json", "User-Agent": USER_AGENT }
-      });
+      let res;
+      try {
+        res = await doFetch(url, {
+          signal: controller.signal,
+          // ESPN never legitimately redirects; following one would sidestep the
+          // fixed-host guarantee, so treat any redirect as a failure (degraded).
+          redirect: "error",
+          headers: { Accept: "application/json", "User-Agent": USER_AGENT }
+        });
+      } catch (e) {
+        throw e?.name === "AbortError" ? new ProviderError(`ESPN request timed out: ${url}`, "timeout") : new ProviderError(`ESPN request failed: ${e?.message ?? e}`, "http");
+      }
       if (!res.ok) {
-        throw new Error(`ESPN request failed: ${res.status} ${res.statusText}`);
+        throw new ProviderError(
+          `ESPN request failed: ${res.status} ${res.statusText}`,
+          "http",
+          res.status
+        );
       }
       const length = Number(res.headers?.get?.("content-length"));
       if (Number.isFinite(length) && length > MAX_RESPONSE_BYTES) {
-        throw new Error(`ESPN response too large: ${length} bytes`);
+        throw new ProviderError(`ESPN response too large: ${length} bytes`, "parse");
+      }
+      try {
+        return await res.json();
+      } catch (e) {
+        throw new ProviderError(
+          `ESPN response unparseable: ${e?.message ?? e}`,
+          "parse"
+        );
+      }
+    } catch (e) {
+      const pe = e instanceof ProviderError ? e : new ProviderError(String(e?.message ?? e), "http");
+      this.lastError = pe;
+      if (typeof process !== "undefined" && process.env?.CLAUDINHO_DEBUG) {
+        process.stderr.write(
+          `claudinho: espn ${pe.kind}${pe.status ? ` ${pe.status}` : ""}: ${url}
+`
+        );
       }
-      return await res.json();
+      throw pe;
     } finally {
       clearTimeout(timer);
     }
@@ -3853,13 +3932,18 @@ function resolveCompetition(explicit) {
   }
   return DEFAULT_COMPETITION;
 }
+var KNOWN_SOURCES = ["espn"];
 function makeAdapter(source = "espn") {
   switch (source) {
-    default: {
+    case "espn": {
       const competition = resolveCompetition();
       const baseUrl = competition === DEFAULT_COMPETITION ? void 0 : competitionBase(competition);
       return new EspnAdapter({ baseUrl });
     }
+    default:
+      throw new Error(
+        `Unknown data source "${source}" (available: ${KNOWN_SOURCES.join(", ")})`
+      );
   }
 }
 function mergeLive(base, live) {
@@ -3897,8 +3981,16 @@ async function getStandings(adapter, group) {
   const tables = letters.map((g) => ({ group: g, rows: rosterAtZero(fixturesByGroup(g)) })).filter((t2) => t2.rows.length > 0);
   return { tables, degraded: true };
 }
-var KNOCKOUT_WINDOW_START = "20260628";
-var KNOCKOUT_WINDOW_END = "20260719";
+var knockoutWindowMemo;
+function knockoutWindow() {
+  if (knockoutWindowMemo !== void 0) return knockoutWindowMemo;
+  const days = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY").map((m) => m.kickoff.slice(0, 10).replace(/-/g, "")).filter((d) => d.length === 8);
+  knockoutWindowMemo = days.length ? {
+    start: days.reduce((a, b) => a < b ? a : b),
+    end: days.reduce((a, b) => a > b ? a : b)
+  } : null;
+  return knockoutWindowMemo;
+}
 async function getBracket(adapter, opts = {}) {
   const topology = loadBracketTopology();
   const base = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY");
@@ -3906,7 +3998,8 @@ async function getBracket(adapter, opts = {}) {
   let liveDegraded = true;
   let source;
   try {
-    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    const win = knockoutWindow();
+    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
     matches = mergeLive(base, live);
     liveDegraded = false;
     source = adapter.name;
@@ -3939,8 +4032,9 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   let fixtures = allFixtures();
   let overlayFailed = false;
   try {
-    if (adapter.fetchWindow) {
-      fixtures = mergeLive(fixtures, await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END));
+    const win = knockoutWindow();
+    if (adapter.fetchWindow && win) {
+      fixtures = mergeLive(fixtures, await adapter.fetchWindow(win.start, win.end));
     }
   } catch {
     overlayFailed = true;
@@ -3963,7 +4057,8 @@ async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Da
   let degraded = true;
   let liveById;
   try {
-    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    const win = knockoutWindow();
+    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
     matches = mergeLive(base, live);
     degraded = false;
     liveById = new Set(live.map((m) => m.id));
@@ -4211,7 +4306,7 @@ var mapping_2026_default = {
 var DEFAULT_BASE2 = "https://gamma-api.polymarket.com";
 var ALLOWED_HOSTS = /* @__PURE__ */ new Set(["gamma-api.polymarket.com"]);
 var USER_AGENT2 = "claudinho/0.0 (+https://github.com/arturogarrido/claudinho)";
-var DEFAULT_TIMEOUT_MS = 8e3;
+var DEFAULT_TIMEOUT_MS2 = 8e3;
 var WC_SERIES_SLUG = "soccer-fifwc";
 var WC_SPORT = "fifwc";
 var KICKOFF_TOLERANCE_MS = 6 * 60 * 6e4;
@@ -4249,7 +4344,7 @@ var PolymarketProvider = class {
     const entry = (this.opts.mapping ?? BUNDLED_MAPPING)[match.id];
     const slugs = entry?.eventSlug ? [entry.eventSlug] : deriveEventSlugs(match);
     if (slugs.length === 0) return { checked: true };
-    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
     try {
       for (const slug of slugs) {
         const remaining = deadline - Date.now();
@@ -4269,7 +4364,7 @@ var PolymarketProvider = class {
     const url = `${base}/events?slug=${encodeURIComponent(slug)}`;
     const doFetch = this.opts.fetchImpl ?? fetch;
     const res = await doFetch(url, {
-      signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+      signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2),
       // Gamma never legitimately redirects; following one would sidestep the
       // host allow-list (it only validates the base URL), so reject redirects.
       redirect: "error",
@@ -4743,8 +4838,16 @@ function standingsTable(group, rows) {
 var DISCLAIMER = "Claudinho is an independent fan project \u2014 not affiliated with or endorsed by FIFA or Anthropic.";
 
 // src/tools.ts
+var adapters = /* @__PURE__ */ new Map();
 function resolveAdapter(args) {
-  return args.adapter ?? makeAdapter(args.source);
+  if (args.adapter) return args.adapter;
+  const key = `${args.source ?? "espn"}::${resolveCompetition()}`;
+  let adapter = adapters.get(key);
+  if (!adapter) {
+    adapter = makeAdapter(args.source);
+    adapters.set(key, adapter);
+  }
+  return adapter;
 }
 function resolveMarketProvider(args) {
   return args.marketProvider ?? makeMarketProvider();
@@ -5273,7 +5376,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.19";
+var SERVER_VERSION = "0.9.1";
 var VOICE = asFlavorLevel(process.env.CLAUDINHO_FLAVOR) === "off" ? "" : `
 Voice: when relaying scores, narrate with lively, regionally-appropriate football-commentary energy in the user's language. Each match line may end with a short exclamation ("\u2014 \xA1GOOOOL!") \u2014 use it as a tone cue. Keep every fact exact; never invent details and never impersonate or name a real commentator.`;
 var INSTRUCTIONS = `Claudinho serves live scores, fixtures, and group standings for the 2026 men's football tournament.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.8.19",
+  "version": "0.9.1",
   "mcpName": "io.github.arturogarrido/claudinho",
-  "description": "MCP server for the 2026 men's football tournament — live scores, fixtures, standings, read-only prediction-market signals, and paste-ready match cards. Works with Claude Code, Cursor, Codex, Windsurf, Zed. Not affiliated with FIFA or Anthropic.",
+  "description": "World Cup MCP server for the 2026 men's football tournament — live scores, fixtures, standings, read-only prediction-market signals, and paste-ready match cards. Works with Claude Code, Cursor, Codex, Windsurf, Zed. Not affiliated with FIFA or Anthropic.",
   "type": "module",
   "license": "MIT",
   "author": "Arturo Garrido",
@@ -55,10 +55,11 @@
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
+    "@vitest/coverage-v8": "^4.1.9",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.9",
-    "@claudinho/core": "0.8.19"
+    "@claudinho/core": "0.9.1"
   },
   "scripts": {
     "build": "tsup",
@@ -66,6 +67,7 @@
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "smoke:stdio": "node scripts/stdio-smoke.mjs"
   }
 }