@mrciphersmith/keryx 0.2.61 → 0.2.62

package/dist/cli.js

@@ -10173,7 +10173,90 @@ async function resolveModelsForPicker(fetchFn, provider, env = process.env, opts
   const apiKey = typeof raw === "string" && raw.length > 0 ? raw : undefined;
   return fetchOpenAiCompatModelsDetailed(fetchFn, { ...compat, ...provider.baseUrl !== undefined ? { baseUrl: provider.baseUrl } : {} }, apiKey, opts);
 }
-var DEFAULT_MODELS_PATH = "/v1/models", OPENAI_COMPAT_PROVIDERS, MODELS_FETCH_TIMEOUT_MS = 1e4;
+function balanceCapableProvider(name) {
+  const provider = providerByName(name);
+  if (provider === undefined || provider.balancePath === undefined || provider.balanceKind === undefined) {
+    return;
+  }
+  return provider;
+}
+function parseDeepSeekBalance(body) {
+  if (typeof body !== "object" || body === null) {
+    return;
+  }
+  const infos = body.balance_infos;
+  if (!Array.isArray(infos)) {
+    return;
+  }
+  for (const info of infos) {
+    if (typeof info !== "object" || info === null) {
+      continue;
+    }
+    const total = Number(info.total_balance);
+    if (Number.isFinite(total)) {
+      const currency = String(info.currency ?? "USD");
+      return { currency, total, exact: true };
+    }
+  }
+  return;
+}
+function parseOpenRouterBalance(body) {
+  if (typeof body !== "object" || body === null) {
+    return;
+  }
+  const credits = body.credits;
+  if (typeof credits !== "object" || credits === null) {
+    return;
+  }
+  const total = Number(credits.total);
+  const used = Number(credits.used);
+  if (!Number.isFinite(total)) {
+    return;
+  }
+  const usedField = Number.isFinite(used) ? { used } : {};
+  const remaining = Number.isFinite(used) ? total - used : undefined;
+  return {
+    currency: String(credits.currency ?? "USD"),
+    total,
+    ...usedField,
+    ...remaining !== undefined ? { remaining } : {},
+    exact: true
+  };
+}
+async function fetchProviderBalance(fetchFn, provider, apiKey, opts) {
+  if (provider.balancePath === undefined || provider.balanceKind === undefined) {
+    return;
+  }
+  const url = `${provider.baseUrl.replace(/\/+$/, "")}${provider.balancePath}`;
+  const timeoutMs = opts?.timeoutMs ?? BALANCE_FETCH_TIMEOUT_MS;
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const init = { signal: controller.signal };
+    if (apiKey !== undefined && apiKey.length > 0) {
+      init.headers = { authorization: `Bearer ${apiKey}` };
+    }
+    const res = await fetchFn(url, init);
+    if (!res.ok) {
+      return;
+    }
+    const body = await res.json();
+    return provider.balanceKind === "deepseek" ? parseDeepSeekBalance(body) : parseOpenRouterBalance(body);
+  } catch {
+    return;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function providerApiKey(provider, env = process.env) {
+  const envKey = provider.envKey;
+  if (envKey === undefined) {
+    return;
+  }
+  const raw = env[envKey];
+  return typeof raw === "string" && raw.length > 0 ? raw : undefined;
+}
+var DEFAULT_MODELS_PATH = "/v1/models", OPENAI_COMPAT_PROVIDERS, MODELS_FETCH_TIMEOUT_MS = 1e4, BALANCE_FETCH_TIMEOUT_MS = 8000;
 var init_providers = __esm(() => {
   OPENAI_COMPAT_PROVIDERS = [
     {
@@ -10182,7 +10265,9 @@ var init_providers = __esm(() => {
       baseUrl: "https://openrouter.ai/api",
       envKey: "OPENROUTER_API_KEY",
       models: ["openai/gpt-4o-mini", "google/gemini-2.0-flash-001", "qwen/qwen-2.5-7b-instruct", "meta-llama/llama-3.1-8b-instruct"],
-      note: "hosted \xB7 400+ models"
+      note: "hosted \xB7 400+ models",
+      balancePath: "/api/v1/credits",
+      balanceKind: "openrouter"
     },
     {
       name: "deepseek",
@@ -10190,7 +10275,9 @@ var init_providers = __esm(() => {
       baseUrl: "https://api.deepseek.com",
       envKey: "DEEPSEEK_API_KEY",
       models: ["deepseek-chat", "deepseek-reasoner"],
-      note: "cheap per-token"
+      note: "cheap per-token",
+      balancePath: "/user/balance",
+      balanceKind: "deepseek"
     },
     {
       name: "zai",
@@ -13121,14 +13208,29 @@ async function runModelTurn(input2) {
   };
   let text = "";
   let error;
+  let usage;
+  let reasoning = false;
+  const startedAt = performance.now();
+  let firstByteAt;
   for await (const event of port.stream(request, { attemptId: request.requestId })) {
+    if (firstByteAt === undefined) {
+      firstByteAt = performance.now();
+    }
     if (event.kind === "text_delta" && event.text) {
       text += event.text;
     } else if (event.kind === "provider_error" && event.error) {
       error = event.error;
+    } else if (event.kind === "reasoning_delta") {
+      reasoning = true;
+    } else if (event.kind === "usage_update" && event.usage) {
+      usage = event.usage;
     }
   }
-  return error ? { provider, model, credentialAvailable, text, error } : { provider, model, credentialAvailable, text };
+  const latencyMs = firstByteAt !== undefined ? Math.max(0, Math.round(firstByteAt - startedAt)) : undefined;
+  const usageField = usage !== undefined ? { usage } : {};
+  const latencyField = latencyMs !== undefined ? { latencyMs } : {};
+  const reasoningField = reasoning ? { reasoning } : {};
+  return error ? { provider, model, credentialAvailable, text, error, ...usageField, ...latencyField, ...reasoningField } : { provider, model, credentialAvailable, text, ...usageField, ...latencyField, ...reasoningField };
 }
 var DEFAULT_PROVIDER = "anthropic", DEFAULT_MODELS;
 var init_single_turn = __esm(() => {
@@ -53454,7 +53556,7 @@ import { spawnSync as spawnSync2 } from "child_process";
 // package.json
 var package_default = {
   name: "@mrciphersmith/keryx",
-  version: "0.2.61",
+  version: "0.2.62",
   description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   private: false,
   publishConfig: {
@@ -57032,7 +57134,7 @@ var AGENT_SLASH_COMMANDS = [
   { name: "/theme", description: "Open the theme picker \u2014 /theme [name] applies immediately", modes: BOTH },
   {
     name: "/game",
-    description: "Play tic-tac-toe against the model \u2014 the game minimizes while the agent works",
+    description: "Games against the model \u2014 /game [seconds] raises the model-turn deadline; add games via src/tui/games/",
     modes: AGENT_ONLY
   },
   {
@@ -57413,8 +57515,75 @@ function openThemePicker(otui, chrome, options) {
   return presentThemePicker((hostOtui, hostChrome, input2) => openModal(hostOtui, hostChrome, input2), otui, chrome, options);
 }
 
-// src/tui/game-modal.ts
-init_single_turn();
+// src/tui/games/registry.ts
+function createRegistry(games) {
+  return {
+    games,
+    get(id) {
+      return games.find((game) => game.id === id);
+    }
+  };
+}
+
+// src/tui/games/stats.ts
+function emptyTurnTotals() {
+  return {
+    turns: 0,
+    latencyMs: undefined,
+    totalMs: undefined,
+    inputTokens: undefined,
+    outputTokens: undefined,
+    localFallbacks: 0,
+    errors: 0
+  };
+}
+function addMaybe(a, b) {
+  if (a === undefined && b === undefined) {
+    return;
+  }
+  return (a ?? 0) + (b ?? 0);
+}
+function addTurn(totals, turn) {
+  return {
+    turns: totals.turns + 1,
+    latencyMs: addMaybe(totals.latencyMs, turn.latencyMs),
+    totalMs: addMaybe(totals.totalMs, turn.totalMs),
+    inputTokens: addMaybe(totals.inputTokens, turn.inputTokens),
+    outputTokens: addMaybe(totals.outputTokens, turn.outputTokens),
+    localFallbacks: totals.localFallbacks + (turn.localFallback ? 1 : 0),
+    errors: totals.errors + (turn.error ? 1 : 0)
+  };
+}
+function formatMs(ms) {
+  if (ms === undefined) {
+    return "\u2013";
+  }
+  if (ms < 1000) {
+    return `${ms}ms`;
+  }
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+function formatTokens(n) {
+  if (n === undefined) {
+    return "\u2013";
+  }
+  if (n < 1000) {
+    return `${n}`;
+  }
+  return `${(n / 1000).toFixed(1)}k`;
+}
+
+// src/tui/games/constants.ts
+var GAME_MODEL_TIMEOUT_MS = 60000;
+var GAMES_FOOTER = [
+  { key: "h/l", label: "move" },
+  { key: "enter", label: "place" },
+  { key: "r", label: "new game" },
+  { key: "\u2190/\u2192", label: "games" },
+  { key: "esc", label: "minimize" }
+];
+
+// src/tui/games/tic-tac-toe/core.ts
 var WIN_LINES = [
   [0, 1, 2],
   [3, 4, 5],
@@ -57444,6 +57613,29 @@ function checkWinner(board) {
 function freeCells(board) {
   return board.flatMap((cell, index) => cell === null ? [index] : []);
 }
+function placeMark(board, index, mark) {
+  if (index < 0 || index > 8 || board[index] !== null) {
+    return;
+  }
+  const next = board.slice();
+  next[index] = mark;
+  const win = checkWinner(next);
+  const draw = win === null && next.every((cell) => cell !== null);
+  return {
+    board: next,
+    turn: win === null && !draw ? mark === "X" ? "O" : "X" : mark,
+    winner: win?.winner ?? null,
+    winLine: win?.line ?? null,
+    draw,
+    cursor: index
+  };
+}
+function freshGame() {
+  return { board: emptyBoard(), turn: "X", winner: null, winLine: null, draw: false, cursor: 4 };
+}
+function isGameOver(state) {
+  return state.winner !== null || state.draw;
+}
 function bestLocalMove(board, mark) {
   const free = freeCells(board);
   if (free.length === 0) {
@@ -57466,28 +57658,6 @@ function bestLocalMove(board, mark) {
   }
   return free[0];
 }
-function placeMark(board, index, mark) {
-  if (index < 0 || index > 8 || board[index] !== null) {
-    return;
-  }
-  const next = board.slice();
-  next[index] = mark;
-  const win = checkWinner(next);
-  const draw = win === null && next.every((cell) => cell !== null);
-  return {
-    board: next,
-    turn: win === null && !draw ? mark === "X" ? "O" : "X" : mark,
-    winner: win?.winner ?? null,
-    winLine: win?.line ?? null,
-    draw
-  };
-}
-function freshGame() {
-  return { board: emptyBoard(), turn: "X", winner: null, winLine: null, draw: false };
-}
-function isGameOver(state) {
-  return state.winner !== null || state.draw;
-}
 function parseModelMove(reply, board) {
   if (reply.length === 0) {
     return;
@@ -57499,6 +57669,11 @@ function parseModelMove(reply, board) {
   const index = Number(match[1]);
   return board[index] === null ? index : undefined;
 }
+function asTtt(state) {
+  return state;
+}
+
+// src/tui/games/tic-tac-toe/prompts.ts
 function gameSystemPrompt() {
   return [
     "You are playing tic-tac-toe as O against a human playing X.",
@@ -57520,31 +57695,43 @@ ${rows.join(`
 
 Make your move. Reply with one digit 0-8.`;
 }
-async function modelMove(board, opts = {}) {
-  const turn = await runModelTurn({
-    system: gameSystemPrompt(),
-    user: gameUserPrompt(board),
-    ...opts.provider !== undefined ? { provider: opts.provider } : {},
-    ...opts.model !== undefined ? { model: opts.model } : {},
-    maxOutputTokens: 256,
-    requestId: "keryx-game",
-    ...opts.providerFactory !== undefined ? { providerFactory: opts.providerFactory } : {},
-    ...opts.env !== undefined ? { env: opts.env } : {}
-  });
-  if (turn.error !== undefined) {
-    return { move: undefined, error: `model error: ${turn.error.message}` };
+
+// src/tui/games/tic-tac-toe/input.ts
+function wrapCursor(row, col) {
+  return (row + 3) % 3 * 3 + (col + 3) % 3;
+}
+function onKey(state, key) {
+  const name = key.name || key.sequence;
+  if (isGameOver(state)) {
+    return;
   }
-  if (!turn.credentialAvailable && opts.providerFactory === undefined) {
-    return { move: undefined, error: "no model credential \u2014 configure a provider first (/provider)" };
+  const row = Math.floor(state.cursor / 3);
+  const col = state.cursor % 3;
+  if (name === "up" || name === "k") {
+    return { ...state, cursor: wrapCursor(row - 1, col) };
   }
-  return { move: parseModelMove(turn.text, board), error: undefined };
+  if (name === "down" || name === "j") {
+    return { ...state, cursor: wrapCursor(row + 1, col) };
+  }
+  if (name === "left" || name === "h") {
+    return { ...state, cursor: wrapCursor(row, col - 1) };
+  }
+  if (name === "right" || name === "l") {
+    return { ...state, cursor: wrapCursor(row, col + 1) };
+  }
+  if (name === "return" || name === "enter" || name === "space" || name === " ") {
+    if (state.turn !== "X") {
+      return;
+    }
+    return placeMark(state.board, state.cursor, "X");
+  }
+  return;
 }
-var GAME_FOOTER = [
-  { key: "\u2190\u2191\u2193\u2192", label: "move" },
-  { key: "enter", label: "place" },
-  { key: "r", label: "new game" },
-  { key: "esc", label: "minimize" }
-];
+function markFor(player) {
+  return player === "human" ? "X" : "O";
+}
+
+// src/tui/games/tic-tac-toe/layout.ts
 var GAME_CELL_GAP = 1;
 var GAME_BOARD_CHROME_X = 4;
 var GAME_CELL_SIZES = {
@@ -57558,7 +57745,198 @@ function resolveCellSize(availableWidth) {
   const large = GAME_CELL_SIZES.large;
   return gameBoardWidth(large.width) <= availableWidth ? large : GAME_CELL_SIZES.small;
 }
-var GAME_MODEL_TIMEOUT_MS = 12000;
+
+// src/tui/games/tic-tac-toe/render.ts
+function markColor(mark, theme) {
+  return mark === "X" ? theme.ok ?? "" : theme.error ?? "";
+}
+function statusText(state) {
+  if (state.winner !== null) {
+    return `${state.winner} wins!  (r \u2014 new game)`;
+  }
+  if (state.draw) {
+    return "Draw!  (r \u2014 new game)";
+  }
+  return state.turn === "X" ? "Your turn \u2014 X" : "Agent's turn \u2014 O";
+}
+function render2(state, ctx) {
+  const core = ctx.core;
+  const r = ctx.renderer;
+  const theme = ctx.theme;
+  const cellSize = resolveCellSize(ctx.width);
+  const wrap2 = new core.BoxRenderable(r, {
+    id: "game-wrap",
+    width: "100%",
+    flexDirection: "column",
+    alignItems: "center"
+  });
+  const legend = new core.BoxRenderable(r, {
+    id: "game-legend",
+    flexDirection: "row",
+    marginBottom: 1
+  });
+  legend.add(new core.TextRenderable(r, { id: "game-legend-x", content: "X you", fg: theme.ok }));
+  legend.add(new core.TextRenderable(r, { id: "game-legend-sep", content: "  \xB7  ", fg: theme.muted }));
+  legend.add(new core.TextRenderable(r, { id: "game-legend-o", content: "O model", fg: theme.error }));
+  wrap2.add(legend);
+  const board = new core.BoxRenderable(r, {
+    id: "game-board",
+    flexDirection: "column",
+    flexShrink: 0,
+    border: true,
+    borderStyle: "rounded",
+    borderColor: theme.border,
+    backgroundColor: theme.panel,
+    paddingLeft: 1,
+    paddingRight: 1
+  });
+  for (let row = 0;row < 3; row++) {
+    const rowBox = new core.BoxRenderable(r, {
+      id: `game-row-${row}`,
+      flexDirection: "row",
+      flexShrink: 0,
+      gap: 1
+    });
+    for (let col = 0;col < 3; col++) {
+      const index = row * 3 + col;
+      const cell = state.board[index] ?? null;
+      const isCursor = index === state.cursor && !isGameOver(state);
+      const won = state.winLine?.includes(index) === true;
+      const cellBox = new core.BoxRenderable(r, {
+        id: `game-cell-${index}`,
+        width: cellSize.width,
+        height: cellSize.height,
+        flexShrink: 0,
+        flexGrow: 0,
+        flexDirection: "row",
+        alignItems: "center",
+        justifyContent: "center",
+        border: true,
+        borderStyle: "rounded",
+        borderColor: won ? markColor(state.winner ?? "X", theme) : isCursor ? theme.focus : theme.border,
+        backgroundColor: isCursor || won ? theme.highlight : undefined
+      });
+      const cellText = new core.TextRenderable(r, {
+        id: `game-cell-text-${index}`,
+        content: cell ?? "\xB7",
+        fg: cell === null ? theme.muted : markColor(cell, theme)
+      });
+      cellBox.add(cellText);
+      rowBox.add(cellBox);
+    }
+    board.add(rowBox);
+  }
+  wrap2.add(board);
+  wrap2.add(new core.TextRenderable(r, { id: "game-status", content: statusText(state), marginTop: 1 }));
+  ctx.parent.add(wrap2);
+}
+
+// src/tui/games/tic-tac-toe/game.ts
+function statusOf2(s) {
+  if (s.winner !== null) {
+    return `${s.winner} wins!  (r \u2014 new game)`;
+  }
+  if (s.draw) {
+    return "Draw!  (r \u2014 new game)";
+  }
+  return s.turn === "X" ? "Your turn \u2014 X" : "Agent's turn \u2014 O";
+}
+var ticTacToeGame = {
+  id: "tic-tac-toe",
+  label: "Tic-tac-toe",
+  fresh: () => freshGame(),
+  turn: (state) => asTtt(state).turn === "X" ? "human" : "model",
+  isOver: (state) => isGameOver(asTtt(state)),
+  outcome: (state) => {
+    const s = asTtt(state);
+    if (s.winner === "X") {
+      return "human";
+    }
+    if (s.winner === "O") {
+      return "model";
+    }
+    return s.draw ? "draw" : null;
+  },
+  status: (state) => statusOf2(asTtt(state)),
+  systemPrompt: () => gameSystemPrompt(),
+  stateForModel: (state) => gameUserPrompt(asTtt(state).board),
+  parseMove: (reply, state) => parseModelMove(reply, asTtt(state).board),
+  applyMove: (state, move, by) => placeMark(asTtt(state).board, move, markFor(by)),
+  localMove: (state, by) => bestLocalMove(asTtt(state).board, markFor(by)),
+  pass: (state) => {
+    const s = asTtt(state);
+    return { ...s, turn: s.turn === "X" ? "O" : "X" };
+  },
+  onKey: (state, key) => onKey(asTtt(state), key),
+  render: (state, ctx) => render2(asTtt(state), ctx)
+};
+// src/tui/games/model-turn.ts
+init_single_turn();
+async function runGameModelTurn(game, state, opts) {
+  const startedAt = performance.now();
+  const turn = await runModelTurn({
+    system: game.systemPrompt(),
+    user: game.stateForModel(state),
+    ...opts.provider !== undefined ? { provider: opts.provider } : {},
+    ...opts.model !== undefined ? { model: opts.model } : {},
+    maxOutputTokens: 256,
+    requestId: "keryx-game",
+    ...opts.providerFactory !== undefined ? { providerFactory: opts.providerFactory } : {},
+    ...opts.env !== undefined ? { env: opts.env } : {}
+  });
+  const totalMs = Math.max(0, Math.round(performance.now() - startedAt));
+  const stats = {
+    provider: turn.provider,
+    model: turn.model,
+    latencyMs: turn.latencyMs,
+    totalMs,
+    inputTokens: turn.usage?.inputTokens,
+    outputTokens: turn.usage?.outputTokens,
+    reasoning: turn.reasoning === true,
+    localFallback: false,
+    error: turn.error !== undefined
+  };
+  if (turn.error !== undefined) {
+    return { move: undefined, error: `model error: ${turn.error.message}`, stats };
+  }
+  if (!turn.credentialAvailable && opts.providerFactory === undefined) {
+    return { move: undefined, error: "no model credential \u2014 configure a provider first (/provider)", stats };
+  }
+  return { move: game.parseMove(turn.text, state), error: undefined, stats };
+}
+
+// src/tui/games/agent-panel.ts
+function renderAgentPanel(game, parent, core, renderer, args2) {
+  const theme = getTheme();
+  const line = (content, fg, id) => {
+    parent.add(new core.TextRenderable(renderer, { content, fg, ...id !== undefined ? { id } : {} }));
+  };
+  if (args2.modelBusy) {
+    line("agent is thinking\u2026", theme.focus, "game-notice");
+  } else {
+    line(args2.notice ?? "", theme.error, "game-notice");
+  }
+  const sys = game.systemPrompt().split(`
+`);
+  line(`system: ${sys.join(" \xB7 ")}`, theme.muted, "game-system");
+  const lt = args2.lastTurn;
+  const tot = args2.totals;
+  const model = lt === undefined ? "\u2013" : `${lt.provider}/${lt.model}`;
+  const parts = [
+    `model: ${model}`,
+    `first byte ${formatMs(lt?.latencyMs)}`,
+    `total ${formatMs(lt?.totalMs)}`,
+    `in ${formatTokens(lt?.inputTokens)}`,
+    `out ${formatTokens(lt?.outputTokens)}`,
+    lt?.reasoning === true ? "reasoning" : undefined,
+    `turns ${tot.turns}`,
+    `fallbacks ${tot.localFallbacks}`,
+    tot.errors > 0 ? `errors ${tot.errors}` : undefined
+  ];
+  line(parts.filter((p) => p !== undefined).join(" \xB7 "), theme.muted, "game-stats");
+}
+
+// src/tui/games/otui.ts
 function asOtui2(otui) {
   if (otui === undefined || otui === null) {
     return;
@@ -57569,60 +57947,90 @@ function asOtui2(otui) {
   }
   return cand;
 }
-var currentGame = freshGame();
-var modelBusy = false;
-function resetGame() {
-  currentGame = freshGame();
-  modelBusy = false;
-}
-function markColor(mark) {
-  return mark === "X" ? getTheme().ok : getTheme().error;
-}
-function statusText(state) {
-  if (state.winner !== null) {
-    return `${state.winner} wins!  (r \u2014 new game)`;
-  }
-  if (state.draw) {
-    return "Draw!  (r \u2014 new game)";
+
+// src/tui/games/modal.ts
+var DEFAULT_GAMES = [ticTacToeGame];
+function presentGamesModal(openModalFn, otui, chrome, options = {}, registry = createRegistry(DEFAULT_GAMES)) {
+  const games = registry.games;
+  const first = games[0];
+  if (first === undefined) {
+    return;
   }
-  return state.turn === "X" ? "Your turn \u2014 X" : "Agent's turn \u2014 O";
-}
-function presentGame(openModalFn, otui, chrome, options = {}) {
-  const renderer = options.renderer;
   const core = asOtui2(otui);
+  const renderer = options.renderer;
   let handle;
-  let cells = [];
-  let statusBox;
-  let noticeBox;
-  let cursor = 4;
+  let activeId = first.id;
+  const states = new Map;
+  const totals = new Map;
+  const lastTurn = new Map;
   let notice;
+  let modelBusy = false;
   let unsubscribeKey;
+  let bodyRef;
+  let bodyWidth = 0;
+  const stateOf = (id) => {
+    const game = registry.get(id);
+    if (game === undefined) {
+      throw new Error(`unknown game: ${id}`);
+    }
+    let state = states.get(id);
+    if (state === undefined) {
+      state = game.fresh();
+      states.set(id, state);
+    }
+    return state;
+  };
+  const totalsOf = (id) => {
+    let t = totals.get(id);
+    if (t === undefined) {
+      t = emptyTurnTotals();
+      totals.set(id, t);
+    }
+    return t;
+  };
   const paint = () => {
-    if (statusBox === undefined || noticeBox === undefined || cells.length !== 9) {
+    if (core === undefined || bodyRef === undefined) {
       return;
     }
-    const theme = getTheme();
-    statusBox.content = statusText(currentGame);
-    statusBox.fg = theme.text;
-    if (modelBusy) {
-      noticeBox.content = "agent is thinking\u2026";
-      noticeBox.fg = theme.focus;
-    } else {
-      noticeBox.content = notice ?? "";
-      noticeBox.fg = theme.error;
+    clearTranscriptChildren(bodyRef);
+    const game = registry.get(activeId);
+    if (game === undefined) {
+      return;
     }
-    for (const [index, view] of cells.entries()) {
-      const cell = currentGame.board[index] ?? null;
-      const isCursor = index === cursor && !isGameOver(currentGame) && !modelBusy;
-      const won = currentGame.winLine?.includes(index) === true;
-      view.text.content = cell ?? "\xB7";
-      view.text.fg = cell === null ? theme.muted : markColor(cell);
-      view.box.borderColor = won ? markColor(currentGame.winner ?? "X") : isCursor ? theme.focus : theme.border;
-      view.box.backgroundColor = isCursor || won ? theme.highlight : undefined;
+    const state = stateOf(activeId);
+    const ctx = {
+      core,
+      renderer,
+      theme: getTheme(),
+      parent: bodyRef,
+      width: bodyWidth
+    };
+    game.render(state, ctx);
+    renderAgentPanel(game, bodyRef, core, renderer, {
+      notice,
+      modelBusy,
+      lastTurn: lastTurn.get(activeId),
+      totals: totalsOf(activeId)
+    });
+  };
+  const restart = () => {
+    const game = registry.get(activeId);
+    if (game === undefined) {
+      return;
     }
+    states.set(activeId, game.fresh());
+    totals.set(activeId, emptyTurnTotals());
+    lastTurn.set(activeId, undefined);
+    notice = undefined;
+    paint();
   };
   const applyModelMove = async () => {
-    if (modelBusy || isGameOver(currentGame) || currentGame.turn !== "O") {
+    const game = registry.get(activeId);
+    if (game === undefined) {
+      return;
+    }
+    const state = stateOf(activeId);
+    if (modelBusy || game.isOver(state) || game.turn(state) !== "model") {
       return;
     }
     modelBusy = true;
@@ -57633,30 +58041,51 @@ function presentGame(openModalFn, otui, chrome, options = {}) {
     const deadline = new Promise((resolve3) => {
       timer = setTimeout(() => resolve3("timeout"), timeoutMs);
     });
-    const outcome = await Promise.race([
-      modelMove(currentGame.board, {
-        ...options.provider !== undefined ? { provider: options.provider } : {},
-        ...options.model !== undefined ? { model: options.model } : {},
-        ...options.providerFactory !== undefined ? { providerFactory: options.providerFactory } : {},
-        ...options.env !== undefined ? { env: options.env } : {}
-      }),
-      deadline
-    ]);
+    const outcome = await Promise.race([runGameModelTurn(game, state, options), deadline]);
     if (timer !== undefined) {
       clearTimeout(timer);
     }
     modelBusy = false;
     const timedOut = outcome === "timeout";
-    const result = timedOut ? { move: undefined, error: undefined } : outcome;
-    let move = result.move;
+    const result = timedOut ? undefined : outcome;
+    let stats;
+    if (timedOut) {
+      stats = {
+        provider: "\u2013",
+        model: "\u2013",
+        latencyMs: undefined,
+        totalMs: timeoutMs,
+        inputTokens: undefined,
+        outputTokens: undefined,
+        reasoning: false,
+        localFallback: true,
+        error: false
+      };
+    } else if (result !== undefined) {
+      stats = result.stats;
+    } else {
+      stats = {
+        provider: "\u2013",
+        model: "\u2013",
+        latencyMs: undefined,
+        totalMs: undefined,
+        inputTokens: undefined,
+        outputTokens: undefined,
+        reasoning: false,
+        localFallback: true,
+        error: true
+      };
+    }
+    let move = result?.move;
     let playedLocally = false;
-    if (move === undefined && result.error === undefined) {
-      move = bestLocalMove(currentGame.board, "O");
+    if (move === undefined && result?.error === undefined) {
+      move = game.localMove(state, "model");
       playedLocally = move !== undefined;
+      stats = { ...stats, localFallback: playedLocally };
     }
-    const placed = move === undefined ? undefined : placeMark(currentGame.board, move, "O");
-    currentGame = placed ?? { ...currentGame, turn: "X" };
-    if (result.error !== undefined) {
+    const placed = move === undefined ? undefined : game.applyMove(state, move, "model");
+    const next = placed ?? game.pass(state);
+    if (result?.error !== undefined) {
       notice = `agent: ${result.error}`;
     } else if (timedOut && playedLocally) {
       notice = `agent timed out after ${Math.round(timeoutMs / 1000)}s \u2014 played a local move`;
@@ -57665,132 +58094,21 @@ function presentGame(openModalFn, otui, chrome, options = {}) {
     } else {
       notice = undefined;
     }
-    paint();
-  };
-  const userPlace = () => {
-    if (modelBusy || isGameOver(currentGame) || currentGame.turn !== "X") {
-      return;
-    }
-    const placed = placeMark(currentGame.board, cursor, "X");
-    if (placed === undefined) {
-      return;
-    }
-    currentGame = placed;
-    notice = undefined;
-    paint();
-    if (!isGameOver(currentGame) && currentGame.turn === "O") {
-      applyModelMove();
-    }
-  };
-  const moveCursor = (dr, dc) => {
-    if (modelBusy) {
-      return;
-    }
-    const row = Math.floor(cursor / 3);
-    const col = cursor % 3;
-    cursor = (row + dr + 3) % 3 * 3 + (col + dc + 3) % 3;
-    paint();
-  };
-  const restart = () => {
-    resetGame();
-    cursor = 4;
-    notice = undefined;
+    states.set(activeId, next);
+    totals.set(activeId, addTurn(totalsOf(activeId), stats));
+    lastTurn.set(activeId, stats);
     paint();
   };
   handle = openModalFn(otui, chrome, {
     title: "/game",
-    tabs: [{ id: "game", label: "Tic-tac-toe" }],
-    footer: GAME_FOOTER,
-    onArrowKeys: (_key, direction) => {
-      moveCursor(0, direction === "left" ? -1 : 1);
-      return true;
-    },
+    tabs: games.map((game) => ({ id: game.id, label: game.label })),
+    footer: GAMES_FOOTER,
     renderTab: (_tabId, body, ctx) => {
       if (body === undefined || body === null) {
         return;
       }
-      const parent = body;
-      if (parent.add === undefined || core === undefined) {
-        return;
-      }
-      const theme = getTheme();
-      const r = renderer;
-      const cellSize = resolveCellSize(ctx.width);
-      const wrap2 = new core.BoxRenderable(r, {
-        id: "game-wrap",
-        width: "100%",
-        flexDirection: "column",
-        alignItems: "center"
-      });
-      const legend = new core.BoxRenderable(r, {
-        id: "game-legend",
-        flexDirection: "row",
-        marginBottom: 1
-      });
-      legend.add(new core.TextRenderable(r, { id: "game-legend-x", content: "X you", fg: theme.ok }));
-      legend.add(new core.TextRenderable(r, { id: "game-legend-sep", content: "  \xB7  ", fg: theme.muted }));
-      legend.add(new core.TextRenderable(r, { id: "game-legend-o", content: "O model", fg: theme.error }));
-      wrap2.add(legend);
-      const board = new core.BoxRenderable(r, {
-        id: "game-board",
-        flexDirection: "column",
-        flexShrink: 0,
-        border: true,
-        borderStyle: "rounded",
-        borderColor: theme.border,
-        backgroundColor: theme.panel,
-        paddingLeft: 1,
-        paddingRight: 1
-      });
-      cells = [];
-      for (let row = 0;row < 3; row++) {
-        const rowBox = new core.BoxRenderable(r, {
-          id: `game-row-${row}`,
-          flexDirection: "row",
-          flexShrink: 0,
-          gap: GAME_CELL_GAP
-        });
-        for (let col = 0;col < 3; col++) {
-          const index = row * 3 + col;
-          const cellBox = new core.BoxRenderable(r, {
-            id: `game-cell-${index}`,
-            width: cellSize.width,
-            height: cellSize.height,
-            flexShrink: 0,
-            flexGrow: 0,
-            flexDirection: "row",
-            alignItems: "center",
-            justifyContent: "center",
-            border: true,
-            borderStyle: "rounded",
-            borderColor: theme.border
-          });
-          const cellText = new core.TextRenderable(r, {
-            id: `game-cell-text-${index}`,
-            content: "\xB7",
-            fg: theme.muted
-          });
-          cellBox.add(cellText);
-          rowBox.add(cellBox);
-          cells.push({ box: cellBox, text: cellText });
-        }
-        board.add(rowBox);
-      }
-      wrap2.add(board);
-      const status = new core.TextRenderable(r, {
-        id: "game-status",
-        content: "",
-        marginTop: 1
-      });
-      statusBox = status;
-      wrap2.add(status);
-      const noticeText = new core.TextRenderable(r, {
-        id: "game-notice",
-        content: ""
-      });
-      noticeBox = noticeText;
-      wrap2.add(noticeText);
-      parent.add(wrap2);
+      bodyRef = body;
+      bodyWidth = ctx.width;
       paint();
     },
     onClose: () => {
@@ -57803,39 +58121,92 @@ function presentGame(openModalFn, otui, chrome, options = {}) {
   if (options.onKeypress !== undefined) {
     unsubscribeKey = options.onKeypress((key) => {
       const token = key.name || key.sequence;
-      if (token === "up" || token === "k") {
-        moveCursor(-1, 0);
-        return;
-      }
-      if (token === "down" || token === "j") {
-        moveCursor(1, 0);
-        return;
-      }
-      if (token === "h") {
-        moveCursor(0, -1);
+      if (token === "r" || token === "R") {
+        restart();
         return;
       }
-      if (token === "l") {
-        moveCursor(0, 1);
+      const game = registry.get(activeId);
+      if (game === undefined || modelBusy) {
         return;
       }
-      if (token === "return" || token === "enter" || token === "space" || token === " ") {
-        userPlace();
+      const state = stateOf(activeId);
+      const next = game.onKey(state, key);
+      if (next === undefined) {
         return;
       }
-      if (token === "r" || token === "R") {
-        restart();
+      states.set(activeId, next);
+      paint();
+      if (!game.isOver(next) && game.turn(next) === "model") {
+        applyModelMove();
       }
     });
   }
   return {
     close: () => handle?.close(),
     restart,
+    activeGameId: () => activeId,
     modelThinking: () => modelBusy
   };
 }
-function openGameModal(otui, chrome, options = {}) {
-  return presentGame((hostOtui, hostChrome, input2) => openModal(hostOtui, hostChrome, input2), otui, chrome, options);
+function openGamesModal(otui, chrome, options = {}) {
+  return presentGamesModal((hostOtui, hostChrome, input2) => openModal(hostOtui, hostChrome, input2), otui, chrome, options);
+}
+// src/tui/balance-panel.ts
+init_providers();
+init_shell_config();
+function formatBalance(balance) {
+  if (balance === undefined) {
+    return "\u2014";
+  }
+  const amount = balance.remaining ?? balance.total;
+  const symbol = balance.currency === "USD" ? "$" : balance.currency === "EUR" ? "\u20AC" : balance.currency === "GBP" ? "\xA3" : `${balance.currency} `;
+  return `${symbol}${amount.toFixed(2)}`;
+}
+function mountBalancePanel(sidebarTop, otui, renderer, options) {
+  const core = otui;
+  const r = renderer;
+  const env = envWithSavedApiKeys(options.env ?? process.env);
+  let current;
+  let textNode;
+  const label = new core.TextRenderable(r, {
+    id: "sb-balance-k",
+    content: core.t`${core.dim("Balance")}`,
+    marginTop: 1
+  });
+  sidebarTop.add(label);
+  const value = new core.TextRenderable(r, {
+    id: "sb-balance-v",
+    content: core.t`${core.dim("\u2026")}`,
+    onMouseDown: () => {
+      refresh();
+    }
+  });
+  textNode = value;
+  sidebarTop.add(value);
+  const paint = (balance) => {
+    current = balance;
+    if (textNode !== undefined) {
+      textNode.content = core.t`${core.dim(formatBalance(balance))}`;
+    }
+  };
+  const refresh = async () => {
+    const provider = balanceCapableProvider(options.provider);
+    if (provider === undefined) {
+      paint(undefined);
+      return;
+    }
+    const apiKey = providerApiKey(provider, env);
+    if (apiKey === undefined) {
+      paint(undefined);
+      return;
+    }
+    const base = resolveProviderBaseUrl(provider, env);
+    const withBase = { ...provider, baseUrl: base };
+    const balance = await fetchProviderBalance(options.fetch ?? globalThis.fetch, withBase, apiKey, { ...options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {} });
+    paint(balance);
+  };
+  refresh();
+  return { refresh, current: () => current };
 }
 
 // src/tui/tui-shell.ts
@@ -58175,7 +58546,7 @@ function showComposerChoice(otui, r, dock, request) {
       } catch {}
       dock.visible = false;
     }
-    const onKey = (key) => {
+    const onKey2 = (key) => {
       if (key.name === "escape") {
         finish(request.cancelId);
         key.preventDefault();
@@ -58222,7 +58593,7 @@ function showComposerChoice(otui, r, dock, request) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress2(r, onKey);
+    const unsub = onKeypress2(r, onKey2);
     optionsScroll.focus();
   });
 }
@@ -61339,6 +61710,7 @@ function attachUsageIo(io, chrome) {
     totalOut += usage.outputTokens ?? 0;
     chrome.setHeaderMeta(`\u2191${fmtTokens(totalIn)} \u2193${fmtTokens(totalOut)}`);
     chrome.setContextTotal(totalIn + totalOut);
+    chrome.setUsage?.(totalIn, totalOut);
   };
   return Object.assign(io, {
     resetUsage() {
@@ -61835,7 +62207,7 @@ function promptApiKeyStep(otui, r, opts) {
     const keyInput = new otui.InputRenderable(r, { id: "kp-input", placeholder: opts.placeholder ?? "sk-...", marginTop: 1 });
     box.add(keyInput);
     keyInput.focus();
-    const onKey = (key) => {
+    const onKey2 = (key) => {
       if (key.name === "escape") {
         cleanup();
         resolve3({ kind: "back" });
@@ -61843,7 +62215,7 @@ function promptApiKeyStep(otui, r, opts) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress4(r, onKey);
+    const unsub = onKeypress4(r, onKey2);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -61875,7 +62247,7 @@ function pickProviderStep(otui, r, detected) {
     });
     box.add(provSelect);
     provSelect.focus();
-    const onKey = (key) => {
+    const onKey2 = (key) => {
       if (key.name === "escape") {
         cleanup();
         resolve3(undefined);
@@ -61883,7 +62255,7 @@ function pickProviderStep(otui, r, detected) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress4(r, onKey);
+    const unsub = onKeypress4(r, onKey2);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -61985,7 +62357,7 @@ function pickModelInTui(otui, r, models) {
       sel.options = matches2.length > 0 ? matches2.map((m) => ({ name: m, description: "" })) : [{ name: NO_MATCH, description: "" }];
       filterLine.content = otui.t`${otui.dim(q.length > 0 ? `filter: ${filter}  (${matches2.length}/${all.length})` : "type to filter \xB7 \u2191/\u2193 Enter \xB7 Esc to go back")}`;
     };
-    const onKey = (key) => {
+    const onKey2 = (key) => {
       if (key.name === "escape") {
         cleanup();
         resolve3(undefined);
@@ -62008,7 +62380,7 @@ function pickModelInTui(otui, r, models) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress4(r, onKey);
+    const unsub = onKeypress4(r, onKey2);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -62077,7 +62449,7 @@ function pickSessionInTui(otui, r, sessions) {
       sel.selectedIndex = 0;
     };
     apply();
-    const onKey = (key) => {
+    const onKey2 = (key) => {
       if (key.name === "escape") {
         cleanup();
         resolve3(undefined);
@@ -62100,7 +62472,7 @@ function pickSessionInTui(otui, r, sessions) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress4(r, onKey);
+    const unsub = onKeypress4(r, onKey2);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -62220,6 +62592,12 @@ async function launchTuiAgentShell(opts) {
     sidebar.add(new otui.TextRenderable(r, { id: "sb-model-k", content: otui.t`${otui.dim("Model")}`, marginTop: 1 }));
     const sbModelV = new otui.TextRenderable(r, { id: "sb-model-v", content: otui.t`${otui.dim(`${sel.provider}/${sel.model}`)}` });
     sidebar.add(sbModelV);
+    sidebar.add(new otui.TextRenderable(r, { id: "sb-usage-k", content: otui.t`${otui.dim("Usage")}`, marginTop: 1 }));
+    const sbUsageV = new otui.TextRenderable(r, { id: "sb-usage-v", content: otui.t`${otui.dim("\u21910 \u21930")}` });
+    sidebar.add(sbUsageV);
+    const balancePanel = mountBalancePanel(sidebar, otui, r, {
+      provider: sel.provider
+    });
     mountCwdPanel(otui, r, sidebar, opts.session?.cwd ?? process.cwd());
     sidebar.add(new otui.TextRenderable(r, { id: "sb-workspace-k", content: otui.t`${otui.dim("Workspace")}`, marginTop: 1 }));
     const sbWorkspaceV = new otui.TextRenderable(r, {
@@ -62461,6 +62839,9 @@ async function launchTuiAgentShell(opts) {
       },
       onExactUsage: () => {
         hasExactUsage = true;
+      },
+      setUsage: (input3, output2) => {
+        sbUsageV.content = otui.t`${otui.dim(`\u2191${fmtTokens(input3)} \u2193${fmtTokens(output2)}`)}`;
       }
     });
     let lastUsage;
@@ -63015,10 +63396,12 @@ Staying in the current session.
         });
       })();
     };
-    const showGame = () => {
-      openGameModal(otui, chrome, {
+    const showGame = (line) => {
+      const timeoutMatch = /\/game\s+(\d+)/.exec(line);
+      openGamesModal(otui, chrome, {
         renderer: r,
-        ...inspectorKeys
+        ...inspectorKeys,
+        ...timeoutMatch !== null ? { timeoutMs: Math.max(1, Number(timeoutMatch[1])) * 1000 } : {}
       });
     };
     const showWorkspace = () => {
@@ -63683,7 +64066,7 @@ Staying in the current session.
             return;
           }
           case "game": {
-            showGame();
+            showGame(line);
             return;
           }
           case "deferred": {
@@ -63946,7 +64329,7 @@ ${formatThemeList(getThemeId())}`);
           return;
         }
         if (command.name === "/game") {
-          showGame();
+          showGame(line);
           return;
         }
         if (command.name === "/mode") {
@@ -64376,6 +64759,9 @@ async function mountChatShell(otui, renderer, opts) {
   sidebar.add(new otui.TextRenderable(r, { id: "sb-model-k", content: otui.t`${otui.dim("Model")}`, marginTop: 1 }));
   const sbModel = new otui.TextRenderable(r, { id: "sb-model-v", content: otui.t`${otui.dim(label())}` });
   sidebar.add(sbModel);
+  mountBalancePanel(sidebar, otui, r, {
+    provider: selection.provider
+  });
   sidebar.add(new otui.TextRenderable(r, { id: "sb-ctx-k", content: otui.t`${otui.dim("Context")}`, marginTop: 1 }));
   const sbContext = new otui.TextRenderable(r, { id: "sb-ctx-v", content: otui.t`${otui.dim("~0 tokens (est)")}` });
   sidebar.add(sbContext);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.2.61",
+  "version": "0.2.62",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {