@claudinho/mcp 0.8.18 → 0.9.0

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);
   }
@@ -504,6 +505,33 @@ function shiftUtcDate(dateISO, days) {
   const [y, m, d] = dateISO.slice(0, 10).split("-").map(Number);
   return new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, (d ?? 1) + days)).toISOString().slice(0, 10);
 }
+var FEED_TEXT_MAX = 100;
+function sanitizeFeedText(value, max = FEED_TEXT_MAX) {
+  let out = "";
+  let count = 0;
+  for (const ch of String(value)) {
+    const cp = ch.codePointAt(0) ?? 0;
+    const isWhitespaceControl = cp === 9 || cp === 10 || cp === 13;
+    if ((cp <= 31 || cp >= 127 && cp <= 159) && !isWhitespaceControl) continue;
+    if (count >= max) break;
+    out += isWhitespaceControl ? " " : ch;
+    count++;
+  }
+  return out;
+}
+var segmenter = new Intl.Segmenter();
+var WIDE_CLUSTER = new RegExp("^(?:\\p{Regional_Indicator}|\\p{Extended_Pictographic})", "u");
+function displayWidth(s) {
+  let w = 0;
+  for (const { segment } of segmenter.segment(s)) {
+    w += WIDE_CLUSTER.test(segment) ? 2 : 1;
+  }
+  return w;
+}
+function padVisible(s, width) {
+  const w = displayWidth(s);
+  return w >= width ? s : s + " ".repeat(width - w);
+}
 function outcomeFromScore(home, away) {
   if (home > away) return "H";
   if (home < away) return "A";
@@ -2880,10 +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.0"} (+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 ?? "";
@@ -2924,9 +2969,15 @@ function toInt(s) {
   return Number.isFinite(n) ? n : void 0;
 }
 function toTeam(t2) {
-  const name = t2?.displayName ?? t2?.name ?? t2?.location ?? t2?.shortDisplayName ?? "TBD";
-  const code = (t2?.abbreviation ?? name.slice(0, 3)).toUpperCase();
-  return { code, name, flag: nationToFlag(t2?.displayName ?? t2?.abbreviation ?? name) };
+  const name = sanitizeFeedText(
+    t2?.displayName ?? t2?.name ?? t2?.location ?? t2?.shortDisplayName ?? "TBD"
+  );
+  const code = sanitizeFeedText(t2?.abbreviation ?? name.slice(0, 3)).toUpperCase();
+  return {
+    code,
+    name,
+    flag: nationToFlag(sanitizeFeedText(t2?.displayName ?? t2?.abbreviation ?? name))
+  };
 }
 function mapEspnEvent(ev, ctx = {}) {
   const comp = ev.competitions?.[0];
@@ -2957,9 +3008,9 @@ function mapEspnEvent(ev, ctx = {}) {
     stage,
     group,
     kickoff: ev.date,
-    venue: comp?.venue?.fullName ?? "",
-    city: comp?.venue?.address?.city || void 0,
-    country: comp?.venue?.address?.country || void 0,
+    venue: sanitizeFeedText(comp?.venue?.fullName ?? ""),
+    city: sanitizeFeedText(comp?.venue?.address?.city ?? "") || void 0,
+    country: sanitizeFeedText(comp?.venue?.address?.country ?? "") || void 0,
     home,
     away,
     score: hasScore ? { home: hs, away: as } : void 0,
@@ -3019,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));
   }
@@ -3040,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) {
@@ -3078,17 +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,
-        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 ProviderError(`ESPN response too large: ${length} bytes`, "parse");
       }
-      return await res.json();
+      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}
+`
+        );
+      }
+      throw pe;
     } finally {
       clearTimeout(timer);
     }
@@ -3812,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) {
@@ -3856,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");
@@ -3865,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;
@@ -3898,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;
@@ -3922,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));
@@ -4170,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;
@@ -4208,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();
@@ -4228,13 +4364,20 @@ 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",
       headers: { Accept: "application/json", "User-Agent": USER_AGENT2 }
     });
     if (res.status === 404) return void 0;
     if (!res.ok) {
       throw new Error(`Polymarket request failed: ${res.status} ${res.statusText}`);
     }
+    const length = Number(res.headers?.get?.("content-length"));
+    if (Number.isFinite(length) && length > MAX_RESPONSE_BYTES) {
+      throw new Error(`Polymarket response too large: ${length} bytes`);
+    }
     const data = await res.json();
     const event = Array.isArray(data) ? data[0] : data;
     return event && typeof event === "object" ? event : void 0;
@@ -4677,22 +4820,34 @@ function matchList(matches, empty, opts = {}) {
 }
 function standingsTable(group, rows) {
   const header = `Group ${group}`;
-  const cols = "Team                     P  W  D  L   GD  Pts";
-  const lines = rows.map((r) => {
-    const name = `${r.team.flag} ${r.team.name}`.padEnd(24).slice(0, 24);
-    const gd2 = (r.goalDiff > 0 ? `+${r.goalDiff}` : `${r.goalDiff}`).padStart(3);
-    return `${name} ${pad(r.played)} ${pad(r.won)} ${pad(r.drawn)} ${pad(r.lost)} ${gd2}  ${pad(r.points)}`;
-  });
+  const line = (team, p, w, d, l, gd2, pts) => `${padVisible(team, 24)} ${p.padStart(2)} ${w.padStart(2)} ${d.padStart(2)} ${l.padStart(2)} ${gd2.padStart(3)} ${pts.padStart(3)}`;
+  const cols = line("Team", "P", "W", "D", "L", "GD", "Pts");
+  const lines = rows.map(
+    (r) => line(
+      `${r.team.flag} ${r.team.name}`,
+      String(r.played),
+      String(r.won),
+      String(r.drawn),
+      String(r.lost),
+      r.goalDiff > 0 ? `+${r.goalDiff}` : String(r.goalDiff),
+      String(r.points)
+    )
+  );
   return [header, cols, ...lines].join("\n");
 }
-function pad(n) {
-  return `${n}`.padStart(2);
-}
 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();
@@ -4928,14 +5083,16 @@ async function toolGetNextFixture(args) {
     const msg = degraded ? `Couldn't reach the data provider \u2014 no upcoming fixture confirmed for ${code}.` : `No upcoming fixture found for ${code}.`;
     return {
       text: withDisclaimer(msg, void 0, args.lang),
-      data: { team: code, fixture: null, degraded }
+      data: { team: code, fixture: null, degraded, source: source ?? null }
     };
   }
   const opts = fmtOpts(args);
   return {
+    // `source` in data mirrors the text's "Live data: …" attribution (parity
+    // with CLI `next --json`); null for a static group fixture (no live source).
     text: withDisclaimer(`Next up for ${code}:
 ${matchLine(fixture, opts)}`, source, args.lang),
-    data: { team: code, fixture, degraded }
+    data: { team: code, fixture, degraded, source: source ?? null }
   };
 }
 function toolGetTeam(args) {
@@ -5219,7 +5376,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.18";
+var SERVER_VERSION = "0.9.0";
 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.
@@ -5234,7 +5391,9 @@ var teamArg = z.string().regex(/^[A-Za-z]{3}$/, "a 3-letter team code, e.g. MEX"
 var flavorArg = z.enum(["off", "subtle", "full"]);
 var commonArgs = {
   tz: z.string().optional().describe("IANA timezone for kickoff times, e.g. America/Mexico_City"),
-  lang: z.string().optional().describe("Locale for formatting: en, es, pt, fr (other locales fall back to en)"),
+  lang: z.string().optional().describe(
+    "Locale for dates, provider attribution, and commentary: en, es, pt, fr (the summary scaffold stays English; other locales fall back to en)"
+  ),
   flavor: flavorArg.optional().describe("Commentary flair: off, subtle, full (default: full)")
 };
 var teamRef = z.object({ code: z.string(), name: z.string(), flag: z.string() }).partial().passthrough();
@@ -5281,7 +5440,12 @@ var bracketOut = {
   standingsDegraded: z.boolean().optional(),
   source: src.optional()
 };
-var nextOut = { team: z.string(), fixture: matchOut.nullable(), degraded: z.boolean() };
+var nextOut = {
+  team: z.string(),
+  fixture: matchOut.nullable(),
+  degraded: z.boolean(),
+  source: src
+};
 var marketOut = {
   matchId: z.string().nullable().optional(),
   team: z.string().optional(),
@@ -5333,7 +5497,7 @@ function buildServer() {
     "get_today",
     {
       title: "Today's matches",
-      description: "All fixtures for a date (default: today), with live score and minute overlaid on any match in play. Use this for a whole day's card; for only in-play matches use get_live, for one team's match use get_next_fixture, for a single match's detail use get_match. Kickoffs render in tz; lang localizes text (en/es/pt/fr); flavor sets commentary tone.",
+      description: "All fixtures for a date (default: today), with live score and minute overlaid on any match in play. Use this for a whole day's card; for only in-play matches use get_live, for one team's match use get_next_fixture, for a single match's detail use get_match. Kickoffs render in tz; lang localizes dates, attribution, and commentary (en/es/pt/fr); flavor sets commentary tone.",
       inputSchema: {
         date: dateArg.optional().describe("Date as YYYY-MM-DD (default: today)"),
         ...commonArgs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.8.18",
+  "version": "0.9.0",
   "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.",
   "type": "module",
@@ -26,6 +26,7 @@
   },
   "files": [
     "dist",
+    "!dist/*.mcpb",
     "README.md",
     "LICENSE"
   ],
@@ -54,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.18"
+    "@claudinho/core": "0.9.0"
   },
   "scripts": {
     "build": "tsup",
@@ -65,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"
   }
 }