@claudinho/mcp 0.9.4 → 0.10.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // src/server.ts
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { types as utilTypes } from "util";
-import { z } from "zod";
+import { z } from "zod/v3";
 
 // ../core/dist/index.js
 var REGIONAL_INDICATOR_A = 127462;
@@ -279,6 +279,8 @@ var EN = {
   "bracket.slot.tbd": "TBD",
   "live.data": "Live data: {source}",
   "standings.unavailable": "Live standings unavailable.",
+  "standings.partial": "Partial table \u2014 {n} rows could not be read.",
+  "competition.unsupported": "Not available for this competition yet.",
   "share.tryIt": "Try it: {line}",
   "stage.group": "Group {group}",
   "stage.groupStage": "Group stage",
@@ -309,6 +311,8 @@ var ES = {
   "bracket.slot.tbd": "Por definir",
   "live.data": "Datos en vivo: {source}",
   "standings.unavailable": "Tabla en vivo no disponible.",
+  "standings.partial": "Tabla parcial \u2014 no se pudieron leer {n} filas.",
+  "competition.unsupported": "A\xFAn no disponible para esta competici\xF3n.",
   "share.tryIt": "Pru\xE9balo: {line}",
   "stage.group": "Grupo {group}",
   "stage.groupStage": "Fase de grupos",
@@ -339,6 +343,8 @@ var PT = {
   "bracket.slot.tbd": "A definir",
   "live.data": "Dados ao vivo: {source}",
   "standings.unavailable": "Classifica\xE7\xE3o ao vivo indispon\xEDvel.",
+  "standings.partial": "Tabela parcial \u2014 {n} linhas n\xE3o puderam ser lidas.",
+  "competition.unsupported": "Ainda n\xE3o dispon\xEDvel para esta competi\xE7\xE3o.",
   "share.tryIt": "Experimente: {line}",
   "stage.group": "Grupo {group}",
   "stage.groupStage": "Fase de grupos",
@@ -369,6 +375,8 @@ var FR = {
   "bracket.slot.tbd": "\xC0 d\xE9finir",
   "live.data": "Donn\xE9es en direct : {source}",
   "standings.unavailable": "Classement en direct indisponible.",
+  "standings.partial": "Classement partiel \u2014 {n} lignes n'ont pas pu \xEAtre lues.",
+  "competition.unsupported": "Pas encore disponible pour cette comp\xE9tition.",
   "share.tryIt": "Essayez : {line}",
   "stage.group": "Groupe {group}",
   "stage.groupStage": "Phase de groupes",
@@ -2836,11 +2844,13 @@ function fixturesByGroup(group, fixtures = SCHEDULE) {
   const g = group.toUpperCase();
   return fixtures.filter((m) => (m.group ?? "").toUpperCase() === g).sort(byKickoff);
 }
+function isUpcoming(m, now = /* @__PURE__ */ new Date()) {
+  if (m.status === "CANCELLED" || m.status === "POSTPONED") return false;
+  return Date.parse(m.kickoff) >= now.getTime();
+}
 function nextFixtureForTeam(code, opts = {}) {
   const from = opts.from ?? /* @__PURE__ */ new Date();
-  return fixturesByTeam(code, opts.fixtures ?? SCHEDULE).find(
-    (m) => new Date(m.kickoff).getTime() >= from.getTime()
-  );
+  return fixturesByTeam(code, opts.fixtures ?? SCHEDULE).find((m) => isUpcoming(m, from));
 }
 var LIVE_WINDOW_MS = 140 * 6e4;
 var KNOCKOUT_EXTRA_TIME_MS = 60 * 6e4;
@@ -3186,7 +3196,7 @@ function toParticipant(raw) {
   const providerId = opaqueId(raw.team?.id, ESPN_ID);
   const known = productFlag(name) !== nationToFlag("");
   return valid(
-    providerId && known ? { kind: "team", providerId, team } : { kind: "slot", team }
+    providerId && known ? { kind: "team", providerId, team } : { kind: "slot", ...providerId ? { providerId } : {}, team }
   );
 }
 function mapStatus(st) {
@@ -3255,7 +3265,7 @@ function parseEspnEvent(raw, ctx = {}) {
   if (awayP.kind !== "valid") return awayP;
   const h = homeP.value;
   const a = awayP.value;
-  if (h.kind === "team" && a.kind === "team" && h.providerId === a.providerId) {
+  if (h.providerId !== void 0 && h.providerId === a.providerId) {
     return definitiveNone("both competitors are the same team");
   }
   const home = homeP.value.team;
@@ -3408,8 +3418,12 @@ function parseEspnStandings(raw) {
   const seenProviderIds = /* @__PURE__ */ new Set();
   for (const child of children) {
     const label = humanLabel(child?.name ?? child?.abbreviation);
-    const letter = label.match(/Group\s+([A-L])/i)?.[1]?.toUpperCase();
-    if (!letter) continue;
+    const letter = label.match(/Group\s+([A-L])(?![A-Za-z0-9])/i)?.[1]?.toUpperCase();
+    if (!letter) {
+      const rows = child?.standings?.entries;
+      if (Array.isArray(rows) && rows.length > 0) complete = false;
+      continue;
+    }
     if (seenGroups.has(letter)) {
       complete = false;
       continue;
@@ -3420,30 +3434,37 @@ function parseEspnStandings(raw) {
       complete = false;
       continue;
     }
+    let omitted = 0;
     if (rawEntries.length > MAX_GROUP_ROWS) {
       rowsTruncated = true;
       complete = false;
+      omitted += rawEntries.length - MAX_GROUP_ROWS;
     }
     const entries = takeBounded(rawEntries, MAX_GROUP_ROWS);
-    const seenTeams = /* @__PURE__ */ new Set();
+    const seenCodes = /* @__PURE__ */ new Map();
     const seenRanks = /* @__PURE__ */ new Set();
     const ranked = [];
     for (const e of entries) {
       const r = entryToRow(e);
       if (r.kind !== "valid") {
         if (r.kind !== "definitive-none") complete = false;
+        omitted += 1;
         continue;
       }
-      const key = r.value.providerId ?? r.value.team.code;
-      if (seenTeams.has(key) || seenRanks.has(r.value.providerRank) || r.value.providerId !== void 0 && seenProviderIds.has(r.value.providerId)) {
+      const { providerId, providerRank } = r.value;
+      const code = r.value.team.code;
+      const priorHadId = seenCodes.get(code);
+      const codeCollision = priorHadId !== void 0 && (providerId === void 0 || priorHadId === false);
+      if (codeCollision || seenRanks.has(providerRank) || providerId !== void 0 && seenProviderIds.has(providerId)) {
         complete = false;
+        omitted += 1;
         continue;
       }
-      seenTeams.add(key);
-      seenRanks.add(r.value.providerRank);
-      if (r.value.providerId !== void 0) seenProviderIds.add(r.value.providerId);
+      seenCodes.set(code, providerId !== void 0);
+      seenRanks.add(providerRank);
+      if (providerId !== void 0) seenProviderIds.add(providerId);
       const { providerId: _dropId, providerRank: rank, ...row } = r.value;
-      ranked.push({ row, rank });
+      ranked.push({ row: { ...row, rank }, rank });
     }
     ranked.sort((a, b) => {
       if (a.rank && b.rank && a.rank !== b.rank) return a.rank - b.rank;
@@ -3455,7 +3476,11 @@ function parseEspnStandings(raw) {
       complete = false;
       continue;
     }
-    out.push({ group: letter, rows: ranked.map((x) => x.row) });
+    out.push({
+      group: letter,
+      rows: ranked.map((x) => x.row),
+      ...omitted > 0 ? { partial: { omitted } } : {}
+    });
   }
   return {
     items: out,
@@ -3466,11 +3491,72 @@ function parseEspnStandings(raw) {
     complete: complete && !rowsTruncated
   };
 }
+var ResponseTooLargeError = class extends Error {
+  constructor(bytes, limit) {
+    super(`response body exceeds ${limit} bytes (${bytes} seen)`);
+    this.bytes = bytes;
+    this.limit = limit;
+    this.name = "ResponseTooLargeError";
+  }
+  bytes;
+  limit;
+};
+function isStream(v) {
+  return typeof v?.getReader === "function";
+}
+async function readJsonBounded(res, maxBytes) {
+  const r = res;
+  const declared = Number(r.headers?.get?.("content-length"));
+  if (Number.isFinite(declared) && declared > maxBytes) {
+    if (isStream(r.body)) await r.body.cancel().catch(() => {
+    });
+    throw new ResponseTooLargeError(declared, maxBytes);
+  }
+  if (isStream(r.body)) {
+    const reader = r.body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      total += value.byteLength;
+      if (total > maxBytes) {
+        await reader.cancel().catch(() => {
+        });
+        throw new ResponseTooLargeError(total, maxBytes);
+      }
+      chunks.push(value);
+    }
+    return JSON.parse(new TextDecoder().decode(Buffer.concat(chunks)));
+  }
+  if (typeof r.text === "function") {
+    const text = await r.text();
+    const size2 = Buffer.byteLength(text);
+    if (size2 > maxBytes) throw new ResponseTooLargeError(size2, maxBytes);
+    return JSON.parse(text);
+  }
+  if (typeof r.json === "function") return r.json();
+  throw new TypeError("response has no readable body");
+}
 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.9.4"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.10.1"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
+var DEFAULT_COOLDOWN_MS = 5 * 6e4;
+var MAX_COOLDOWN_MS = 15 * 6e4;
+function retryAfterMs(header, nowMs) {
+  if (typeof header !== "string" || header.trim() === "") return DEFAULT_COOLDOWN_MS;
+  const h = header.trim();
+  let ms;
+  if (/^\d+$/.test(h)) ms = Number(h) * 1e3;
+  else {
+    const at = Date.parse(h);
+    if (Number.isFinite(at)) ms = at - nowMs;
+  }
+  if (ms === void 0 || !Number.isFinite(ms)) return DEFAULT_COOLDOWN_MS;
+  return Math.min(Math.max(ms, 0), MAX_COOLDOWN_MS);
+}
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
 }
@@ -3479,6 +3565,8 @@ var STANDINGS_SHARE_MS = 3e4;
 var ProviderError = class extends Error {
   kind;
   status;
+  /** For a throttle: how long the adapter will refuse to fetch (bounded). */
+  retryAfterMs;
   constructor(message, kind, status) {
     super(message);
     this.name = "ProviderError";
@@ -3502,6 +3590,7 @@ function usableProviderItems(kind, parsed, hasUsableRecord = parsed.items.length
 var EspnAdapter = class {
   constructor(opts = {}) {
     this.opts = opts;
+    this.clock = opts.now ?? (() => Date.now());
     const expected = opts.expectedStandingsGroups ?? (opts.baseUrl === void 0 ? groups() : void 0);
     this.expectedStandingsGroups = expected ? [...expected] : void 0;
     this.standingsFallbackGroups = opts.baseUrl === void 0 && expected ? [...expected] : void 0;
@@ -3527,6 +3616,53 @@ var EspnAdapter = class {
    * throttle (persist a backoff) from an ordinary blip.
    */
   lastError;
+  /**
+   * A retained throttle (audit A12): after a 429/403 every call inside the
+   * window throws the provider's last answer WITHOUT a request. A server-
+   * lifetime MCP adapter is covered by this alone; the CLI pre-arms each
+   * process from its persisted cache via `armCooldown`.
+   */
+  cooldownUntilMs;
+  cooldownError;
+  cooldownListeners = /* @__PURE__ */ new Set();
+  clock;
+  /** Epoch ms until which requests are refused, when a cooldown is armed. */
+  get cooldownUntil() {
+    return this.cooldownUntilMs;
+  }
+  /**
+   * Arm the cooldown from outside — a fresh CLI process reading the backoff
+   * its refresher persisted. The retained error reads as a throttle so every
+   * caller's `degraded` path and the refresher's persistence treat it as one.
+   */
+  armCooldown(untilMs, reason) {
+    const nowMs = this.clock();
+    const error = reason ?? new ProviderError("ESPN request skipped: provider cooldown in effect", "http", 429);
+    error.retryAfterMs = Math.max(0, untilMs - nowMs);
+    this.arm(untilMs, error);
+  }
+  /**
+   * Be told whenever the cooldown window is armed or EXTENDED — the way a
+   * caller persists a throttle that arrives from a still-running request after
+   * its own call already returned (review P2 on #128). Returns unsubscribe.
+   */
+  onCooldown(listener) {
+    this.cooldownListeners.add(listener);
+    return () => {
+      this.cooldownListeners.delete(listener);
+    };
+  }
+  /**
+   * The ONE place a window is set. Concurrent requests can each carry a
+   * Retry-After; the LATEST expiry wins — a shorter one arriving second must
+   * never shorten a longer active window (review P2 on #128).
+   */
+  arm(untilMs, error) {
+    if (this.cooldownUntilMs !== void 0 && untilMs <= this.cooldownUntilMs) return;
+    this.cooldownUntilMs = untilMs;
+    this.cooldownError = error;
+    for (const listener of this.cooldownListeners) listener(untilMs);
+  }
   async fetchByDate(dateISO) {
     return this.fetchScoreboard(toEspnDate(dateISO));
   }
@@ -3614,6 +3750,11 @@ var EspnAdapter = class {
     return usableProviderItems("scoreboard", parsed);
   }
   async get(url) {
+    const nowMs = this.clock();
+    if (this.cooldownError && this.cooldownUntilMs !== void 0 && nowMs < this.cooldownUntilMs) {
+      this.lastError = this.cooldownError;
+      throw this.cooldownError;
+    }
     const doFetch = this.opts.fetchImpl ?? fetch;
     const controller = new AbortController();
     const timer = setTimeout(
@@ -3635,19 +3776,24 @@ var EspnAdapter = class {
         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 ProviderError(
+        const pe = 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");
+        if (pe.throttled) {
+          const receiptMs = this.clock();
+          pe.retryAfterMs = retryAfterMs(res.headers?.get?.("retry-after"), receiptMs);
+          this.arm(receiptMs + pe.retryAfterMs, pe);
+        }
+        throw pe;
       }
       try {
-        return await res.json();
+        return await readJsonBounded(res, MAX_RESPONSE_BYTES);
       } catch (e) {
+        if (e instanceof ResponseTooLargeError) {
+          throw new ProviderError(`ESPN response too large: ${e.bytes} bytes`, "parse");
+        }
         throw new ProviderError(
           `ESPN response unparseable: ${e?.message ?? e}`,
           "parse"
@@ -3690,14 +3836,30 @@ function hasGroupStarted(group, tables) {
 function matchesPerTeamInGroup(teamCount) {
   return Math.max(0, teamCount - 1);
 }
-function isGroupStandingsComplete(table) {
-  const n = table?.rows.length ?? 0;
+function isGroupStandingsComplete(table, expectedTeams) {
+  if (!table || table.partial) return false;
+  const n = table.rows.length;
   if (n < 2) return false;
-  const required = matchesPerTeamInGroup(n);
+  if (expectedTeams !== void 0 && n < expectedTeams) return false;
+  const required = matchesPerTeamInGroup(Math.max(n, expectedTeams ?? n));
   return table.rows.every((r) => r.played >= required);
 }
+function bundledGroupSize(group) {
+  const codes = /* @__PURE__ */ new Set();
+  for (const m of fixturesByGroup(group)) {
+    codes.add(m.home.code);
+    codes.add(m.away.code);
+  }
+  return codes.size > 0 ? codes.size : void 0;
+}
 function isGroupComplete(group, tables) {
-  return isGroupStandingsComplete(tables.find((t2) => t2.group === group));
+  return isGroupStandingsComplete(
+    tables.find((t2) => t2.group === group),
+    bundledGroupSize(group)
+  );
+}
+function isGroupPartial(group, tables) {
+  return tables.find((t2) => t2.group === group)?.partial !== void 0;
 }
 function resolveWinner(match) {
   if (!isFinished(match.status)) return void 0;
@@ -3752,7 +3914,7 @@ function resolveSlot(ref, ctx, liveTeam, fixtureInMergedSet = false) {
       return tbd(ref.label);
     case "group": {
       if (liveParticipant) return liveParticipant;
-      if (!ctx.standingsDegraded && hasGroupStarted(ref.group, ctx.tables)) {
+      if (!ctx.standingsDegraded && !isGroupPartial(ref.group, ctx.tables) && hasGroupStarted(ref.group, ctx.tables)) {
         const team = teamFromStandings(ref.group, ref.position, ctx.tables);
         if (team) {
           const status = isGroupComplete(ref.group, ctx.tables) ? "confirmed" : "projected";
@@ -4386,13 +4548,17 @@ function resolveCompetition(explicit) {
   }
   return DEFAULT_COMPETITION;
 }
+var BUNDLE_COMPETITION = DEFAULT_COMPETITION;
+function bundleApplies(competition = resolveCompetition()) {
+  return competition === BUNDLE_COMPETITION;
+}
 var KNOWN_SOURCES = ["espn"];
-function makeAdapter(source = "espn") {
+function makeAdapter(source = "espn", opts = {}) {
   switch (source) {
     case "espn": {
       const competition = resolveCompetition();
       const baseUrl = competition === DEFAULT_COMPETITION ? void 0 : competitionBase(competition);
-      return new EspnAdapter({ baseUrl });
+      return new EspnAdapter({ baseUrl, enrichGroups: opts.enrichGroups, now: opts.now });
     }
     default:
       throw new Error(
@@ -4410,7 +4576,7 @@ function liveSourceLabel(source) {
   return known[source] ?? source.charAt(0).toUpperCase() + source.slice(1);
 }
 async function getMatchesForDate(adapter, dateISO) {
-  const base = allFixtures();
+  const base = bundleApplies() ? allFixtures() : [];
   const day = dateISO.slice(0, 10);
   try {
     const live = adapter.fetchWindow ? await adapter.fetchWindow(shiftUtcDate(day, -1), shiftUtcDate(day, 1)) : await adapter.fetchByDate(day);
@@ -4455,21 +4621,27 @@ function knockoutWindow() {
   return knockoutWindowMemo;
 }
 async function getBracket(adapter, opts = {}) {
+  if (!bundleApplies()) {
+    const view2 = { stages: [], degraded: false, standingsDegraded: false, unsupported: true };
+    return { view: view2, degraded: false, standingsDegraded: false, unsupported: true };
+  }
   const topology = loadBracketTopology();
   const base = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY");
   let matches = base;
   let liveDegraded = true;
   let source;
-  try {
-    const win = knockoutWindow();
-    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
-    matches = mergeLive(base, live);
-    liveDegraded = false;
-    source = adapter.name;
-  } catch {
+  const win = knockoutWindow();
+  if (adapter.fetchWindow && win) {
+    try {
+      const live = await adapter.fetchWindow(win.start, win.end);
+      matches = mergeLive(base, live);
+      liveDegraded = false;
+      source = adapter.name;
+    } catch {
+    }
   }
   const standings = await getStandings(adapter);
-  if (!source && !standings.degraded && standings.source) {
+  if (!source && !standings.degraded && standings.source && standings.tables.length > 0) {
     source = standings.source;
   }
   const view = buildBracketView(
@@ -4491,18 +4663,18 @@ async function getBracket(adapter, opts = {}) {
 }
 var EXTRA_TIME_SLACK_MS = 60 * 6e4;
 async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
+  if (!bundleApplies()) return { match: void 0, degraded: false, unsupported: true };
   const nowMs = now.getTime();
   let fixtures = allFixtures();
   let overlayFailed = false;
-  try {
-    const win = knockoutWindow();
-    if (adapter.fetchWindow && win) {
-      fixtures = mergeLive(
-        fixtures,
-        await adapter.fetchWindow(win.start, win.end)
-      );
+  const win = knockoutWindow();
+  if (adapter.fetchWindow && win) {
+    try {
+      fixtures = mergeLive(fixtures, await adapter.fetchWindow(win.start, win.end));
+    } catch {
+      overlayFailed = true;
     }
-  } catch {
+  } else {
     overlayFailed = true;
   }
   const candidate = fixturesByTeam(code, fixtures).find((m) => {
@@ -4518,23 +4690,27 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   return { match: next, degraded: overlayFailed };
 }
 async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
+  if (!bundleApplies()) return { fixture: void 0, degraded: false, unsupported: true };
   const base = allFixtures();
   let matches = base;
   let degraded = true;
   let liveById;
-  try {
-    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));
-  } catch {
+  const win = knockoutWindow();
+  if (adapter.fetchWindow && win) {
+    try {
+      const live = await adapter.fetchWindow(win.start, win.end);
+      matches = mergeLive(base, live);
+      degraded = false;
+      liveById = new Set(live.map((m) => m.id));
+    } catch {
+    }
   }
   const fixture = nextFixtureForTeam(code, { from: now, fixtures: matches });
   const source = fixture && liveById?.has(fixture.id) ? adapter.name : void 0;
   return { fixture, degraded, source };
 }
 async function getMatchById(adapter, id) {
+  if (!bundleApplies()) return { match: void 0, degraded: false, unsupported: true };
   const base = allFixtures().find((m) => m.id === id);
   if (!base) return { match: void 0, degraded: false };
   const day = base.kickoff.slice(0, 10);
@@ -4972,11 +5148,15 @@ var PolymarketProvider = class {
     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`);
+    let data;
+    try {
+      data = await readJsonBounded(res, MAX_RESPONSE_BYTES);
+    } catch (e) {
+      if (e instanceof ResponseTooLargeError) {
+        throw new Error(`Polymarket response too large: ${e.bytes} bytes`);
+      }
+      throw e;
     }
-    const data = await res.json();
     if (Array.isArray(data) && data.length > 1) {
       return ambiguous("slug returned more than one event");
     }
@@ -5237,6 +5417,10 @@ function numberish(v) {
   }
   return void 0;
 }
+var MARKET_COMPETITIONS = /* @__PURE__ */ new Set([DEFAULT_COMPETITION]);
+function marketsCoverCompetition(competition = resolveCompetition()) {
+  return MARKET_COMPETITIONS.has(competition);
+}
 function resolveMarketSource(explicit) {
   if (explicit) return explicit;
   if (typeof process !== "undefined" && process.env?.CLAUDINHO_MARKETS_SOURCE) {
@@ -5253,6 +5437,7 @@ function makeMarketProvider(source) {
       return new FakeMarketProvider();
     // no synth → yields no signals, no network
     default:
+      if (!marketsCoverCompetition()) return new FakeMarketProvider();
       return new PolymarketProvider();
   }
 }
@@ -5378,10 +5563,13 @@ function formatShareTable(input, options = {}) {
       input.emptyNote ?? (input.degraded ? "Live standings unavailable." : "No standings available.")
     );
   } else {
-    for (const { group, rows } of input.tables) {
-      blocks.push(
-        [`Group ${group} \xB7 standings`, "", ...rows.map((r, i) => tableRow(r, i + 1))].join("\n")
-      );
+    for (const { group, rows, partial } of input.tables) {
+      const lines = [`Group ${group} \xB7 standings`, "", ...rows.map((r, i) => tableRow(r, r.rank ?? i + 1))];
+      if (partial) {
+        const n = partial.omitted;
+        lines.push("", `(partial table \u2014 ${n} row${n === 1 ? "" : "s"} unreadable; positions are the provider's ranks)`);
+      }
+      blocks.push(lines.join("\n"));
     }
     if (input.degraded) {
       blocks.push("(Live standings unavailable \u2014 group roster, not live results.)");
@@ -5584,7 +5772,9 @@ function marketText(m, sig, args) {
   return `${marketHeader(m, args)}
 ${marketBlock(sig, m).join("\n")}`;
 }
+var MARKETS_SCOPE_NOTE = "Market signals cover the World Cup only; none are read for this competition.";
 function noSignalText(m, args, now) {
+  if (!marketsCoverCompetition()) return `${marketHeader(m, args)} \u2014 ${MARKETS_SCOPE_NOTE}`;
   if (marketRelevant(m, now)) return `No reliable market signal for ${marketHeader(m, args)}.`;
   const verb = isFinished(m.status) ? "has finished" : "appears to have finished";
   return `${marketHeader(m, args)} ${verb} \u2014 market signals are pre-match and in-play reads.`;
@@ -5744,9 +5934,19 @@ ${matchList(matches, "No matches in play right now.", opts)}`;
   };
 }
 async function toolGetMatch(args) {
-  const { match, degraded, source: liveSource } = await getMatchById(resolveAdapter(args), args.id);
+  const { match, degraded, source: liveSource, unsupported } = await getMatchById(
+    resolveAdapter(args),
+    args.id
+  );
   if (!match) {
-    return { text: withDisclaimer(`No match found with id ${args.id}.`), data: { match: null } };
+    return {
+      text: withDisclaimer(
+        unsupported ? t(args.lang, "competition.unsupported") : `No match found with id ${args.id}.`,
+        void 0,
+        args.lang
+      ),
+      data: { match: null }
+    };
   }
   const opts = fmtOpts(args);
   const now = args.now ?? /* @__PURE__ */ new Date();
@@ -5779,7 +5979,11 @@ ${marketBlock(marketSignal, match).join("\n")}` : base;
 async function toolGetStandings(args) {
   const { tables, degraded, source } = await getStandings(resolveAdapter(args), args.group);
   const boundedTables = boundedRecords(tables);
-  const shaped = boundedTables.items.map((tb) => ({ group: tb.group, standings: tb.rows }));
+  const shaped = boundedTables.items.map((tb) => ({
+    group: tb.group,
+    standings: tb.rows,
+    ...tb.partial ? { partial: tb.partial } : {}
+  }));
   if (shaped.length === 0) {
     const g = args.group?.toUpperCase();
     const msg = degraded ? t(args.lang, "standings.unavailable") : g ? `No group "${g}".` : "No standings available.";
@@ -5788,7 +5992,11 @@ async function toolGetStandings(args) {
       data: { degraded, source: source ?? null, tables: args.group ? null : [] }
     };
   }
-  let text = shaped.map((t2) => standingsTable(t2.group, t2.standings)).join("\n\n");
+  let text = shaped.map((tb) => {
+    const block = standingsTable(tb.group, tb.standings);
+    return tb.partial ? `${block}
+(${t(args.lang, "standings.partial", { n: String(tb.partial.omitted) })})` : block;
+  }).join("\n\n");
   text += truncationNote(boundedTables);
   if (degraded) text += "\n\n(Live standings unavailable \u2014 showing the group roster.)";
   return {
@@ -5809,10 +6017,16 @@ async function toolGetBracket(args) {
       data: { view: null }
     };
   }
-  const { view, degraded, standingsDegraded, source } = await getBracket(
+  const { view, degraded, standingsDegraded, source, unsupported } = await getBracket(
     resolveAdapter(args),
     filter ? { stage: filter, lang: args.lang } : { lang: args.lang }
   );
+  if (unsupported) {
+    return {
+      text: withDisclaimer(t(args.lang, "competition.unsupported"), void 0, args.lang),
+      data: { degraded, standingsDegraded, source: null, view }
+    };
+  }
   let text = formatBracketList(view, { footer: false, locale: args.lang, tz: args.tz });
   if (degraded) {
     text += `
@@ -5833,18 +6047,20 @@ async function standingsResourceText(group, adapter) {
   const { tables, degraded, source } = await getStandings(adapter, g);
   const tb = tables[0];
   let text = tb ? standingsTable(tb.group, tb.rows) : degraded ? "Live standings unavailable." : `No group ${g}.`;
+  if (tb?.partial) text += `
+(${t(void 0, "standings.partial", { n: String(tb.partial.omitted) })})`;
   if (degraded && tb) text += "\n\n(Live standings unavailable \u2014 showing the group roster.)";
   return withDisclaimer(text, source);
 }
 async function toolGetNextFixture(args) {
   const code = args.team.toUpperCase();
-  const { fixture, degraded, source } = await getNextFixtureForTeam(
+  const { fixture, degraded, source, unsupported } = await getNextFixtureForTeam(
     resolveAdapter(args),
     code,
     args.now ?? /* @__PURE__ */ new Date()
   );
   if (!fixture) {
-    const msg = degraded ? `Couldn't reach the data provider \u2014 no upcoming fixture confirmed for ${code}.` : `No upcoming fixture found for ${code}.`;
+    const msg = unsupported ? t(args.lang, "competition.unsupported") : 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, source: source ?? null }
@@ -5876,12 +6092,12 @@ async function toolGetMarketSignal(args) {
   const provider = resolveMarketProvider(args);
   const now = args.now ?? /* @__PURE__ */ new Date();
   if (args.matchId) {
-    const { match } = await getMatchById(resolveAdapter(args), args.matchId);
+    const { match, unsupported } = await getMatchById(resolveAdapter(args), args.matchId);
     const relevant = match ? marketRelevant(match, now) : false;
     const batch2 = match && relevant ? await getMarketSignals(provider, [match], MARKETS_TOOL_OPTS) : { results: /* @__PURE__ */ new Map(), complete: true };
     const sig = match ? resolvedValues(batch2).get(match.id) : void 0;
     const shown2 = batch2.complete && match && sig && marketDisplayable(match, sig) ? sig : void 0;
-    const text2 = !match ? `No match found with id ${args.matchId}.` : !batch2.complete ? `Market data unavailable or incomplete for ${marketHeader(match, args)} \u2014 this match could not be checked.` : shown2 ? marketText(match, shown2, args) : noSignalText(match, args, now);
+    const text2 = !match ? unsupported ? t(args.lang, "competition.unsupported") : `No match found with id ${args.matchId}.` : !batch2.complete ? `Market data unavailable or incomplete for ${marketHeader(match, args)} \u2014 this match could not be checked.` : shown2 ? marketText(match, shown2, args) : noSignalText(match, args, now);
     return {
       text: withDisclaimer(text2),
       data: {
@@ -5894,12 +6110,16 @@ async function toolGetMarketSignal(args) {
   }
   if (args.team) {
     const code = args.team.toUpperCase();
-    const { match: fixture, degraded } = await marketFixtureForTeam(resolveAdapter(args), code, now);
+    const { match: fixture, degraded, unsupported } = await marketFixtureForTeam(
+      resolveAdapter(args),
+      code,
+      now
+    );
     const relevant = fixture ? marketRelevant(fixture, now) : false;
     const batch2 = fixture && relevant ? await getMarketSignals(provider, [fixture], MARKETS_TOOL_OPTS) : { results: /* @__PURE__ */ new Map(), complete: true };
     const sig = fixture ? resolvedValues(batch2).get(fixture.id) : void 0;
     const shown2 = batch2.complete && fixture && sig && marketDisplayable(fixture, sig) ? sig : void 0;
-    const text2 = !fixture ? degraded ? `Live feed unavailable \u2014 can't resolve ${code}'s next fixture right now.` : `No upcoming fixture found for ${code}.` : !batch2.complete ? `Market data unavailable or incomplete for ${marketHeader(fixture, args)} \u2014 this match could not be checked.` : shown2 ? marketText(fixture, shown2, args) : noSignalText(fixture, args, now);
+    const text2 = !fixture ? unsupported ? t(args.lang, "competition.unsupported") : degraded ? `Live feed unavailable \u2014 can't resolve ${code}'s next fixture right now.` : `No upcoming fixture found for ${code}.` : !batch2.complete ? `Market data unavailable or incomplete for ${marketHeader(fixture, args)} \u2014 this match could not be checked.` : shown2 ? marketText(fixture, shown2, args) : noSignalText(fixture, args, now);
     return {
       text: withDisclaimer(text2),
       data: {
@@ -5929,7 +6149,7 @@ ${shown.items.map(({ match, signal }) => marketText(match, signal, args)).join("
     // so "we could not reach the market data" rendered as the confident
     // "there is none", which is the failure this project refuses everywhere
     // else.
-    batch.complete ? `No reliable market signals on ${date}.` : `Market data unavailable or incomplete for ${date} \u2014 not all fixtures could be checked.`
+    !marketsCoverCompetition() ? `${MARKETS_SCOPE_NOTE} (${date})` : batch.complete ? `No reliable market signals on ${date}.` : `Market data unavailable or incomplete for ${date} \u2014 not all fixtures could be checked.`
   );
   if (shown.shown > 0 && !batch.complete) {
     text += `
@@ -6059,7 +6279,12 @@ async function toolGetShareSnippet(args) {
         degraded: degraded2,
         informationalOnly: true,
         snippet,
-        tables: boundedRecords(tables).items.map((tb) => ({ group: tb.group, standings: tb.rows }))
+        // The structured card keeps the verdict the snippet warns about (A01).
+        tables: boundedRecords(tables).items.map((tb) => ({
+          group: tb.group,
+          standings: tb.rows,
+          ...tb.partial ? { partial: tb.partial } : {}
+        }))
       }
     };
   }
@@ -6075,7 +6300,7 @@ async function toolGetShareSnippet(args) {
         data: { kind: "bracket", view: null }
       };
     }
-    const { view, degraded: degraded2, source: source2 } = await getBracket(
+    const { view, degraded: degraded2, source: source2, unsupported } = await getBracket(
       resolveAdapter(args),
       stageFilter ? { stage: stageFilter, lang: args.lang } : { lang: args.lang }
     );
@@ -6084,7 +6309,7 @@ async function toolGetShareSnippet(args) {
         view,
         source: degraded2 ? void 0 : source2,
         installLine: stageFilter ? `npx @claudinho/cli bracket ${stageFilter}` : "npx @claudinho/cli bracket",
-        emptyNote: t(args.lang, "bracket.empty")
+        emptyNote: unsupported ? t(args.lang, "competition.unsupported") : t(args.lang, "bracket.empty")
       },
       { ...options, locale: args.lang, tz: args.tz }
     );
@@ -6103,7 +6328,10 @@ async function toolGetShareSnippet(args) {
     };
   }
   if (args.matchId) {
-    const { match, degraded: degraded2, source: source2 } = await getMatchById(resolveAdapter(args), args.matchId);
+    const { match, degraded: degraded2, source: source2, unsupported } = await getMatchById(
+      resolveAdapter(args),
+      args.matchId
+    );
     const matches = match ? [match] : [];
     const market2 = await signalsFor(matches);
     return shareResult(
@@ -6117,7 +6345,7 @@ async function toolGetShareSnippet(args) {
         marketComplete: market2.complete,
         source: source2,
         degraded: degraded2,
-        emptyNote: `No match found with id ${args.matchId}.`,
+        emptyNote: unsupported ? t(args.lang, "competition.unsupported") : `No match found with id ${args.matchId}.`,
         installLine: `npx @claudinho/cli match ${args.matchId}`,
         tz: args.tz,
         locale: args.lang
@@ -6127,7 +6355,7 @@ async function toolGetShareSnippet(args) {
   }
   if (args.team) {
     const code = args.team.toUpperCase();
-    const { fixture, degraded: degraded2, source: source2 } = await getNextFixtureForTeam(
+    const { fixture, degraded: degraded2, source: source2, unsupported } = await getNextFixtureForTeam(
       resolveAdapter(args),
       code,
       args.now ?? /* @__PURE__ */ new Date()
@@ -6148,7 +6376,7 @@ async function toolGetShareSnippet(args) {
         // with get_next_fixture (a static group fixture carries no source).
         source: source2,
         degraded: degraded2,
-        emptyNote: degraded2 ? `Couldn't reach the data provider \u2014 no upcoming fixture confirmed for ${code}.` : `No upcoming fixture found for ${code}.`,
+        emptyNote: unsupported ? t(args.lang, "competition.unsupported") : degraded2 ? `Couldn't reach the data provider \u2014 no upcoming fixture confirmed for ${code}.` : `No upcoming fixture found for ${code}.`,
         installLine: `npx @claudinho/cli next ${code}`,
         tz: args.tz,
         locale: args.lang
@@ -6187,7 +6415,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.9.4";
+var SERVER_VERSION = "0.10.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.
@@ -6638,7 +6866,7 @@ function buildServer() {
     },
     async (uri, variables) => {
       const group = String(variables.group ?? "");
-      const text = await standingsResourceText(group, makeAdapter());
+      const text = await standingsResourceText(group, resolveAdapter({}));
       return { contents: [{ uri: uri.href, mimeType: "text/plain", text }] };
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.9.4",
+  "version": "0.10.1",
   "mcpName": "io.github.arturogarrido/claudinho",
   "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",
@@ -51,15 +51,15 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "zod": "^3.25.0"
+    "zod": "^4.6.2"
   },
   "devDependencies": {
-    "@types/node": "^22.20.1",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@types/node": "^22.20.2",
+    "@vitest/coverage-v8": "^5.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
-    "vitest": "^4.1.10",
-    "@claudinho/core": "0.9.4"
+    "vitest": "^5.0.0",
+    "@claudinho/core": "0.10.1"
   },
   "scripts": {
     "build": "tsup",