@mauricode/token-derby 2.12.4 → 2.13.0

package/README.md

@@ -64,6 +64,16 @@ The CLI sums `message.usage.output_tokens` across every `*.jsonl` under `~/.clau
 
 Races can optionally also count *fresh input tokens* — i.e. `input_tokens + cache_creation_input_tokens` (your new context this turn) in addition to output. `cache_read_input_tokens` is never counted, since those reflect passive context size rather than work. The race creator opts in at `token-derby create` time; thresholds for Stampede!, Pulled Away!, and the heartbeat rate cap scale 10× in these races so the achievement cadence stays comparable.
 
+## Stamina
+
+Some races turn on stamina. Push a horse far above a sustainable pace and it tires — its tokens still count, but at a fraction of face value until it recovers. A normal working pace never triggers this; stamina only bites once you're running well past what the race considers sustainable.
+
+Staying connected and easing off is how you recover. Disconnecting does not — a long gap since your last heartbeat earns the same recovery as one ordinary tick, not a bonus for the time you were away, so crashing is not a rest strategy. That's on top of the crash penalty above: you lose the tokens from the gap *and* you don't recover any faster for it.
+
+Nothing here asks you to hold work back. A flat-out day still beats a lazy one — it just doesn't beat it by as much as the raw token count would suggest once your horse tires.
+
+Stamina is off by default; org owners turn it on and tune it from the Race Settings tab of `token-derby web`. When it's on, the live view shows your horse's stamina as a percentage and bar, plus a multiplier once you're actually losing score to fatigue.
+
 ## Other models (Codex, Gemini)
 
 At join you pick one **primary** model — Claude, Codex, or Gemini — counted 1:1.

package/dist/bin.js

@@ -252,6 +252,39 @@ function toTag(c, y) {
   }
 }
 
+// ../shared/dist/scoring.js
+function scoredOf(horse) {
+  return horse.scored_tokens ?? horse.current_tokens;
+}
+var STAMINA = {
+  SUSTAINABLE_PACE: 4e3,
+  DRAIN_PER_MIN: 4,
+  MAX_DRAIN_PER_MIN: 6,
+  RECOVER_PER_MIN: 2,
+  RECOVER_TICK_CAP_MS: 9e4,
+  TAPER_FLOOR: 25,
+  TIRED_MULTIPLIER: 0.5
+};
+function resolveStaminaConfig(race) {
+  const c = race.stamina_config ?? {};
+  return {
+    sustainable_pace: c.sustainable_pace ?? STAMINA.SUSTAINABLE_PACE,
+    drain_per_min: c.drain_per_min ?? STAMINA.DRAIN_PER_MIN,
+    max_drain_per_min: c.max_drain_per_min ?? STAMINA.MAX_DRAIN_PER_MIN,
+    recover_per_min: c.recover_per_min ?? STAMINA.RECOVER_PER_MIN,
+    taper_floor: c.taper_floor ?? STAMINA.TAPER_FLOOR,
+    tired_multiplier: c.tired_multiplier ?? STAMINA.TIRED_MULTIPLIER
+  };
+}
+var STAMINA_PARAM_BOUNDS = {
+  sustainable_pace: { min: 1e3, max: 2e4, step: 250, default: STAMINA.SUSTAINABLE_PACE },
+  drain_per_min: { min: 1, max: 12, step: 1, default: STAMINA.DRAIN_PER_MIN },
+  max_drain_per_min: { min: 2, max: 20, step: 1, default: STAMINA.MAX_DRAIN_PER_MIN },
+  recover_per_min: { min: 1, max: 8, step: 1, default: STAMINA.RECOVER_PER_MIN },
+  taper_floor: { min: 10, max: 60, step: 5, default: STAMINA.TAPER_FLOOR },
+  tired_multiplier: { min: 0.2, max: 0.9, step: 0.05, default: STAMINA.TIRED_MULTIPLIER }
+};
+
 // src/ui/HorseSprite.tsx
 import { Box, Text } from "ink";
 
@@ -788,8 +821,8 @@ var HEARTBEAT_RETRY_DELAYS_MS = [1e3, 2e3, 4e3, 8e3, 15e3];
 // src/version.ts
 import { createRequire } from "module";
 function readVersion() {
-  if ("2.12.4".length > 0) {
-    return "2.12.4";
+  if ("2.13.0".length > 0) {
+    return "2.13.0";
   }
   try {
     const req = createRequire(import.meta.url);
@@ -1326,6 +1359,8 @@ async function createRaceCommand(organisationName) {
     const counts_input = countInputRaw === "y" || countInputRaw === "yes";
     const top5Raw = (await rl.question("Count only each racer's 5 most-active conversations toward their primary model's score? [y/N]: ")).trim().toLowerCase();
     const primary_top5 = top5Raw === "y" || top5Raw === "yes";
+    const staminaRaw = (await rl.question("Stamina \u2014 horses that run flat out tire and score less until they recover? [y/N]: ")).trim().toLowerCase();
+    const stamina = staminaRaw === "y" || staminaRaw === "yes";
     const resp = await createRace({
       name,
       start_time: start,
@@ -1334,7 +1369,8 @@ async function createRaceCommand(organisationName) {
       ...max !== void 0 ? { max_participants: max } : {},
       ...org ? { organisation_name: org } : {},
       ...counts_input ? { counts_input: true } : {},
-      ...primary_top5 ? { primary_top5: true } : {}
+      ...primary_top5 ? { primary_top5: true } : {},
+      ...stamina ? { stamina: true } : {}
     });
     console.log("");
     console.log("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
@@ -1353,6 +1389,9 @@ async function createRaceCommand(organisationName) {
     if (primary_top5) {
       console.log("  Primary score counts only each racer's top 5 conversations per beat.");
     }
+    if (stamina) {
+      console.log("  Stamina on \u2014 horses running above a sustainable pace will tire.");
+    }
     console.log(`  Share with participants:  token-derby join ${resp.join_code}`);
     return 0;
   } catch (e) {
@@ -1442,8 +1481,10 @@ function StatusScreen(props) {
   const divisionField = own?.division === void 0 ? [] : race.horses.filter((h) => h.division === own.division);
   const divisionRank = own ? divisionField.indexOf(own) + 1 : 0;
   const showDivision = (race.league_division_names?.length ?? 0) > 0 && divisionRank > 0;
+  const staminaRow = race.stamina === true ? staminaLine(own, race) : null;
   const rows = [
-    { label: "Tokens (race):", value: String(own?.current_tokens ?? 0) },
+    { label: "Tokens (race):", value: String(own?.final_scored_tokens ?? (own ? scoredOf(own) : 0)) },
+    ...staminaRow ? [staminaRow] : [],
     { label: "Position:", value: `${own?.rank ?? "\u2014"} of ${race.horses.length}` },
     ...showDivision ? [{ label: "Position (Division):", value: `${divisionRank} of ${divisionField.length}` }] : [],
     { label: "Leader:", value: leaderText(leader) },
@@ -1514,7 +1555,7 @@ function StatLines(props) {
 }
 function leaderText(h) {
   if (!h) return "\u2014";
-  return `${h.name}${h.user_name ? ` (${h.user_name})` : ""} \u2014 ${h.current_tokens}`;
+  return `${h.name}${h.user_name ? ` (${h.user_name})` : ""} \u2014 ${h.final_scored_tokens ?? scoredOf(h)}`;
 }
 function elapsed(race) {
   const start = new Date(race.start_time).getTime();
@@ -1528,6 +1569,22 @@ function bar(pct, width) {
   const filled = Math.round(pct * width);
   return "\u2593".repeat(filled) + "\u2591".repeat(width - filled);
 }
+function staminaLine(own, race) {
+  const stamina = own?.stamina ?? 100;
+  const cfg = resolveStaminaConfig(race);
+  const floor = cfg.taper_floor;
+  const band = stamina > 50 ? "green" : stamina >= floor ? "amber" : "red";
+  const color = band === "green" ? "green" : band === "amber" ? "yellow" : "red";
+  const pct = Math.max(0, Math.min(1, stamina / 100));
+  const multiplier = band === "red" ? cfg.tired_multiplier + (1 - cfg.tired_multiplier) * (stamina / floor) : null;
+  return {
+    label: "Stamina:",
+    value: /* @__PURE__ */ jsxs5(Text7, { color, children: [
+      `${Math.round(stamina)}%  ${bar(pct, 20)}`,
+      multiplier !== null ? `  \xD7${multiplier.toFixed(2)}` : ""
+    ] })
+  };
+}
 function statusColor(status) {
   if (status === "live") return "green";
   if (status === "pending") return "yellow";