@claudinho/mcp 0.11.1 → 0.11.2

package/dist/index.js

@@ -769,7 +769,7 @@ function formatTime(iso, opts = {}) {
   }).format(when);
 }
 var COUNTDOWN_NOW = "now";
-function countdown(iso, from = /* @__PURE__ */ new Date()) {
+function countdown(iso, from) {
   const when = parsedDate(iso);
   if (!when) return UNKNOWN_TIME;
   const ms = when.getTime() - from.getTime();
@@ -782,7 +782,7 @@ function countdown(iso, from = /* @__PURE__ */ new Date()) {
   if (hours > 0) return `${hours}h${mins}m`;
   return `${mins}m`;
 }
-function countdownPhrase(lang, iso, from = /* @__PURE__ */ new Date()) {
+function countdownPhrase(lang, iso, from) {
   const left = countdown(iso, from);
   return left === COUNTDOWN_NOW ? t(lang, "countdown.now") : t(lang, "next.in", { countdown: left });
 }
@@ -4728,7 +4728,7 @@ function fetchMeta(result) {
 }
 var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = BUNDLED_SLUG;
-var USER_AGENT = `claudinho/${"0.11.1"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.11.2"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 var DEFAULT_COOLDOWN_MS = 5 * 6e4;
 var MAX_COOLDOWN_MS = 15 * 6e4;
@@ -6217,6 +6217,9 @@ function mergeLive(base, live) {
 function clockOf(adapter) {
   return new Date(adapter.now?.() ?? Date.now());
 }
+function requestClock(adapter, given) {
+  return given ?? clockOf(adapter);
+}
 function providerDayOf(adapter, instant) {
   if (Number.isNaN(instant.getTime())) return "";
   return adapter.bucketDay?.(instant) || instant.toISOString().slice(0, 10);
@@ -6391,7 +6394,7 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   });
   let refreshRead = {};
   if (candidate) {
-    const { partial, served: _served, ...r } = await getMatchById(adapter, candidate.id);
+    const { partial, served: _served, ...r } = await getMatchById(adapter, candidate.id, now);
     refreshRead = partial ? { partial } : {};
     const m = r.degraded ? candidate : r.match ?? candidate;
     if (!isFinished(m.status)) return { ...r, match: m, ...bothReads(windowRead, refreshRead) };
@@ -8079,13 +8082,13 @@ var STATUS_KEY = {
 function flairOptsOf(opts) {
   return { level: opts.flavor, locale: opts.locale, kind: opts.teamKind, pin: opts.pin };
 }
-function matchLine(m, opts = {}, flair = matchFlair(m, flairOptsOf(opts))) {
+function matchLine(m, opts, flair = matchFlair(m, flairOptsOf(opts))) {
   const head = `${withFlag(m.home.name, m.home.flag, "home")} ${scoreline(m)} ${withFlag(m.away.name, m.away.flag, "away")}`;
   const lang = opts.locale;
   const stage = stageLabelI18n(lang, m);
   let tail;
   if (m.status === "SCHEDULED") {
-    tail = `${formatKickoff(m.kickoff, opts)} (${countdownPhrase(lang, m.kickoff)})`;
+    tail = `${formatKickoff(m.kickoff, opts)} (${countdownPhrase(lang, m.kickoff, opts.now)})`;
   } else if (m.status === "LIVE") {
     tail = m.minute ? `${t(lang, "status.live")} ${m.minute}'` : t(lang, "status.live");
   } else {
@@ -8104,7 +8107,7 @@ function truncationNote(list) {
 function headingLine(lang, title) {
   return t(lang, "heading", { title });
 }
-function matchRows(matches, empty, opts = {}) {
+function matchRows(matches, empty, opts) {
   if (matches.length === 0) return empty;
   const shown = matches.slice(0, MAX_LIST_MATCHES);
   const flairs = matchFlairs(shown, flairOptsOf(opts));
@@ -8114,7 +8117,7 @@ function listTruncation(matches) {
   const overflow = matches.length - MAX_LIST_MATCHES;
   return overflow > 0 ? `(list truncated \u2014 ${overflow} more not shown)` : void 0;
 }
-function matchList(matches, empty, opts = {}) {
+function matchList(matches, empty, opts) {
   const rows = matchRows(matches, empty, opts);
   const truncated = listTruncation(matches);
   return truncated ? `${rows}
@@ -8370,9 +8373,8 @@ async function cachedMarketSignals(args, matches, providerFactory = makeMarketPr
   }
   return { signals: result, complete };
 }
-async function reliableMarketData(args, matches) {
+async function reliableMarketData(args, matches, now) {
   if (!marketsEnabled()) return { data: void 0, complete: true };
-  const now = args.now ?? /* @__PURE__ */ new Date();
   const relevant = matches.filter((m) => marketRelevant(m, now));
   if (relevant.length === 0) return { data: void 0, complete: true };
   const result = await cachedMarketSignals(args, relevant);
@@ -8388,9 +8390,11 @@ async function reliableMarketData(args, matches) {
     complete: result.complete
   };
 }
-function fmtOpts(args, competition) {
+function fmtOpts(args, competition, now) {
   const pin = choiceOf(args).pin;
   return {
+    // The tool's clock, read once where the tool reads it: a line's countdown is relative to it.
+    now,
     tz: args.tz,
     locale: args.lang,
     flavor: asFlavorLevel(args.flavor ?? process.env.CLAUDINHO_FLAVOR),
@@ -8431,17 +8435,18 @@ function toolGetToday(args) {
 }
 async function todayAnswer(args) {
   const adapter = resolveAdapter(args);
-  const date = args.date ?? localDate((args.now ?? /* @__PURE__ */ new Date()).toISOString(), args.tz);
+  const now = requestClock(adapter, args.now);
+  const date = args.date ?? localDate(now.toISOString(), args.tz);
   const day = await getMatchesForDate(adapter, date, resolveTz(args.tz));
   const { matches, degraded, source } = day;
   const todays = fixturesByDate(date, matches, args.tz);
   const shownToday = boundedRecords(todays);
-  const opts = fmtOpts(args, adapter.competition);
+  const opts = fmtOpts(args, adapter.competition, now);
   const empty = verdictNotice(day, args.lang) ?? dateUnreached(day, date, args.lang) ?? dateNoneRead(day, date, args.lang) ?? t(args.lang, "today.none");
   const text = `${headingLine(args.lang, t(args.lang, "today.onDate", { date }))}
 ${matchRows(todays, empty, opts)}`;
   const degradedLine = degraded ? `(${t(args.lang, day.skeleton ? "feed.degraded" : "live.degraded")})` : void 0;
-  const market = await reliableMarketData(args, todays);
+  const market = await reliableMarketData(args, todays, now);
   const marketLine2 = market.complete ? void 0 : "(Market data unavailable or incomplete \u2014 not all fixtures were checked.)";
   const attribution = dayAttribution(day, shownToday.items, args.lang);
   return {
@@ -8479,9 +8484,10 @@ function toolGetLive(args = {}) {
 }
 async function liveAnswer(args) {
   const adapter = resolveAdapter(args);
-  const live = await getLiveMatches(adapter, args.now ?? /* @__PURE__ */ new Date());
+  const now = requestClock(adapter, args.now);
+  const live = await getLiveMatches(adapter, now);
   const { matches, degraded, source } = live;
-  const opts = fmtOpts(args, adapter.competition);
+  const opts = fmtOpts(args, adapter.competition, now);
   const text = degraded ? t(args.lang, "live.degraded") : `${headingLine(args.lang, t(args.lang, "live.title"))}
 ${matchRows(matches, verdictNotice(live, args.lang) ?? liveNoneRead(live, args.lang) ?? t(args.lang, "live.none"), opts)}`;
   const shownLive = boundedRecords(matches);
@@ -8504,7 +8510,8 @@ function toolGetMatch(args) {
 }
 async function matchAnswer(args) {
   const adapter = resolveAdapter(args);
-  const found = await getMatchById(adapter, args.id, args.now);
+  const now = requestClock(adapter, args.now);
+  const found = await getMatchById(adapter, args.id, now);
   const { match, degraded, source: liveSource } = found;
   if (!match) {
     const msg = verdictNotice(found, args.lang) ?? matchWindowSentence(found, args.id, args.lang) ?? matchNoneReadSentence(found, args.id, args.lang) ?? t(args.lang, degraded ? "match.unreachable" : "match.none", { id: args.id });
@@ -8520,8 +8527,7 @@ async function matchAnswer(args) {
       }
     };
   }
-  const opts = fmtOpts(args, adapter.competition);
-  const now = args.now ?? /* @__PURE__ */ new Date();
+  const opts = fmtOpts(args, adapter.competition, now);
   let marketSignal;
   let marketComplete = true;
   if (marketsEnabled() && marketRelevant(match, now)) {
@@ -8696,7 +8702,7 @@ async function nextAnswer(args) {
   if (!query) throw new Error(NO_TEAM);
   const asked = pin ? { code: query } : bundleApplies(adapter.competition) ? nationArg(query) : { code: query };
   const code = "code" in asked ? asked.code : query;
-  const now = args.now ?? /* @__PURE__ */ new Date();
+  const now = requestClock(adapter, args.now);
   const next = pin ? await nextFixtureForPin(adapter, pin, now) : "code" in asked ? await getNextFixtureForTeam(adapter, code, now) : asked.answer;
   const { fixture, degraded, source } = next;
   const label = nextTeamLabel(next, code);
@@ -8716,7 +8722,7 @@ ${msg}`, next, args.lang), void 0, args.lang),
       data: { ...about, fixture: null, degraded, source: source ?? null, ...verdictExtras(next) }
     };
   }
-  const opts = fmtOpts(args, adapter.competition);
+  const opts = fmtOpts(args, adapter.competition, now);
   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).
@@ -8760,7 +8766,6 @@ function toolGetMarketSignal(args) {
 }
 async function marketAnswer(args) {
   const provider = resolveMarketProvider(args);
-  const now = args.now ?? /* @__PURE__ */ new Date();
   if (args.matchId) {
     const scope = marketScopeVerdict(competitionOf(args), 0);
     const outOfScope = verdictNotice(scope, args.lang);
@@ -8776,13 +8781,15 @@ async function marketAnswer(args) {
         }
       };
     }
-    const found = await getMatchById(resolveAdapter(args), args.matchId);
+    const adapter2 = resolveAdapter(args);
+    const now2 = requestClock(adapter2, args.now);
+    const found = await getMatchById(adapter2, args.matchId, now2);
     const { match } = found;
-    const relevant = match ? marketRelevant(match, now) : false;
+    const relevant = match ? marketRelevant(match, now2) : 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 ? verdictNotice(found, args.lang) ?? `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 ? verdictNotice(found, args.lang) ?? `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, now2);
     return {
       // The fixture read was not whole: said first, apart from `complete`
       // (the market requests' own completeness).
@@ -8798,13 +8805,15 @@ async function marketAnswer(args) {
   }
   if (args.team) {
     const code = args.team.toUpperCase();
-    const picked = await marketFixtureForTeam(resolveAdapter(args), code, now);
+    const adapter2 = resolveAdapter(args);
+    const now2 = requestClock(adapter2, args.now);
+    const picked = await marketFixtureForTeam(adapter2, code, now2);
     const { match: fixture, degraded } = picked;
-    const relevant = fixture ? marketRelevant(fixture, now) : false;
+    const relevant = fixture ? marketRelevant(fixture, now2) : 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 ? verdictNotice(picked, args.lang) ?? (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 ? verdictNotice(picked, args.lang) ?? (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, now2);
     return {
       // Either read the pick was made from was not whole: said first, apart
       // from `complete` (the market requests' own completeness).
@@ -8820,8 +8829,10 @@ async function marketAnswer(args) {
       }
     };
   }
+  const adapter = resolveAdapter(args);
+  const now = requestClock(adapter, args.now);
   const date = args.date ?? localDate(now.toISOString(), args.tz);
-  const day = await getMatchesForDate(resolveAdapter(args), date, resolveTz(args.tz));
+  const day = await getMatchesForDate(adapter, date, resolveTz(args.tz));
   const fixtureRead = marketsCoverCompetition(competitionOf(args)) ? day : {};
   const todays = fixturesByDate(date, day.matches, args.tz).filter((m) => marketRelevant(m, now));
   const batch = await getMarketSignals(provider, todays, MARKETS_TOOL_OPTS);
@@ -8863,9 +8874,8 @@ ${shown.items.map(({ match, signal }) => marketText(match, signal, args)).join("
     }
   };
 }
-async function reliableSignalMap(args, matches) {
+async function reliableSignalMap(args, matches, now) {
   if (!marketsEnabled()) return { signals: /* @__PURE__ */ new Map(), complete: true };
-  const now = args.now ?? /* @__PURE__ */ new Date();
   const relevant = matches.filter((m) => marketRelevant(m, now));
   if (relevant.length === 0) return { signals: /* @__PURE__ */ new Map(), complete: true };
   const result = await cachedMarketSignals(args, relevant);
@@ -8938,11 +8948,12 @@ function shareKindAsked(args) {
 }
 async function shareAnswer(args) {
   const options = shareOptions(args);
-  const signalsFor = (ms) => args.includeMarkets === false ? Promise.resolve({ signals: /* @__PURE__ */ new Map(), complete: true }) : reliableSignalMap(args, ms);
+  const signalsFor = (ms, now2) => args.includeMarkets === false ? Promise.resolve({ signals: /* @__PURE__ */ new Map(), complete: true }) : reliableSignalMap(args, ms, now2);
   const competition = selectedOf(args).slug;
   const where = { tz: args.tz, locale: args.lang, competition };
   if (args.live) {
-    const live = await getLiveMatches(resolveAdapter(args), args.now ?? /* @__PURE__ */ new Date());
+    const adapter2 = resolveAdapter(args);
+    const live = await getLiveMatches(adapter2, requestClock(adapter2, args.now));
     const shownLive = boundedRecords(live.matches);
     return shareResult(
       liveShareCard(live, where, {
@@ -9012,24 +9023,29 @@ async function shareAnswer(args) {
     };
   }
   if (args.matchId) {
-    const found = await getMatchById(resolveAdapter(args), args.matchId, args.now);
-    const market2 = await signalsFor(found.match ? [found.match] : []);
+    const adapter2 = resolveAdapter(args);
+    const now2 = requestClock(adapter2, args.now);
+    const found = await getMatchById(adapter2, args.matchId, now2);
+    const market2 = await signalsFor(found.match ? [found.match] : [], now2);
     return shareResult(matchShareCard(found, args.matchId, market2, where), options);
   }
   if (args.team) {
-    const adapter = resolveAdapter(args);
+    const adapter2 = resolveAdapter(args);
     const query = humanLabel(args.team, 40);
-    const asked = bundleApplies(adapter.competition) ? nationArg(query) : { code: query };
+    const asked = bundleApplies(adapter2.competition) ? nationArg(query) : { code: query };
     const code = "code" in asked ? asked.code : query;
-    const next = "code" in asked ? await getNextFixtureForTeam(adapter, code, args.now ?? /* @__PURE__ */ new Date()) : asked.answer;
-    const market2 = await signalsFor(next.fixture ? [next.fixture] : []);
+    const now2 = requestClock(adapter2, args.now);
+    const next = "code" in asked ? await getNextFixtureForTeam(adapter2, code, now2) : asked.answer;
+    const market2 = await signalsFor(next.fixture ? [next.fixture] : [], now2);
     return shareResult(nextShareCard(next, code, market2, where), options);
   }
-  const date = args.date ?? localDate((args.now ?? /* @__PURE__ */ new Date()).toISOString(), args.tz);
-  const day = await getMatchesForDate(resolveAdapter(args), date, resolveTz(args.tz));
+  const adapter = resolveAdapter(args);
+  const now = requestClock(adapter, args.now);
+  const date = args.date ?? localDate(now.toISOString(), args.tz);
+  const day = await getMatchesForDate(adapter, date, resolveTz(args.tz));
   const todays = fixturesByDate(date, day.matches, args.tz);
   const shownToday = boundedRecords(todays);
-  const market = await signalsFor(shownToday.items);
+  const market = await signalsFor(shownToday.items, now);
   return shareResult(
     dateShareCard(
       {
@@ -9055,7 +9071,7 @@ async function shareAnswer(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.11.1";
+var SERVER_VERSION = "0.11.2";
 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!"): 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 standings for one football competition per request, chosen by the tool call's competition argument (an alias such as premier-league, or an ESPN slug such as eng.1), else the server's CLAUDINHO_COMPETITION, else the user's saved choice (set with claudinho follow <alias>). With none of the three, every competition-answering tool answers noCompetition with a sentence saying what to do: pass competition, or ask the user to run claudinho follow <alias>. list_competitions lists the supported competitions, their aliases and what each offers, offline. Every tool's text but get_team's, get_share_snippet's and list_competitions' starts with the competition it is for, and its structured data carries it as competition (get_share_snippet's card names it in its title; list_competitions says it last, as Current, and in data.current; get_team is the World Cup's roster). An unknown competition is a tool error that lists the aliases.
@@ -9674,8 +9690,9 @@ function buildServer() {
     },
     async (uri, variables) => {
       const date = String(variables.date ?? "");
+      const now = /* @__PURE__ */ new Date();
       const text = `${competitionLabel(BUNDLE_COMPETITION)}
-${matchList(fixturesByDate(date, void 0, "UTC"), `No matches on ${date}.`)}`;
+${matchList(fixturesByDate(date, void 0, "UTC"), `No matches on ${date}.`, { now })}`;
       return { contents: [{ uri: uri.href, mimeType: "text/plain", text }] };
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "mcpName": "io.github.arturogarrido/claudinho",
   "description": "An MCP server with live football scores, fixtures, standings and paste-ready match cards for the competition you follow: the World Cup, the Premier League, LALIGA, the Champions League and 12 more. Works with Claude Code, Cursor, Codex, Claude Desktop, Windsurf, Zed and any MCP client. No API key. Independent fan project. Not affiliated with FIFA, any confederation, league or club, or Anthropic.",
   "type": "module",
@@ -73,7 +73,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^5.0.3",
-    "@claudinho/core": "0.11.1"
+    "@claudinho/core": "0.11.2"
   },
   "scripts": {
     "build": "tsup",