chesspal 0.3.6 → 0.4.0

package/dist/commands/answers/opening-book.js

@@ -1,45 +1,31 @@
-// The book of the openings the build indexed (D-16), read once at the first lookup; the book's moves, only for a game at the master level (D-60).
+// The book of the openings the build indexed (D-16), read once at the first lookup: where a game is in it (D-68) at every level, its moves for the master (D-60).
 import { readFileSync } from "node:fs";
-import { bookMoves, Game, inOpenings, openingOf, outOfBookMove } from "../../core/index.js";
+import { bookMoves, bookPlaceOf, Game, outOfBookMove, positionKeysOf } from "../../core/index.js";
 // The index of the named openings and the book of their moves, each read at its first lookup; null where the build made none.
 let index;
 let book;
 // Each record is looked up once: the live game keeps its record until a move changes it.
-const lines = new WeakMap();
-/** The game's opening as the AI reads it: ECO and name, and the move it left the book at; none outside the book, or where the build made no index. */
-export function openingLine(record) {
-    let line = lines.get(record);
-    if (line === undefined) {
-        line = lineOf(record) ?? null;
-        lines.set(record, line);
+const places = new WeakMap();
+/**
+ * The game's opening as the AI reads it: ECO and name, and the move it left the book at (D-68); none outside the book, or where the build made no index.
+ * A live game gives the positions it went through; a record alone is replayed.
+ */
+export function openingLine(game) {
+    const place = bookPlace(game);
+    if (place?.opening === undefined) {
+        return undefined;
     }
-    return line ?? undefined;
+    const left = outOfBookMove(recordOf(game).moves.length, place.plies);
+    return `${place.opening.eco} ${place.opening.name}${left === undefined ? "" : ` (out of book since move ${left})`}`;
 }
 /** The moves the book knows from a position (D-15), for the AI at the master level; none out of the book, or where the build made no book. */
 export function knownMoves(fen) {
     const moves = openingBook();
     return moves === undefined ? [] : bookMoves(fen, moves);
 }
-/** How many plies from the start the book knows, to the last before the game left it (D-69); none from another position. */
-export function bookPlies(record) {
-    if (record.tags.FEN !== undefined) {
-        return 0;
-    }
-    const game = new Game({ tags: record.tags, moves: [] });
-    let plies = 0;
-    for (const { san } of record.moves) {
-        if (!game.playRecorded(san).played || !bookReaches(game.position.fen)) {
-            break;
-        }
-        plies++;
-    }
-    return plies;
-}
-/** Whether a line of Lichess's openings reaches a position, by any order of moves (D-68); never where the build made no book. */
-export function bookReaches(fen) {
-    const named = openingIndex();
-    const moves = openingBook();
-    return named !== undefined && moves !== undefined && inOpenings(fen, named, moves);
+/** How many plies from the start the book knows, to the last before the game left it (D-68, D-69); none from another position. */
+export function bookPlies(game) {
+    return bookPlace(game)?.plies ?? 0;
 }
 /** The opening a game reached, ECO and name, without where it left the book: for the games in the archive. */
 export function openingName(record) {
@@ -48,15 +34,25 @@ export function openingName(record) {
 }
 /** The last named opening a game reached, and at which ply; none outside the book, or where the build made no index. */
 export function bookOpening(record) {
-    const named = openingIndex();
-    return named === undefined ? undefined : openingOf(record, named);
+    return bookPlace(record)?.opening;
 }
-function lineOf(record) {
-    const opening = bookOpening(record);
-    if (opening === undefined) {
-        return undefined;
+/**
+ * Where a game stands in the book, its opening and its plies the book knows, once per record: from the positions a live game went through, or a record
+ * replayed; none from another position, or where the build made no index.
+ */
+export function bookPlace(game) {
+    const record = recordOf(game);
+    let place = places.get(record);
+    if (place === undefined) {
+        const named = openingIndex();
+        const keys = game instanceof Game ? game.positionKeys : positionKeysOf(record);
+        place = named === undefined ? null : bookPlaceOf(keys, named, openingBook()) ?? null;
+        places.set(record, place);
     }
-    return `${opening.eco} ${opening.name}${opening.inBook ? "" : ` (out of book since move ${outOfBookMove(opening)})`}`;
+    return place ?? undefined;
+}
+function recordOf(game) {
+    return game instanceof Game ? game.record : game;
 }
 function openingBook() {
     if (book === undefined) {
@@ -64,7 +60,7 @@ function openingBook() {
             book = JSON.parse(readFileSync(new URL("../../../dist/core/book.json", import.meta.url), "utf8"));
         }
         catch {
-            // Not built yet: the master goes without the book.
+            // Not built yet: no game is in the book, and the master goes without its moves.
             book = null;
         }
     }

package/dist/commands/answers/opening-tags.d.ts

@@ -0,0 +1,4 @@
+import type { GameRecord } from "../../core/index.ts";
+import type { OpeningTags } from "../../games/index.ts";
+/** The opening a game reached, in the ECO and Opening tags the archive writes: none from another position or outside the book. */
+export declare function openingTags(record: GameRecord): OpeningTags;

package/dist/commands/answers/opening-tags.js

@@ -0,0 +1,11 @@
+import { openingName } from "./opening-book.js";
+/** The opening a game reached, in the ECO and Opening tags the archive writes: none from another position or outside the book. */
+export function openingTags(record) {
+    const opening = openingName(record);
+    if (opening === undefined) {
+        return {};
+    }
+    // The ECO code, then the name: B50 Sicilian Defense.
+    const space = opening.indexOf(" ");
+    return { ECO: opening.slice(0, space), Opening: opening.slice(space + 1) };
+}

package/dist/commands/answers/play-move.d.ts

@@ -14,12 +14,14 @@ export interface WithMove {
     allowance?: number;
     /** A coach judges the player's moves with the helps on (D-88): the AI reads it after the player's move. */
     coached?: boolean;
+    /** The chat's host runs the doorbell: the AI refused a move hears the page will wake it, else that the player tells it. */
+    doorbell?: boolean;
 }
 /**
  * Plays a move for one side `now` and saves the game, with the time it took and the clock after it in its comment ([%clk]). A refused move, or words refused
  * with it, change nothing: it throws the message `refused` writes from the core's.
  */
-export declare function playMove(folder: string, now: Date, mover: Mover, text: string, refused: (message: string, legal: readonly string[]) => string, { comment, said, offerDraw, allowance, coached }?: WithMove): MovePlayed;
+export declare function playMove(folder: string, now: Date, mover: Mover, text: string, refused: (message: string, legal: readonly string[]) => string, { comment, said, offerDraw, allowance, coached, doorbell }?: WithMove): MovePlayed;
 /** A chat's move, resignation or game replaced on a position it has not seen (D-71): it was decided on another. */
 export declare class PositionChanged extends Error {
     constructor();

package/dist/commands/answers/play-move.js

@@ -1,21 +1,24 @@
 // A move of the AI or of the player on the current game: played, timed by the clock, saved, and archived when it ends the game.
 import { clockAfterMove, clockTag } from "../../core/index.js";
 import { archiveEnded, endOf, loadGame, saveGame, talkLine } from "../../games/index.js";
+import { toldMove } from "./lines.js";
+import { openingTags } from "./opening-tags.js";
 import { gameGoingOn, summaryOf, withThought } from "./summary.js";
 import { colourName } from "./view.js";
 /**
  * Plays a move for one side `now` and saves the game, with the time it took and the clock after it in its comment ([%clk]). A refused move, or words refused
  * with it, change nothing: it throws the message `refused` writes from the core's.
  */
-export function playMove(folder, now, mover, text, refused, { comment, said, offerDraw = false, allowance = 0, coached = false } = {}) {
+export function playMove(folder, now, mover, text, refused, { comment, said, offerDraw = false, allowance = 0, coached = false, doorbell = true } = {}) {
     // A flag falls only past the allowance.
-    const before = gameToMove(folder, mover, new Date(now.getTime() - allowance));
+    const before = gameToMove(folder, mover, new Date(now.getTime() - allowance), doorbell);
     const { game } = before;
     const position = game.position;
     // The words are checked before the move, which changes the live game; they count as said after it.
     const line = said === undefined ? undefined : talkLine(before, mover, said.text, said.at, game.record.moves.length + 1);
     if (mover === "ai" && before.clock?.waiting === true) {
-        throw new Error("The clocks wait for the player to start the game with Start on the board page: don't move yet, the doorbell wakes you then. Nothing changed.");
+        const then = doorbell ? "the doorbell wakes you then" : "call status when they tell you they did";
+        throw new Error(`The clocks wait for the player to start the game with Start on the board page: don't move yet, ${then}. Nothing changed.`);
     }
     if (offerDraw && game.record.moves.length === 0) {
         throw new Error("A draw can be offered once each side has made a move: play the move without offer_draw. Nothing changed.");
@@ -37,7 +40,7 @@ export function playMove(folder, now, mover, text, refused, { comment, said, off
         current.talk.push(line);
     }
     saveGame(folder, current);
-    const { archive, warning } = endOf(game) === undefined ? {} : archiveEnded(folder, current);
+    const { archive, warning } = endOf(game) === undefined ? {} : archiveEnded(folder, current, openingTags(game.record));
     const result = { move: `${position.moveNumber}${position.turn === "white" ? "." : "..."}${played.move.san}`, game: withThought(summaryOf(current, now, archive), folder, current, coached) };
     if (played.note !== undefined) {
         result.note = played.note;
@@ -80,7 +83,7 @@ export function refuseOtherGame(context, folder) {
 export function samePosition(one, other) {
     return one.started === other.started && one.plies === other.plies;
 }
-function gameToMove(folder, mover, now) {
+function gameToMove(folder, mover, now, doorbell) {
     const current = gameGoingOn(folder, now);
     const { turn } = current.game.position;
     const aiToMove = turn === current.ai;
@@ -88,7 +91,7 @@ function gameToMove(folder, mover, now) {
         throw new Error(`It is your move (${colourName(turn)}): call ai_move. Nothing changed.`);
     }
     if (mover === "ai" && !aiToMove) {
-        throw new Error(`It is the player's move (${colourName(turn)}): wait for it, then call player_move. Nothing changed.`);
+        throw new Error(`It is the player's move (${colourName(turn)}): ${doorbell ? "wait for it, then call player_move." : toldMove} Nothing changed.`);
     }
     return current;
 }

package/dist/commands/answers/say.js

@@ -4,6 +4,7 @@ import { archiveEnded, endOf, gameInAnalysis, loadGame, loadTableTalk, saveGame,
 import { gameFolder, helpsIn } from "../../profiles/index.js";
 import { gameAt } from "./clock.js";
 import { shownMove } from "./lines.js";
+import { openingTags } from "./opening-tags.js";
 /**
  * Adds a line to the talk of the current game, going on or just over, and saves it; the AI's mood once the game is over, which the archive keeps too (D-70).
  * With no game the line goes in the talk before it (D-77). A line refused changes nothing: it throws, in words for whoever spoke.
@@ -24,7 +25,7 @@ export function say(folder, who, text, at, mood, shown) {
     }
     saveGame(folder, current);
     if (mood !== undefined) {
-        archiveEnded(folder, current);
+        archiveEnded(folder, current, openingTags(current.game.record));
     }
     return current;
 }

package/dist/commands/answers/summary.d.ts

@@ -77,10 +77,13 @@ export declare function withThought(summary: GameSummary, folder: string, curren
 export declare function gameGoingOn(folder: string, now: Date): CurrentGame;
 /** Whether a game has no move yet, or was closed before any: nothing to go over. */
 export declare function unplayed(summary: GameSummary): boolean;
-/** How a game ended, in words: its result, and how it came when known. */
+/**
+ * How a game ended, in words: its result, and how it came when known, each colour named with who played it, the AI as `aiName`:
+ * "0-1, White (the player) resigns", "1-0, White (you) checkmates Black (the player)".
+ */
 export declare function endText({ result, termination }: {
     result: string;
     termination?: string;
-}): string;
+}, ai: Side, aiName?: string): string;
 /** The last plies of a record, numbered as a player writes them, from the move number and side of its FEN. */
 export declare function lastMoves(record: GameRecord, count: number): string;

package/dist/commands/answers/summary.js

@@ -14,7 +14,7 @@ export function summaryOf(current, now, archive) {
     if (lastMove !== undefined) {
         summary.lastMove = { move: lastMoves(record, 1), from: lastMove.from, to: lastMove.to };
     }
-    const opening = openingLine(record);
+    const opening = openingLine(game);
     const clock = clockSummaryOf(current, now);
     const drawOffer = drawOfferOf(current);
     if (drawOffer !== undefined) {
@@ -58,7 +58,7 @@ export function gameGoingOn(folder, now) {
     }
     const end = endOf(current.game);
     if (end !== undefined) {
-        throw new Error(`The game is over (${endText(end)}): new_game starts another. Nothing changed.`);
+        throw new Error(`The game is over (${endText(end, current.ai)}): new_game starts another. Nothing changed.`);
     }
     return current;
 }
@@ -66,9 +66,20 @@ export function gameGoingOn(folder, now) {
 export function unplayed(summary) {
     return summary.lastMoves === "";
 }
-/** How a game ended, in words: its result, and how it came when known. */
-export function endText({ result, termination }) {
-    return termination === undefined ? result : `${result}, ${termination}`;
+/**
+ * How a game ended, in words: its result, and how it came when known, each colour named with who played it, the AI as `aiName`:
+ * "0-1, White (the player) resigns", "1-0, White (you) checkmates Black (the player)".
+ */
+export function endText({ result, termination }, ai, aiName = "you") {
+    if (termination === undefined) {
+        return result;
+    }
+    const named = (colour) => `${colour} (${colour.toLowerCase() === ai ? aiName : "the player"})`;
+    if (termination === "checkmate" && result !== "1/2-1/2") {
+        const winner = result === "1-0" ? "White" : "Black";
+        return `${result}, ${named(winner)} checkmates ${named(winner === "White" ? "Black" : "White")}`;
+    }
+    return `${result}, ${termination.replace(/\b(White|Black)\b/g, named)}`;
 }
 /** The last plies of a record, numbered as a player writes them, from the move number and side of its FEN. */
 export function lastMoves(record, count) {

package/dist/commands/game/ai-move.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { boardText, drawingsText, moods, moodTag } from "../../core/index.js";
 import { commentWithPlan, talkLimits } from "../../games/index.js";
-import { coachAgent, ponderAgentFor } from "../../host-files/index.js";
+import { coachAgent, hasDoorbell, ponderAgentFor } from "../../host-files/index.js";
 import { gameFolder, helpsIn } from "../../profiles/index.js";
 import { agentRuns, agentsLine, arrowsInput, closingLines, coachRuns, drawingsOf, give, moveLines, playMove, refuseUnseenPosition, shownMove, squaresInput, waitingWords, withAnalyst } from "../answers/index.js";
 import { defineCommand, sentence } from "../registry/index.js";
@@ -36,12 +36,12 @@ export const aiMove = defineCommand({
         // The player's words are read before the move, which would count as the answer to them; a move refused leaves them for the next call.
         const waiting = waitingWords(context);
         const words = [commentWithPlan(comment, plan), drawingsText(drawings), mood === undefined ? "" : moodTag(mood)].filter((part) => part !== "").join(" ");
-        const played = playMove(folder, context.now(), "ai", move, (message, legal) => `${message} Legal: ${legal.join(" ")}. Nothing changed.`, { comment: words, offerDraw });
+        const played = playMove(folder, context.now(), "ai", move, (message, legal) => `${message} Legal: ${legal.join(" ")}. Nothing changed.`, { comment: words, offerDraw, doorbell: hasDoorbell(context.host?.()) });
         const agents = agentsAfter(context, folder, played);
         const board = context.pageOpen?.() === true ? {} : { board: true };
         return { ...played, game: withAnalyst(played.game, context), words: give(context, waiting), ...(agents.length === 0 ? {} : { agents }), ...board };
     },
-    format: (result) => {
+    format: (result, context) => {
         // The mood the AI has just given is not told back: player_move and status tell it while it lasts (Priya).
         const game = { ...result.game };
         delete game.mood;
@@ -51,7 +51,7 @@ export const aiMove = defineCommand({
             ...moveLines({ ...result, game }),
             ...(result.board === true ? ["No board page is open: copy this board into your message.", boardText(result.game.fen)] : []),
             ...(result.agents === undefined ? [] : [agentsLine(result.agents)]),
-            ...closingLines(result.game, result.words),
+            ...closingLines(result.game, result.words, false, hasDoorbell(context?.host?.())),
         ].join("\n");
     },
 });

package/dist/commands/game/coach.js

@@ -3,7 +3,7 @@ import { badges, Game, leadText, levelOf, materialOf, withSanLetters } from "../
 import { archiveCoached, coachWaitingSince, coachWords, endOf, keepHint, keepJudgment, keepLead, loadGame, startCoach } from "../../games/index.js";
 import { agentHosts, coachAgent } from "../../host-files/index.js";
 import { activeProfile, gameFolder, helpsIn } from "../../profiles/index.js";
-import { aheadWords, arrowsInput, clockLine, clockSummaryOf, colourName, compactView, drawingsOf, knownMoves, lastMoves, leadFrom, leadInput, materialText, noteInput, openingLine, riskLine, speechLine, speechOf, squaresInput, } from "../answers/index.js";
+import { aheadWords, arrowsInput, clockLine, clockSummaryOf, colourName, compactView, drawingsOf, endText, knownMoves, lastMoves, leadFrom, leadInput, materialText, noteInput, openingLine, openingTags, riskLine, speechLine, speechOf, squaresInput, } from "../answers/index.js";
 import { ratingsText } from "../profiles/index.js";
 import { defineCommand } from "../registry/index.js";
 import { waitForPlayer, wordsOf } from "./ponder.js";
@@ -149,7 +149,7 @@ function startOf(current, folder, context) {
     const head = over === undefined
         ? `Game "${place.game}", position ${plies}: the player (${colourName(player)}) to move, move ${game.position.moveNumber}; the opponent plays ${colourName(ai)} at the `
             + `${levelOf(record)} level.`
-        : `Game "${place.game}", position ${plies}: the game is over, ${over.result}${over.termination === undefined ? "" : `, ${over.termination}`}, with ${ender} move.`;
+        : `Game "${place.game}", position ${plies}: the game is over, ${endText(over, ai, "the opponent")}, with ${ender} move.`;
     const speech = speechOf(folder, context.language);
     const clock = clockSummaryOf(current, context.now());
     const keepLine = over === undefined
@@ -160,7 +160,7 @@ function startOf(current, folder, context) {
         head,
         speech === undefined ? "The player speaks English." : speechLine(speech),
         ...playerLines(context),
-        ...movesLines(record),
+        ...movesLines(game),
         ...(clock === undefined ? [] : [clockLine(clock, ai)]),
         ...(judged === undefined ? [] : judgedLines(current, judged, player)),
         ...(over === undefined ? nowLines(current, folder, player) : []),
@@ -168,8 +168,9 @@ function startOf(current, folder, context) {
     ];
 }
 /** The game's moves as the coach reads them, with the position a game set up began in, the last ones of a long game, and its opening by the book (Anatolij). */
-function movesLines(record) {
-    const opening = openingLine(record);
+function movesLines(game) {
+    const { record } = game;
+    const opening = openingLine(game);
     return [
         ...(record.tags.FEN === undefined ? [] : [`The game began from a set position: ${record.tags.FEN}`]),
         `${record.moves.length > pliesShown ? `Moves (the last ${pliesShown} plies)` : "Moves"}: ${lastMoves(record, pliesShown)}`,
@@ -291,7 +292,7 @@ function keep(folder, current, place, { ahead, badge, note, hint, arrows, square
     const hintLeft = hint !== undefined && !toMove;
     if (over) {
         // The game went to the archive with the move that ended it: the judgment goes there too.
-        archiveCoached(folder, current);
+        archiveCoached(folder, current, openingTags(current.game.record));
         return { kept: place, then: "over", saved, hintLeft };
     }
     if (!toMove) {

package/dist/commands/game/end.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { canMate, endWithMood, Game, moods, timeLeft } from "../../core/index.js";
 import { archiveEnded, bothSidesMoved, drawOfferOf, saveGame } from "../../games/index.js";
 import { gameFolder } from "../../profiles/index.js";
-import { colourName, gameGoingOn, nextStep, positionLines, refuseUnseenPosition, summaryOf, withAnalyst } from "../answers/index.js";
+import { colourName, gameGoingOn, nextStep, openingTags, positionLines, refuseUnseenPosition, summaryOf, withAnalyst } from "../answers/index.js";
 import { defineCommand } from "../registry/index.js";
 /** The endings the board cannot see: a resignation, a draw agreed on an offer (D-65). Checkmate, stalemate and the draws by rule end the game by themselves (D-37). */
 export const endGame = defineCommand({
@@ -35,7 +35,7 @@ export const endGame = defineCommand({
             ? { ...current, game }
             : { ...current, game, clock: { ...current.clock, left: timeLeft(current.clock, current.game.position.turn, now), since: now.toISOString() } };
         saveGame(folder, ended);
-        const { archive, warning } = archiveEnded(folder, ended);
+        const { archive, warning } = archiveEnded(folder, ended, openingTags(ended.game.record));
         const summary = withAnalyst(summaryOf(ended, now, archive), context);
         return warning === undefined ? { game: summary } : { game: summary, warning };
     },

package/dist/commands/game/export.d.ts

@@ -6,9 +6,9 @@ interface Exported {
 /** The game as PGN or its position as FEN, for the player to copy or keep: the plans stay hidden while it goes on (D-29); the moves alone for another site. */
 export declare const exportGame: import("../registry/registry.ts").Command<z.ZodObject<{
     format: z.ZodEnum<{
-        fen: "fen";
         moves: "moves";
         pgn: "pgn";
+        fen: "fen";
     }>;
 }, z.core.$strip>, Exported>;
 export {};

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

@@ -5,7 +5,7 @@ export { endGame } from "./end.ts";
 export { exportGame } from "./export.ts";
 export { look } from "./look.ts";
 export { ChatNotClear, newGame, startNewGame } from "./new.ts";
-export { playerMove } from "./player-move.ts";
+export { type MoveSentAlone, playerMove, playMoveSentAlone } from "./player-move.ts";
 export { ponder } from "./ponder.ts";
 export { position } from "./position.ts";
 export { status } from "./status.ts";

package/dist/commands/game/index.js

@@ -7,7 +7,7 @@ export { endGame } from "./end.js";
 export { exportGame } from "./export.js";
 export { look } from "./look.js";
 export { ChatNotClear, newGame, startNewGame } from "./new.js";
-export { playerMove } from "./player-move.js";
+export { playerMove, playMoveSentAlone } from "./player-move.js";
 export { ponder } from "./ponder.js";
 export { position } from "./position.js";
 export { status } from "./status.js";

package/dist/commands/game/new.js

@@ -1,8 +1,11 @@
+import { existsSync, rmSync } from "node:fs";
+import { join } from "node:path";
 import { z } from "zod";
 import { aiLevels, Game, levelTag, pgnDate, readPgn, startClock, timeControlOf, timeControlTag, withoutMoods } from "../../core/index.js";
-import { archivedName, archiveGame, cleanSince, endAnalysis, endOf, endTableTalk, lastChatStart, loadGame, saveGame, startOfNewGame, withoutPlans } from "../../games/index.js";
+import { archivedName, archiveGame, archiveName, cleanSince, endAnalysis, endOf, endTableTalk, lastChatStart, loadGame, saveGame, startOfNewGame, withoutPlans } from "../../games/index.js";
+import { hasDoorbell } from "../../host-files/index.js";
 import { gameFolder, gameFolders } from "../../profiles/index.js";
-import { coachRuns, gameAt, nextStep, positionLines, refuseUnseenPosition, sidesLine, speechLine, speechOf, summaryOf, withThought } from "../answers/index.js";
+import { coachRuns, gameAt, nextStep, openingTags, positionLines, refuseUnseenPosition, sidesLine, speechLine, speechOf, summaryOf, withThought } from "../answers/index.js";
 import { pastGameLines, playerLine } from "../profiles/index.js";
 import { defineCommand } from "../registry/index.js";
 import { levelText, levelToPlay } from "./levels.js";
@@ -37,7 +40,7 @@ export const newGame = defineCommand({
         }
         return startNewGame(input, context, "chat");
     },
-    format: (result) => "window" in result ? askedLine(result) : startedLines(result),
+    format: (result, context) => "window" in result ? askedLine(result, hasDoorbell(context?.host?.())) : startedLines(result, hasDoorbell(context?.host?.())),
 });
 /**
  * Starts the new game with the player's choices: those the AI asked in the chat, or the page's window gave (D-76). Only the chat's is refused on a game
@@ -71,8 +74,7 @@ export function startNewGame({ ai_colour: colour, from, clock, level: chosen, re
     const current = control === undefined
         ? { game, ai, started: started.toISOString(), talk: [] }
         : { game, ai, started: started.toISOString(), talk: [], clock: startClock(control, now, context.pageOpen?.() === true) };
-    const archived = before === undefined || (going === undefined && archivedName(folder, before) !== undefined) ? undefined : archiveBefore(folder, before);
-    saveGame(folder, current);
+    const archived = replaceGame(folder, current, before, going !== undefined);
     endAnalysis(folder);
     endTableTalk(folder);
     const past = pastGameLines(folder, remembered);
@@ -92,7 +94,7 @@ export function startNewGame({ ai_colour: colour, from, clock, level: chosen, re
     };
 }
 /** The new game's lines for the AI. */
-function startedLines({ game, archived, past, player, speech, closedPage: closed }) {
+function startedLines({ game, archived, past, player, speech, closedPage: closed }, doorbell) {
     return [
         `New game: ${sidesLine(game.ai)}, ${levelText(game.level)}.`,
         ...(player === undefined ? [] : [player]),
@@ -101,7 +103,7 @@ function startedLines({ game, archived, past, player, speech, closedPage: closed
         ...(past.length === 0 ? [] : ["Last games with this player (past_games gives more, and their moves):", ...past]),
         ...positionLines(game),
         ...(closed === undefined ? [] : [pageLine(closed, true)]),
-        nextStep(game),
+        nextStep(game, [], false, doorbell),
     ].join("\n");
 }
 /**
@@ -131,11 +133,16 @@ function justBegun(context) {
     const current = gameAt(gameFolder(context.home()), context.now());
     return current !== undefined && endOf(current.game) === undefined && current.game.record.moves.length === 0;
 }
-function askedLine({ window, page }) {
-    return window === "opened"
+function askedLine({ window, page }, doorbell) {
+    // A host with no doorbell hears of the game from the player, in its window.
+    const told = "End your turn, and call status when they tell you the game started.";
+    if (window !== "opened") {
+        return `Nobody has the board page open: give the player its address, ${page}, and tell them to start the game there with its New game button. ${doorbell ? "End your turn." : told}`;
+    }
+    return doorbell
         ? "The New game window is open on the board page: the player chooses the game there. Don't ask in the chat; end your turn, the doorbell wakes you when "
             + "the game starts."
-        : `Nobody has the board page open: give the player its address, ${page}, and tell them to start the game there with its New game button. End your turn.`;
+        : `The New game window is open on the board page: the player chooses the game there. Don't ask in the chat. ${told}`;
 }
 /** The refusal of a new game in a chat that still holds the game before (D-57): the board page says it in the player's language. */
 export class ChatNotClear extends Error {
@@ -164,9 +171,32 @@ function chatToClear(context) {
 }
 // The hosts whose SessionStart hook, written by init, notes how each chat starts: Claude Code and Codex, by the names they give the server.
 const hostsNotingChats = new Set(["claude-code", "codex-mcp-client"]);
+/**
+ * Writes the new game over the one before, archived first: both under game.json's lock, on the game before as read, so a game another process changed
+ * since is neither archived stale nor lost. When game.json cannot be written, an archive this call made goes: nothing changed.
+ */
+function replaceGame(folder, current, before, going) {
+    let archived;
+    let made = false;
+    try {
+        saveGame(folder, current, () => {
+            if (before !== undefined && (going || archivedName(folder, before) === undefined)) {
+                made = !existsSync(join(folder, archiveName(before)));
+                archived = archiveBefore(folder, before);
+            }
+        });
+    }
+    catch (error) {
+        if (made && archived !== undefined) {
+            rmSync(join(folder, archived), { force: true });
+        }
+        throw error;
+    }
+    return archived;
+}
 function archiveBefore(folder, before) {
     try {
-        return archiveGame(folder, before);
+        return archiveGame(folder, before, openingTags(before.game.record));
     }
     catch (error) {
         throw new Error(`${error.message} Nothing changed.`, { cause: error });

package/dist/commands/game/player-move.d.ts

@@ -1,10 +1,26 @@
 import { z } from "zod";
 import { type MovePlayed } from "../answers/index.ts";
+import { type Context, type SeenPosition } from "../registry/index.ts";
 /** The player's move, written in the chat and given by the AI: it answers with the position the AI decides on (D-34). */
 export declare const playerMove: import("../registry/registry.ts").Command<z.ZodObject<{
     move: z.ZodString;
     offer_draw: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, PlayerMove>;
+/**
+ * A move the player sent alone in the chat, played by Chesspal before the AI reads it: what the AI is told, the position it then sees, the stamp of
+ * game.json after it, and the keys of the player's words on the board page given with it, for the chat's server to count them as given.
+ */
+export interface MoveSentAlone {
+    answer: string;
+    position: SeenPosition;
+    stamp?: string;
+    given: string[];
+}
+/**
+ * Plays the move the player sent alone in the chat, before the AI reads it (D-36): at the moment they sent it, so with no allowance, and answered as
+ * player_move answers, with the player's words on the board page the AI has not answered. Refused as player_move refuses it: the AI reads the prompt then.
+ */
+export declare function playMoveSentAlone(move: string, context: Context): MoveSentAlone;
 /** The player's move, with the board page's address once a game while no browser has it open (D-85), and the coach to start when it ended the game (D-88). */
 interface PlayerMove extends MovePlayed {
     invite?: string;