chesspal 0.3.3 → 0.3.5

package/README.md

@@ -6,21 +6,60 @@ Play chess against an AI on a real board, or learn with one.
 
 ## Get started
 
-You need [Node.js](https://nodejs.org) 22.13 or newer and an AI agent on your computer, [Claude Code](https://code.claude.com/docs/en/setup) or [Codex](https://developers.openai.com/codex), signed in with your own subscription: see [what you need](#what-you-need).
+Five steps, done once, in about 15 minutes. You need a paid Claude plan or a ChatGPT account. After these steps you open the board with a double click.
 
-Open a terminal, the window where you type commands, after installing Node.js: one opened before does not find `npm`. On Windows, open Command Prompt (press Start, type `cmd`, press Enter): PowerShell, on a new computer, refuses npm's commands with "running scripts is disabled on this system", until you type `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` there once and answer yes. On macOS, open Terminal. Then type:
+**1. Install Node.js.** Download it from [nodejs.org](https://nodejs.org): take the version marked **LTS**, the steady one (22.13 or newer). Install it like any program, keeping every choice as it is; on Windows, leave the box "Automatically install the necessary tools" unticked.
+
+**2. Open a terminal**, the window where you type commands. Open it after installing Node.js: one opened before does not find it.
+
+- **Windows:** press Start, type `cmd` and press Enter. This opens Command Prompt. Use it rather than PowerShell: on a new computer PowerShell refuses these commands with "running scripts is disabled on this system".
+- **macOS:** press ⌘ and Space, type `Terminal` and press Enter.
+
+In the steps below, copy each command, paste it in the terminal (Ctrl+V or right-click; on macOS ⌘V) and press Enter. Wait for the terminal to finish before the next one. Lines with "WARN" are normal: go on.
+
+**3. Install the AI and sign in.** Choose one of the two. You need your own subscription: Chesspal never uses an API key, which is paid by the call.
+
+- **Claude Code**, with a paid Claude plan (Pro or higher; the free plan does not include it):
+
+  ```bash
+  npm install -g @anthropic-ai/claude-code
+  claude
+  ```
+
+  `claude` asks a few questions first, such as the colours you prefer: press Enter to keep the first choice. Then it opens your browser: sign in with your Claude account and go back to the terminal.
+- **Codex**, with a ChatGPT account:
+
+  ```bash
+  npm install -g @openai/codex
+  codex
+  ```
+
+  Choose **Sign in with ChatGPT** and sign in in your browser.
+
+Once you are signed in, close that terminal window with its × and open a new one, as in step 2.
+
+**4. Install Chesspal and open it.**
 
 ```bash
 npm install -g chesspal
 chesspal
 ```
 
-- `npm install -g` installs the `chesspal` command for the whole computer, where your agent finds it.
-- `chesspal` opens the board page in your browser. The first time, it offers an icon on your desktop and in your menu of programs: with it, you open the board with a double click, with no terminal.
-- The first time, the board page asks who you are: fill it in and press **Start playing**.
-- Press **Claude Code** or **Codex**: the AI opens in a terminal of its own, at the table; keep it open while you play. The first time, it asks whether you trust the folder: choose **Yes** with the arrow keys and press Enter. With Codex, when it asks about Chesspal's two hooks, choose **Trust all and continue**; on Windows, it also offers to set up its sandbox: choose the first option, and answer yes when Windows asks for permission.
+The board page opens in your browser, and you can close this terminal. The first time, Chesspal offers an icon on your desktop and in your menu of programs: accept it, and from then on you open the board with a double click on it, with no terminal.
+
+**5. Start the AI.** The first time, the board page asks who you are: fill it in and press **Start playing**. Then press **Claude Code** or **Codex**: the AI opens in a terminal of its own. Keep that window open while you play. The first time it asks some questions:
+
+- whether you trust the folder: choose **Yes** with the arrow keys and press Enter;
+- with Codex, about Chesspal's two hooks, the small programs that tell the AI when you move on the board: choose **Trust all and continue**;
+- with Codex on Windows, whether to set up its sandbox, a safe space where it works: choose the first option, and answer yes when Windows asks for permission.
+
+Now press **New game**: choose your colour, the clock and the AI's level, and play on the board. Talk with the AI on the board page or in its terminal.
+
+**If a command fails:**
 
-Then press **New game**: you choose your colour, the clock and the AI's level, and play on the board. Talk with the AI on the board page or in its terminal.
+- "npm is not recognized" or "command not found": close the terminal and open a new one; if it still fails, install Node.js again.
+- On macOS, "EACCES" or "permission denied": npm cannot write where Node.js put it. Follow [npm's guide](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally), not `sudo`: with `sudo`, Chesspal and Claude Code cannot update themselves.
+- Anything else in red, or with "ERR!": copy the last lines and [tell us](#try-it-and-tell-us).
 
 ## What it does
 
@@ -36,11 +75,11 @@ Coming later: an AI coach that helps you grow, exercises chosen on your weak poi
 
 ## What you need
 
-- **Node.js 22.13** or newer: download the version marked LTS and install it like any program.
-- **An AI agent** with your own subscription: Claude Code, with a paid Claude plan, or Codex, with a ChatGPT account. Chesspal never uses an API key, which is paid by the call: sign your agent in with your account.
+- **Node.js 22.13** or newer.
+- **An AI agent** with your own subscription: [Claude Code](https://code.claude.com/docs/en/setup), with a paid Claude plan, or [Codex](https://developers.openai.com/codex), with a ChatGPT account.
 - **A web browser**, for the board page.
 
-Chesspal works with any agent that supports MCP tools and can work with the files on your computer: we develop it with Claude Code, and Codex is connected too.
+Chesspal works with any agent that can use Chesspal's tools (MCP) and the files on your computer: we develop it with Claude Code, and Codex is connected too.
 
 ## Good to know
 

package/dist/commands/analysis/analyse.d.ts

@@ -63,7 +63,10 @@ interface Analysis {
     /** The AI's word on the whole game, from annotate_game. */
     review?: string;
 }
-/** A game over move by move, for the analyst (D-68): the current one, one of the archive or kept to study, or one the player brings as a PGN, kept to study. */
+/**
+ * A game over move by move, for the analyst (D-68): the current one, one of the archive or kept to study, one the player brings as a PGN, or one of their latest
+ * on the sites (D-110), kept to study.
+ */
 export declare const analyseGame: import("../registry/registry.ts").Command<z.ZodObject<{
     game: z.ZodOptional<z.ZodString>;
     pgn: z.ZodOptional<z.ZodString>;

package/dist/commands/analysis/analyse.js

@@ -1,37 +1,53 @@
 // The analyst's tool (D-21, D-68): a game over, move by move in one call, facts only and never a judgment, with the analyst's instructions once in a chat.
 import { z } from "zod";
-import { clockOfComment, clockText, closingOf, Game, gameReviewOf, isReviewed, leadOf, leadText, levelOf, materialOf, readPgn, reviewed, reviewOf, timeControlOfTag, timeControlText, withGameReview, withLead, } from "../../core/index.js";
+import { accountSide, clockOfComment, clockText, closingOf, Game, gameReviewOf, isReviewed, leadOf, leadText, levelOf, materialOf, readPgn, reviewed, reviewOf, timeControlOfTag, timeControlText, withGameReview, withLead, } from "../../core/index.js";
 import { gameInAnalysis, isGameName, keepToStudy, lastChatStart, planOf, rewriteGame, startAnalysis } from "../../games/index.js";
 import { analystAgent, instructionsFile } from "../../host-files/index.js";
 import { activeProfile, gameFolder } from "../../profiles/index.js";
+import { pointsAtSite, siteGameName, siteOfGameName } from "../../sites/index.js";
 import { analystOf, anotherAnalyst, balanceText, bookOpening, bookReaches, colourName, gameToStudy, knownTag, moveNumbers, namedGame, noGameGoingOn, riskLine, speechLine, speechOf, tacticsText } from "../answers/index.js";
-import { playerLine } from "../profiles/index.js";
+import { playerLine, siteText } from "../profiles/index.js";
 import { defineCommand } from "../registry/index.js";
-/** A game over move by move, for the analyst (D-68): the current one, one of the archive or kept to study, or one the player brings as a PGN, kept to study. */
+import { profileSiteGames } from "./site-games.js";
+/**
+ * A game over move by move, for the analyst (D-68): the current one, one of the archive or kept to study, one the player brings as a PGN, or one of their latest
+ * on the sites (D-110), kept to study.
+ */
 export const analyseGame = defineCommand({
     name: "analyse_game",
     description: "Gives a game that is over move by move, to comment it with the player: each move with what it took and the time it took, the material "
         + "when it changes, the pieces at risk, the only legal move when there is one alone, the mates in one and what the next moves would do after it (forks, double attacks, discovered checks, "
         + "promotions, stalemates and stalemate traps), where the game left the opening book, and your comments and plans. Facts "
-        + "only: the judgment is yours. Without game or pgn, the game just over, or else the last one played; game: a name as past_games or study_games "
-        + "writes it; pgn: a game the player brings from elsewhere, kept to study in the profile. Never while a game goes on. The first time in a chat "
+        + "only: the judgment is yours. Without game or pgn, the game just over, or else the last one played; game: a name as past_games, study_games or "
+        + "site_games writes it; pgn: a game the player brings from elsewhere, kept to study in the profile. Never while a game goes on. The first time in a chat "
         + "it also says how to analyse. annotate_game then keeps your badges and notes for the board page. Example: analyse_game {}.",
     input: z.object({
-        game: z.string().optional().describe("a game's name, as past_games, study_games or analyse_game writes it"),
+        game: z.string().optional().describe("a game's name, as past_games, study_games, site_games or analyse_game writes it"),
         pgn: z.string().optional().describe("a game played elsewhere, in PGN: its tags and its moves, with their [%clk] and a review exported from the board page if it has them; other comments and evals can go"),
     }),
     sharedWith: [analystAgent],
-    run: ({ game, pgn }, context) => {
+    openWorld: true,
+    run: async ({ game, pgn }, context) => {
         if (game !== undefined && pgn !== undefined) {
             throw new Error("Give game or pgn, not both: game names a game of the archive, pgn brings one played elsewhere.");
         }
+        const given = game?.trim();
+        // A link, or a name of a site's game that site_games does not write, is no game Chesspal can find (D-110).
+        if ([given, pgn].some((text) => text !== undefined && pointsAtSite(text))) {
+            throw new Error("Chesspal takes no link: site_games lists the player's latest games on Lichess and Chess.com; give the name it writes, as game.");
+        }
         // A game's name given as pgn, as an AI often gives it, is that game (Priya).
-        const named = pgn !== undefined && isGameName(pgn) ? pgn.trim() : game;
-        const studied = pgn === undefined || named !== game ? gameToStudy(context, named) : importedGame(context, pgn);
+        const fromSite = siteGameName(given ?? pgn ?? "");
+        const named = pgn !== undefined && isGameName(pgn) ? pgn.trim() : given;
+        const studied = fromSite !== undefined
+            ? importedGame(context, await siteGamePgn(context, fromSite))
+            : pgn === undefined || named !== given
+                ? gameToStudy(context, named)
+                : importedGame(context, pgn);
         if (context.agent === analystAgent) {
             oneAnalyst(context, studied);
         }
-        const analysis = analysisOf(studied, activeProfile(context.home()).name);
+        const analysis = analysisOf(studied, activeProfile(context.home()));
         if (studied.name !== undefined) {
             markBook(context, { record: studied.record, name: studied.name }, analysis.moves);
             startAnalysis(gameFolder(context.home()), studied.name, context.now());
@@ -111,6 +127,23 @@ function importedGame(context, pgn) {
     // A game brought again is the one already kept, with the review written on it since.
     return namedGame(context, keepToStudy(gameFolder(context.home()), record, context.now()));
 }
+/** The PGN of one of the player's latest games on the sites, asked of them again by its name as site_games writes it (D-110). */
+async function siteGamePgn(context, name) {
+    noGameGoingOn(context);
+    const site = siteOfGameName(name);
+    const profile = activeProfile(context.home()).id;
+    const { games, unreached } = await profileSiteGames(context, site);
+    if (activeProfile(context.home()).id !== profile) {
+        throw new Error("The profile in use changed while the site answered: call site_games again for the player's games now. Nothing changed.");
+    }
+    const found = games.find((one) => one.name === name);
+    if (found !== undefined) {
+        return found.pgn;
+    }
+    throw new Error(unreached.includes(site)
+        ? `${siteText[site]} could not be reached: tell the player, and ask again when they ask. Nothing changed.`
+        : `${name} is not among the player's latest games on ${siteText[site]} any more: call site_games again and give a name it writes. Nothing changed.`);
+}
 /**
  * The opening book's moves marked as such in the game kept (D-69): a fact, not a judgment, so Chesspal puts the badge itself on each move from the start to the
  * last one the book knows, where the AI gave none; a game from another position has none.
@@ -132,7 +165,7 @@ function bookPliesOfFacts(record, moves) {
     const firstOut = moves.findIndex((move) => move.outOfBook);
     return record.tags.FEN !== undefined ? 0 : firstOut >= 0 ? firstOut : moves.length;
 }
-function analysisOf({ record, name }, playerName) {
+function analysisOf({ record, name }, profile) {
     const { tags } = record;
     const ai = sideNamed(record, "AI");
     const control = timeControlOfTag(tags.TimeControl ?? "");
@@ -145,7 +178,8 @@ function analysisOf({ record, name }, playerName) {
         black: tags.Black ?? "?",
         ai,
         level: ai === undefined ? undefined : levelOf(record),
-        player: ai === undefined && playerName !== undefined ? sideNamed(record, playerName) : undefined,
+        // The player by their name, or by their names on the sites (D-93).
+        player: ai === undefined ? sideNamed(record, profile.name) ?? accountSide(record.tags, profile.accounts) : undefined,
         date: knownTag(tags.Date),
         timeControl: control === undefined ? knownTag(tags.TimeControl) : timeControlText(control),
         result: ended?.result,

package/dist/commands/analysis/index.d.ts

@@ -1,4 +1,5 @@
 export { analyseGame } from "./analyse.ts";
 export { annotateGame } from "./annotate.ts";
 export { deleteReview } from "./delete-review.ts";
+export { type ListedGame, type ListedGames, siteGames, SiteGamesRefused } from "./site-games.ts";
 export { studyGames } from "./study-games.ts";

package/dist/commands/analysis/index.js

@@ -1,5 +1,6 @@
-// The commands on a game over or kept to study: the analyst's analysis and review, the games kept and the reviews deleted.
+// The commands on a game over or kept to study: the analyst's analysis and review, the games kept, the latest on the sites, and the reviews deleted.
 export { analyseGame } from "./analyse.js";
 export { annotateGame } from "./annotate.js";
 export { deleteReview } from "./delete-review.js";
+export { siteGames, SiteGamesRefused } from "./site-games.js";
 export { studyGames } from "./study-games.js";

package/dist/commands/analysis/site-games.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { type Side } from "../../core/index.ts";
+import { type RatingSite } from "../../profiles/index.ts";
+import { type SiteGame, type SiteGames } from "../../sites/index.ts";
+import { type Context } from "../registry/index.ts";
+/** A game of the list, with the side the player had when one of their names on the sites is on one side alone (D-93). */
+export interface ListedGame extends SiteGame {
+    readonly player?: Side;
+}
+/** The latest games on the sites, with the player's side in each. */
+export interface ListedGames extends Omit<SiteGames, "games"> {
+    readonly games: readonly ListedGame[];
+}
+/** Why the list is refused, for the page to say it in the player's words: a game going on, no name on the sites, or no network to ask them. */
+export declare class SiteGamesRefused extends Error {
+    readonly refusal: "game-going" | "no-accounts" | "no-network";
+    constructor(refusal: SiteGamesRefused["refusal"], message: string);
+}
+/** The latest games on the sites, one line each without their PGN, the latest first; the page gets the PGNs too. */
+export declare const siteGames: import("../registry/registry.ts").Command<z.ZodObject<{}, z.core.$strip>, ListedGames>;
+/**
+ * The latest games on the sites of the profile in use, or on one of them alone, each with the player's side; refused when the profile names no account
+ * there, or when Chesspal cannot ask the network.
+ */
+export declare function profileSiteGames(context: Context, only?: RatingSite): Promise<ListedGames>;
+/** Refused while a game goes on, as every analysis is, with the page's code. */
+export declare function refusedWhilePlaying(context: Context): void;

package/dist/commands/analysis/site-games.js

@@ -0,0 +1,84 @@
+// The player's latest games on Lichess and Chess.com (D-110), from the names in the profile in use, to study one: asked anew each time, never kept.
+import { z } from "zod";
+import { accountSide } from "../../core/index.js";
+import { activeProfile } from "../../profiles/index.js";
+import { readSiteGames } from "../../sites/index.js";
+import { noGameGoingOn } from "../answers/index.js";
+import { siteText } from "../profiles/index.js";
+import { defineCommand } from "../registry/index.js";
+/** Why the list is refused, for the page to say it in the player's words: a game going on, no name on the sites, or no network to ask them. */
+export class SiteGamesRefused extends Error {
+    refusal;
+    constructor(refusal, message) {
+        super(message);
+        this.refusal = refusal;
+    }
+}
+/** The latest games on the sites, one line each without their PGN, the latest first; the page gets the PGNs too. */
+export const siteGames = defineCommand({
+    name: "site_games",
+    description: "Lists the player's latest finished games on Lichess and Chess.com, from their names there in the profile, the latest first: the side "
+        + "they had and the opponent, with the ratings, how it went, the speed, the day, and the game's name. analyse_game takes that name as game, and "
+        + "keeps the game to study. Never while a game goes on. Example: site_games {}.",
+    input: z.object({}),
+    readOnly: true,
+    openWorld: true,
+    run: async (input, context) => {
+        refusedWhilePlaying(context);
+        return profileSiteGames(context);
+    },
+    format: ({ games, answered, unreached, unknown }) => {
+        const none = games.length === 0 && answered.length > 0 ? ["No finished game of standard chess on the sites."] : [];
+        const missed = [
+            ...(unreached.length === 0 ? [] : [`${sitesText(unreached)} could not be reached: tell the player, and ask again when they ask.`]),
+            ...(unknown.length === 0 ? [] : [`${sitesText(unknown)} ${unknown.length === 1 ? "has" : "have"} no player by the profile's name there: the player can correct it in the profile.`]),
+        ];
+        const next = games.length === 0 ? [] : [`To go over one, analyse_game with game set to its name, such as {"game": "${games[0].name}"}.`];
+        return [...games.map(gameLine), ...none, ...missed, ...next].join("\n");
+    },
+});
+/**
+ * The latest games on the sites of the profile in use, or on one of them alone, each with the player's side; refused when the profile names no account
+ * there, or when Chesspal cannot ask the network.
+ */
+export async function profileSiteGames(context, only) {
+    const { accounts } = activeProfile(context.home());
+    const asked = only === undefined ? accounts : only === "lichess" ? { lichess: accounts?.lichess } : { chesscom: accounts?.chesscom };
+    if (asked?.lichess === undefined && asked?.chesscom === undefined) {
+        throw new SiteGamesRefused("no-accounts", `Tell the player: put your name on ${only === undefined ? "Lichess or Chess.com" : siteText[only]} in your profile, with the pencil beside your name in Who's playing? on the board page. Nothing changed.`);
+    }
+    if (context.fetch === undefined) {
+        throw new SiteGamesRefused("no-network", "Chesspal cannot reach the sites from here. Nothing changed.");
+    }
+    const read = await readSiteGames(asked, context.fetch);
+    return { ...read, games: read.games.map((game) => withPlayer(game, accounts)) };
+}
+/** Refused while a game goes on, as every analysis is, with the page's code. */
+export function refusedWhilePlaying(context) {
+    try {
+        noGameGoingOn(context);
+    }
+    catch (error) {
+        throw new SiteGamesRefused("game-going", error.message);
+    }
+}
+function withPlayer(game, accounts) {
+    const player = accountSide({ White: game.white, Black: game.black, Site: game.site }, accounts);
+    return player === undefined ? game : { ...game, player };
+}
+/** chess.com/live/186997906366: White (3476) vs BATEK_HA_TPAKTOPE (3102), won, blitz, 2026-11-11; from both sides when the player's is not known. */
+function gameLine(game) {
+    const rated = (name, rating) => rating === undefined ? name : `${name} (${rating})`;
+    const when = `${game.speed}, ${game.played.slice(0, 10)}.`;
+    if (game.player === undefined) {
+        return `${game.name}: ${rated(game.white, game.whiteRating)} vs ${rated(game.black, game.blackRating)}, ${game.result}, ${when}`;
+    }
+    const white = game.player === "white";
+    const you = rated(white ? "White" : "Black", white ? game.whiteRating : game.blackRating);
+    const opponent = white ? rated(game.black, game.blackRating) : rated(game.white, game.whiteRating);
+    const went = game.result === "1/2-1/2" ? "drew" : (game.result === "1-0") === white ? "won" : "lost";
+    return `${game.name}: ${you} vs ${opponent}, ${went}, ${when}`;
+}
+function sitesText(sites) {
+    return sites.map((site) => siteText[site]).join(" and ");
+}

package/dist/commands/index.d.ts

@@ -1,5 +1,5 @@
 import type { AnyCommand } from "./registry/index.ts";
-export { analyseGame, deleteReview } from "./analysis/index.ts";
+export { analyseGame, deleteReview, siteGames, SiteGamesRefused } from "./analysis/index.ts";
 export { analystOf, bookOpening, bookPlies, gameAt, gameToStudy, namedGame, playMove, PositionChanged, positionIn, samePosition, say, shownPosition } from "./answers/index.ts";
 export { aiMove, answerDraw, ChatNotClear, DrawRefused, endGame, newGame, offerDraw, startNewGame } from "./game/index.ts";
 export { chooseDrawnAvatar, deleteGame, editProfile, GameGoingOn, newProfile, ratingsAge, refreshRatings, useProfile } from "./profiles/index.ts";

package/dist/commands/index.js

@@ -1,11 +1,11 @@
 // The commands: the only way the AI, the command line and the page change a game (D-5, D-27), grouped by area, each defined once.
-import { analyseGame, annotateGame, deleteReview, studyGames } from "./analysis/index.js";
+import { analyseGame, annotateGame, deleteReview, siteGames, studyGames } from "./analysis/index.js";
 import { aiMove, coach, endGame, exportGame, look, newGame, playerMove, ponder, position, status } from "./game/index.js";
 import { deleteGame, editProfile, newProfile, pastGames, profiles, setAvatar, useProfile } from "./profiles/index.js";
 import { init, instructions } from "./setup/index.js";
 import { aiSay, playerSay } from "./talk/index.js";
 // What the server and the command line use besides the list: the context, the reading of an input, and the operations the page shares with the tools.
-export { analyseGame, deleteReview } from "./analysis/index.js";
+export { analyseGame, deleteReview, siteGames, SiteGamesRefused } from "./analysis/index.js";
 export { analystOf, bookOpening, bookPlies, gameAt, gameToStudy, namedGame, playMove, PositionChanged, positionIn, samePosition, say, shownPosition } from "./answers/index.js";
 export { aiMove, answerDraw, ChatNotClear, DrawRefused, endGame, newGame, offerDraw, startNewGame } from "./game/index.js";
 export { chooseDrawnAvatar, deleteGame, editProfile, GameGoingOn, newProfile, ratingsAge, refreshRatings, useProfile } from "./profiles/index.js";
@@ -30,6 +30,7 @@ export const commands = [
     analyseGame,
     annotateGame,
     studyGames,
+    siteGames,
     deleteReview,
     deleteGame,
     profiles,

package/dist/commands/profiles/index.d.ts

@@ -1,4 +1,4 @@
 export { deleteGame } from "./delete-game.ts";
 export { pastGameLines, pastGames } from "./past-games.ts";
-export { chooseDrawnAvatar, editProfile, GameGoingOn, newProfile, playerLine, profiles, ratingsText, setAvatar, useProfile } from "./profiles.ts";
+export { chooseDrawnAvatar, editProfile, GameGoingOn, newProfile, playerLine, profiles, ratingsText, setAvatar, siteText, useProfile } from "./profiles.ts";
 export { ratingsAge, refreshRatings } from "./ratings.ts";

package/dist/commands/profiles/index.js

@@ -1,5 +1,5 @@
 // The commands on the players: their profiles, their ratings read from the sites, their past games and the deletion of one.
 export { deleteGame } from "./delete-game.js";
 export { pastGameLines, pastGames } from "./past-games.js";
-export { chooseDrawnAvatar, editProfile, GameGoingOn, newProfile, playerLine, profiles, ratingsText, setAvatar, useProfile } from "./profiles.js";
+export { chooseDrawnAvatar, editProfile, GameGoingOn, newProfile, playerLine, profiles, ratingsText, setAvatar, siteText, useProfile } from "./profiles.js";
 export { ratingsAge, refreshRatings } from "./ratings.js";

package/dist/commands/profiles/profiles.d.ts

@@ -1,10 +1,12 @@
 import { z } from "zod";
-import { type DrawnAvatar, type PlayerProfile } from "../../profiles/index.ts";
+import { type DrawnAvatar, type PlayerProfile, type RatingSite } from "../../profiles/index.ts";
 import { type Context } from "../registry/index.ts";
 /** A change of profile refused while a game goes on: the page says it in the player's language. */
 export declare class GameGoingOn extends Error {
     constructor();
 }
+/** A site's name as the AI's lines write it. */
+export declare const siteText: Readonly<Record<RatingSite, string>>;
 /** The profiles, the one in use first. */
 export declare const profiles: import("../registry/registry.ts").Command<z.ZodObject<{}, z.core.$strip>, {
     profiles: PlayerProfile[];

package/dist/commands/profiles/profiles.js

@@ -13,6 +13,8 @@ export class GameGoingOn extends Error {
         super("A game is going on in this profile: finish it, or resign, before changing profile. Nothing changed.");
     }
 }
+/** A site's name as the AI's lines write it. */
+export const siteText = { "lichess": "Lichess", "chess.com": "Chess.com" };
 /** The profiles, the one in use first. */
 export const profiles = defineCommand({
     name: "profiles",
@@ -160,7 +162,6 @@ function isPlaying(context) {
     return current !== undefined && endOf(current.game) === undefined;
 }
 const levelText = { learning: "has just learned", casual: "plays now and then", regular: "plays often", tournament: "plays tournaments" };
-const siteText = { "lichess": "Lichess", "chess.com": "Chess.com" };
 function playerText(profile) {
     const { name, level } = profile;
     const ratings = ratingsText(profile);

package/dist/commands/registry/context.d.ts

@@ -20,7 +20,10 @@ export interface Context {
     pageOpen?: () => boolean;
     /** Opens a folder in the system's file manager: the data folder, from the board page; whether it could; none in the tests. */
     openFolder?: (folder: string) => Promise<boolean>;
-    /** Asks the sites the player plays on for their ratings (D-105): only the page and the command line, never a tool of the AI's (D-106); none in the tests. */
+    /**
+     * Asks the sites the player plays on: their ratings (D-105), only for the page and the command line, never a tool of the AI's (D-106); their latest
+     * games, which the tool site_games asks too (D-110); none in the tests.
+     */
     fetch?: typeof globalThis.fetch;
     /** Opens the New game window on the board pages open now, where the player chooses the game: whether one was open. */
     askNewGame?: () => boolean;

package/dist/commands/registry/registry.d.ts

@@ -12,6 +12,8 @@ export interface Command<Schema extends z.ZodObject = z.ZodObject, Result = unkn
     destructive?: boolean;
     /** Calling the command again with the same input changes nothing more. */
     idempotent?: boolean;
+    /** The command may ask a site outside this computer, as site_games asks Lichess and Chess.com (D-110); every other one stays local. */
+    openWorld?: true;
     /** Hosts load the tool at once instead of on demand: for the ones the AI calls at the start of every chat. */
     alwaysLoad?: boolean;
     /** Its answer shows the chat the game as it is: the chat may move on it, and on no other (D-71). */

package/dist/core/accounts.d.ts

@@ -0,0 +1,11 @@
+import type { Side } from "./game.ts";
+/** The player's names on the sites they play on, from their profile. */
+export interface SiteNames {
+    readonly lichess?: string;
+    readonly chesscom?: string;
+}
+/**
+ * The side a game loaded from elsewhere names by one of the player's names on the sites (D-93): the one of its site when the Site tag says Lichess or
+ * chess.com, either otherwise; none when neither side, or both, has one.
+ */
+export declare function accountSide(tags: Readonly<Record<string, string | undefined>>, names: SiteNames | undefined): Side | undefined;

package/dist/core/accounts.js

@@ -0,0 +1,14 @@
+/**
+ * The side a game loaded from elsewhere names by one of the player's names on the sites (D-93): the one of its site when the Site tag says Lichess or
+ * chess.com, either otherwise; none when neither side, or both, has one.
+ */
+export function accountSide(tags, names) {
+    const site = (tags.Site ?? "").toLowerCase();
+    const known = [
+        site.includes("chess.com") ? undefined : names?.lichess,
+        site.includes("lichess") ? undefined : names?.chesscom,
+    ].filter((name) => name !== undefined).map((name) => name.trim().toLowerCase());
+    const white = known.includes(tags.White?.trim().toLowerCase() ?? "");
+    const black = known.includes(tags.Black?.trim().toLowerCase() ?? "");
+    return white === black ? undefined : white ? "white" : "black";
+}

package/dist/core/index.d.ts

@@ -1,3 +1,4 @@
+export { accountSide, type SiteNames } from "./accounts.ts";
 export { boardText, figurinesOf } from "./board-text.ts";
 export { canMate, clockAfterMove, clockOfComment, clockStarted, clockTag, clockText, startClock, timeControlOf, timeControlOfTag, timeControlTag, timeControlText, timeLeft } from "./clock.ts";
 export type { Clock, TimeControl } from "./clock.ts";

package/dist/core/index.js

@@ -1,4 +1,5 @@
 // The chess core: the game and its rules, the facts of a position, its record, PGN, the openings. It runs in the browser too (D-17, D-18).
+export { accountSide } from "./accounts.js";
 export { boardText, figurinesOf } from "./board-text.js";
 export { canMate, clockAfterMove, clockOfComment, clockStarted, clockTag, clockText, startClock, timeControlOf, timeControlOfTag, timeControlTag, timeControlText, timeLeft } from "./clock.js";
 export { Game, withSanLetters } from "./game.js";

package/dist/page/app/app.js

@@ -11,7 +11,7 @@ import { piecesOf } from "../board/squares.js";
 import { NewGameDialog } from "../dialogs/new-game.js";
 import { NameButton, ProfileDialog, ProfilesDialog, Wizard } from "../dialogs/profiles.js";
 import { SettingsPanel } from "../dialogs/settings.js";
-import { playerIn, studiedSides } from "../dialogs/studied.js";
+import { othersOf, playerIn, studiedSides } from "../dialogs/studied.js";
 import { StudyDialog } from "../dialogs/study.js";
 import { BadgeCounts } from "../game/badges.js";
 import { stepped } from "../game/browse.js";
@@ -231,7 +231,7 @@ export function App({ start }) {
     const playedName = game === undefined || game === null ? undefined : anchorName(game.name);
     useAnchor({ ready: served !== undefined, shown: studied !== undefined ? anchorName(studied.name) : idle ? undefined : playedName, played: playedName, going }, viewing, (plies) => goTo(plies ?? total), async (wanted) => await post("/api/study", { game: wanted, look: true }, text, name) === undefined);
     // The tab names the game and the move shown, as the cards name its players; between games, Chesspal alone.
-    const titled = idle || served === undefined ? undefined : studiedSides(live.record.tags, served.profile.name, playedAs, text.sides, served.profile.accounts);
+    const titled = idle || served === undefined ? undefined : studiedSides(live.record.tags, served.profile.name, playedAs, text.sides, served.profile.accounts, othersOf(served.profiles, served.profile.id));
     useTabTitle(titled === undefined ? undefined : tabTitle(titled.white.name, titled.black.name, at === 0 ? undefined : plies[at - 1]));
     // The header's theme switch picks the other of the two the page shows, leaving the system's.
     const switchTheme = () => change({ ...settings, theme: document.documentElement.dataset.theme === "dark" ? "light" : "dark" });
@@ -281,7 +281,7 @@ export function App({ start }) {
     const profile = served.profile;
     const picture = _jsx(PlayerPicture, { profile: profile });
     // In analysis the cards name the players of the game, the player's side at the bottom when they played it (D-69).
-    const sides = studied === undefined ? undefined : studiedSides(live.record.tags, profile.name, playedAs, text.sides, profile.accounts);
+    const sides = studied === undefined ? undefined : studiedSides(live.record.tags, profile.name, playedAs, text.sides, profile.accounts, othersOf(served.profiles, profile.id));
     const player = sides?.bottom ?? (game === null || game.ai === "black" ? "white" : "black");
     const ai = player === "white" ? "black" : "white";
     // The Torretta's face on the move shown: the mood the AI gave, while it lasts (D-70); in analysis, of the side the AI played.
@@ -414,7 +414,7 @@ export function App({ start }) {
         act("/api/new", { ai_colour: colour === "random" ? "random" : colour === "white" ? "black" : "white", level: chosen, ...(control === undefined ? {} : { clock: control }) });
     };
     // In analysis the AI's note goes with the other side's card and the talk with the player's, turned round with the board as in a game (D-101, Zoe).
-    const studiedCard = (side, place) => sides === undefined ? null : (_jsx(PlayerCard, { place: place, picture: pictureOf(sides[side], profile, 48, mood), name: sides[side].name, signed: sides[side].who === "ai" && playedBy !== undefined ? signature(playedBy.model, playedBy.effort) : undefined, side: side, taken: material.taken[side], ahead: ahead(side), badges: _jsx(BadgeCounts, { plies: plies, side: side, names: text.badges }), text: text }));
+    const studiedCard = (side, place) => sides === undefined ? null : (_jsx(PlayerCard, { place: place, picture: pictureOf(sides[side], profile, served.profiles, 48, mood), name: sides[side].name, signed: sides[side].who === "ai" && playedBy !== undefined ? signature(playedBy.model, playedBy.effort) : undefined, side: side, taken: material.taken[side], ahead: ahead(side), badges: _jsx(BadgeCounts, { plies: plies, side: side, names: text.badges }), text: text }));
     // A game brought to analyse: the page shows it once the server has it in analysis; a refusal stays in the dialog. One the AI has to go over, with no
     // chat at the table, opens the chat's window: the analyst works with the chat's model (D-109).
     const studyGame = async (studied) => {
@@ -427,7 +427,7 @@ export function App({ start }) {
         setDialog(toReview ? "chat" : undefined);
         return undefined;
     };
-    return (_jsx(ChosenSet.Provider, { value: settings.set, children: _jsxs(PointSquare.Provider, { value: pointSquare, children: [panel, _jsx(ProfileDialog, { open: dialog === "profile", profile: profile, onClose: () => setDialog(undefined), text: text }), _jsx(ProfilesDialog, { open: dialog === "profiles", profiles: served.profiles, active: profile, locked: going ? text.profile.whilePlaying : undefined, dataFolder: served.dataFolder, onEdit: () => setDialog("profile"), onClose: () => setDialog(undefined), text: text }), table === undefined ? null : _jsx(ChatDialog, { open: dialog === "chat", review: chatToReview, table: table, settings: settings, onChange: change, name: name, onClose: closeChat, text: text }), _jsx(NewGameDialog, { open: dialog === "new-game", choice: choice, going: going, onStart: startNewGame, onClose: () => setDialog(undefined), text: text }), guide, _jsx(StudyDialog, { open: dialog === "study", onStudy: studyGame, onClose: () => setDialog(undefined), you: profile.name, accounts: profile.accounts, ai: name, text: text }), served.update === undefined || served.table === undefined
+    return (_jsx(ChosenSet.Provider, { value: settings.set, children: _jsxs(PointSquare.Provider, { value: pointSquare, children: [panel, _jsx(ProfileDialog, { open: dialog === "profile", profile: profile, onClose: () => setDialog(undefined), text: text }), _jsx(ProfilesDialog, { open: dialog === "profiles", profiles: served.profiles, active: profile, locked: going ? text.profile.whilePlaying : undefined, dataFolder: served.dataFolder, onEdit: () => setDialog("profile"), onClose: () => setDialog(undefined), text: text }), table === undefined ? null : _jsx(ChatDialog, { open: dialog === "chat", review: chatToReview, table: table, settings: settings, onChange: change, name: name, onClose: closeChat, text: text }), _jsx(NewGameDialog, { open: dialog === "new-game", choice: choice, going: going, onStart: startNewGame, onClose: () => setDialog(undefined), text: text }), guide, _jsx(StudyDialog, { open: dialog === "study", onStudy: studyGame, onClose: () => setDialog(undefined), onProfile: () => setDialog("profile"), you: profile.name, accounts: profile.accounts, others: othersOf(served.profiles, profile.id), ai: name, text: text }), served.update === undefined || served.table === undefined
                     ? null
                     : (_jsx(UpdateDialog, { open: dialog === "update", version: served.update.version, current: served.version, installing: served.update.installing === true, installed: served.update.installed === true, going: going, chat: served.table.chat ? (served.table.held ? "held" : "byHand") : undefined, name: name, onClose: () => setDialog(undefined), text: text })), offline ? _jsx("p", { class: "offline", role: "alert", children: text.offline(name) }) : null, served.outdated === true
                     ? _jsx("p", { class: "outdated", role: "status", children: text.outdated(name) })
@@ -435,7 +435,7 @@ export function App({ start }) {
                         ? _jsx(UpdateNotice, { version: served.update.version, name: name, text: text })
                         : null, _jsxs("main", { class: `app${flipped ? " flipped" : ""}${folds.talk === "open" ? "" : ` talk-${folds.talk}`}${folds.game === "folded" ? " folded" : ""}`, inert: offline, children: [header, sides === undefined
                             ? (_jsx(TalkFaces, { name: name, aiPicture: thinker(40), you: profile.name, picture: picture, ...(idle ? {} : { ai, player }), aiMoves: going && !playerToMove, playerMoves: playerToMove, unread: unread || asleep, text: text }))
-                            : (_jsx(TalkFaces, { name: sides[ai].name, aiPicture: pictureOf(sides[ai], profile, 40, mood), you: sides[player].name, picture: pictureOf(sides[player], profile, 40, mood), ai: ai, player: player, aiMoves: false, playerMoves: false, unread: asleep, text: text })), _jsx(FoldTab, { column: "talk", folded: folds.talk === "folded", label: thinking === undefined || folds.talk !== "folded" ? text.talk : `${text.talk}: ${text.thinking[thinking]}`, unread: (unread || asleep) && folds.talk === "folded", ...(thinking === undefined || folds.talk !== "folded" ? {} : { mark: _jsx(Thought, { thinking: thinking, words: text.thinking }) }), onFold: fold }), _jsx(FoldTab, { column: "game", folded: folds.game === "folded", label: text.game, onFold: fold }), _jsx("span", { class: "visually-hidden", "aria-live": "polite", children: unread ? text.wrote(name) : "" }), _jsx("div", { class: sides === undefined ? "talk" : "talk studied", id: "talk", children: sides !== undefined && studied !== undefined
+                            : (_jsx(TalkFaces, { name: sides[ai].name, aiPicture: pictureOf(sides[ai], profile, served.profiles, 40, mood), you: sides[player].name, picture: pictureOf(sides[player], profile, served.profiles, 40, mood), ai: ai, player: player, aiMoves: false, playerMoves: false, unread: asleep, text: text })), _jsx(FoldTab, { column: "talk", folded: folds.talk === "folded", label: thinking === undefined || folds.talk !== "folded" ? text.talk : `${text.talk}: ${text.thinking[thinking]}`, unread: (unread || asleep) && folds.talk === "folded", ...(thinking === undefined || folds.talk !== "folded" ? {} : { mark: _jsx(Thought, { thinking: thinking, words: text.thinking }) }), onFold: fold }), _jsx(FoldTab, { column: "game", folded: folds.game === "folded", label: text.game, onFold: fold }), _jsx("span", { class: "visually-hidden", "aria-live": "polite", children: unread ? text.wrote(name) : "" }), _jsx("div", { class: sides === undefined ? "talk" : "talk studied", id: "talk", children: sides !== undefined && studied !== undefined
                                 ? (_jsxs(_Fragment, { children: [_jsxs("section", { class: "ai-block", "aria-label": sides[ai].name, children: [studiedCard(ai, "ai"), asleepNote, _jsx(AiNote, { ...(reviewed === undefined ? {} : { ply: reviewed }), ...(shownOpening === undefined ? {} : { opening: shownOpening }), ...(at === total && closing !== undefined ? { closing } : {}), ...(at === 0 && summary !== undefined ? { summary } : {}), ...(reviewing ? { reviewing: true } : {}), ...(completeIt === undefined ? {} : { onComplete: completeIt }), name: analyst, by: annotator, mood: mood, ...(settings.voice ? { voice: text } : {}), text: text })] }), _jsxs("section", { class: "you-block", "aria-label": sides[player].name, children: [_jsx("div", { class: "chat", children: _jsx(Compose, { lines: analysisTalk(talk, studied.name), newestFirst: false, spent: 0, draft: draft, onDraft: (words) => {
                                                             setDraft(words);
                                                             setUnsent(undefined);
@@ -460,9 +460,10 @@ export function App({ start }) {
                                 },
                             }), shownPlies: at, onShow: goTo, onStep: step, ...(studied === undefined ? {} : { onDownload: () => download(studied.pgn, pgnName(live.record.tags, "analysis")) }), ...(total === 0 ? {} : { onSaveMoves: () => download(writePgn(movesOnly(live.record)), pgnName(live.record.tags)) }), ...(between && game !== null && replayed.record.moves.length > 0 ? { onAnalyse: () => void studyGame({ last: true }) } : {}), text: text }), _jsx(PageFoot, { version: served.version, text: text })] })] }) }));
 }
-/** The picture of a player of the game in analysis: the player's own, the AI's Torretta with its mood, or the plain face of someone else. */
-function pictureOf({ who }, profile, size, mood) {
-    return who === "ai" ? _jsx(Torretta, { size: size, mood: mood, bust: true }) : _jsx(PlayerPicture, { profile: who === "player" ? profile : undefined, size: size });
+/** The picture of a player of the game in analysis: the player's own, the AI's Torretta with its mood, another profile's, or the plain face of someone else. */
+function pictureOf({ who, profile: other }, profile, profiles, size, mood) {
+    const shown = who === "player" ? profile : profiles.find(({ id }) => id === other);
+    return who === "ai" ? _jsx(Torretta, { size: size, mood: mood, bust: true }) : _jsx(PlayerPicture, { profile: shown, size: size });
 }
 /**
  * Plays the sound of each move the game gains while the page watches it, the AI's and the player's, of its end without a move and of a draw offered: