chesspal 0.3.5 → 0.4.0

package/dist/commands/answers/clock.js

@@ -1,6 +1,7 @@
 // The clock in the commands (D-13): a flag that falls ends the game as soon as a command reads it, and the clock's line for the AI.
 import { canMate, clockText, Game, timeControlText, timeLeft } from "../../core/index.js";
 import { archiveEnded, endOf, loadGame, saveGame } from "../../games/index.js";
+import { openingTags } from "./opening-tags.js";
 import { colourName } from "./view.js";
 /** The current game of a folder `now`, or undefined: a game whose side to move has run out of time is over, saved and archived first. */
 export function gameAt(folder, now) {
@@ -15,7 +16,7 @@ export function gameAt(folder, now) {
     const ended = outOfTime(current, turn, now);
     saveGame(folder, ended);
     // An archive that cannot be written leaves the game in game.json, where status shows it, until a new game archives it.
-    archiveEnded(folder, ended);
+    archiveEnded(folder, ended, openingTags(ended.game.record));
     return ended;
 }
 /** The clock of a game `now`, as the AI reads it; none in a game without one. */

package/dist/commands/answers/drawings.js

@@ -12,10 +12,10 @@ export const noteInput = z.string().trim().min(1).max(noteLimit).regex(/^[^[\]{}
 const drawing = z.string().overwrite((text) => text.replace(/[\s-]+/g, ""));
 /** The arrows the AI draws, as their input reads them. */
 export const arrowsInput = z.array(drawing.regex(/^[GRYB][a-h][1-8][a-h][1-8]$/, "an arrow is a colour's letter and two squares: Gf6e4; a single square goes in squares")
-    .refine((arrow) => arrow.slice(1, 3) !== arrow.slice(3, 5), "an arrow goes from a square to another: a single square goes in squares")).max(drawLimit).optional()
+    .refine((arrow) => arrow.slice(1, 3) !== arrow.slice(3, 5), "an arrow goes from a square to another: a single square goes in squares")).max(drawLimit).optional().overwrite(noneIfEmpty)
     .describe("arrows on the board, as PGN's %cal writes them: Rf2e1. G green: the better move or the good idea; R red: a threat or the mistake; Y yellow: another way; B blue: a plan.");
 /** The squares the AI marks, as their input reads them. */
-export const squaresInput = z.array(drawing.regex(/^[GRYB][a-h][1-8]$/, "a square is a colour's letter and the square: Rf2")).max(drawLimit).optional()
+export const squaresInput = z.array(drawing.regex(/^[GRYB][a-h][1-8]$/, "a square is a colour's letter and the square: Rf2")).max(drawLimit).optional().overwrite(noneIfEmpty)
     .describe("squares to mark, as PGN's %csl writes them: Rf2; colours as for arrows");
 /** The arrows and squares drawn, those that read; none of either left out. */
 export function drawingsOf(arrows = [], squares = []) {
@@ -23,3 +23,7 @@ export function drawingsOf(arrows = [], squares = []) {
     const drawnSquares = squares.map(squareOf).filter((square) => square !== undefined);
     return { ...(drawnArrows.length === 0 ? {} : { arrows: drawnArrows }), ...(drawnSquares.length === 0 ? {} : { squares: drawnSquares }) };
 }
+// An empty list draws nothing, as one left out: a host may send every parameter of the schema (Priya).
+function noneIfEmpty(list) {
+    return list?.length === 0 ? undefined : list;
+}

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

@@ -1,12 +1,13 @@
-export { agentRuns, agentsLine, analystLine, analystOf, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.ts";
+export { agentRuns, agentsLine, analystLine, analystOf, analystOnView, analystQuietAt, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.ts";
 export { clockLine, clockSummaryOf, gameAt } from "./clock.ts";
 export { arrowsInput, drawingsOf, noteInput, squaresInput } from "./drawings.ts";
 export { aheadWords, leadFrom, leadInput } from "./lead-input.ts";
 export { closingLines, headLines, lastMoveText, moveLines, newGameStep, nextStep, positionLines, shownMove, shownMoves, sidesLine, wordLines } from "./lines.ts";
-export { bookOpening, bookPlies, bookReaches, knownMoves, openingLine, openingName } from "./opening-book.ts";
+export { bookOpening, bookPlace, bookPlies, knownMoves, openingLine, openingName } from "./opening-book.ts";
+export { openingTags } from "./opening-tags.ts";
 export { playMove, PositionChanged, positionIn, refuseOtherGame, refuseUnseenPosition, samePosition } from "./play-move.ts";
 export { give, newWords, say, unansweredWords, waitingWords, type Written } from "./say.ts";
 export { type Speech, speechLine, speechOf } from "./speech.ts";
 export { gameShown, gameToStudy, knownTag, moveIndex, moveNumbers, namedGame, noGameGoingOn, positionAfter, positionLine, shownPosition, type Studied, studyInput } from "./study.ts";
-export { gameGoingOn, type GameSummary, lastMoves, type MovePlayed, summaryOf, withThought } from "./summary.ts";
+export { endText, gameGoingOn, type GameSummary, lastMoves, type MovePlayed, summaryOf, withThought } from "./summary.ts";
 export { balanceText, boardView, colourName, compactView, fullView, materialText, riskLine, tacticsText } from "./view.ts";

package/dist/commands/answers/index.js

@@ -1,14 +1,15 @@
 // What the commands share to answer the AI: the lines it reads, the game's summary and view, the clock, the talk, the moves played, the games to study.
 // Above the registry only, below every other command folder.
-export { agentRuns, agentsLine, analystLine, analystOf, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.js";
+export { agentRuns, agentsLine, analystLine, analystOf, analystOnView, analystQuietAt, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.js";
 export { clockLine, clockSummaryOf, gameAt } from "./clock.js";
 export { arrowsInput, drawingsOf, noteInput, squaresInput } from "./drawings.js";
 export { aheadWords, leadFrom, leadInput } from "./lead-input.js";
 export { closingLines, headLines, lastMoveText, moveLines, newGameStep, nextStep, positionLines, shownMove, shownMoves, sidesLine, wordLines } from "./lines.js";
-export { bookOpening, bookPlies, bookReaches, knownMoves, openingLine, openingName } from "./opening-book.js";
+export { bookOpening, bookPlace, bookPlies, knownMoves, openingLine, openingName } from "./opening-book.js";
+export { openingTags } from "./opening-tags.js";
 export { playMove, PositionChanged, positionIn, refuseOtherGame, refuseUnseenPosition, samePosition } from "./play-move.js";
 export { give, newWords, say, unansweredWords, waitingWords } from "./say.js";
 export { speechLine, speechOf } from "./speech.js";
 export { gameShown, gameToStudy, knownTag, moveIndex, moveNumbers, namedGame, noGameGoingOn, positionAfter, positionLine, shownPosition, studyInput } from "./study.js";
-export { gameGoingOn, lastMoves, summaryOf, withThought } from "./summary.js";
+export { endText, gameGoingOn, lastMoves, summaryOf, withThought } from "./summary.js";
 export { balanceText, boardView, colourName, compactView, fullView, materialText, riskLine, tacticsText } from "./view.js";

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

@@ -17,7 +17,7 @@ export declare function shownMoves(moves: string): string;
 /** The lines after a move, which the line before named: its note, where the game stands, a warning. closingLines end them. */
 export declare function moveLines({ note, game, warning }: MovePlayed): string[];
 /** The last lines of a tool's answer: the player's words from the board page, then the next step, which stays the last line. */
-export declare function closingLines(game: GameSummary | undefined, words?: readonly Written[], pageClosed?: boolean): string[];
+export declare function closingLines(game: GameSummary | undefined, words?: readonly Written[], pageClosed?: boolean, doorbell?: boolean): string[];
 /**
  * The player's words from the board page, one line each, in analysis with the move the page showed (D-101): lines they broke are joined, so no line of
  * theirs reads as one of Chesspal's.
@@ -25,9 +25,11 @@ export declare function closingLines(game: GameSummary | undefined, words?: read
 export declare function wordLines(words: readonly Written[]): string[];
 /**
  * What the AI does next: the one line every host reads, even where the server's instructions are not shown. Words of the player's ask for an answer. With the
- * board page open in no browser, a new game starts there, never in the chat.
+ * board page open in no browser, a new game starts there, never in the chat. In a host with no `doorbell`, the player tells the chat what they did on the page.
  */
-export declare function nextStep(game: GameSummary | undefined, words?: readonly Written[], pageClosed?: boolean): string;
+export declare function nextStep(game: GameSummary | undefined, words?: readonly Written[], pageClosed?: boolean, doorbell?: boolean): string;
+/** What the AI does with the player's move in a host with no doorbell: one played on the board page they tell it of, one written in the chat it plays. */
+export declare const toldMove = "when they tell you they moved on the board page, call status; when they write it here, call player_move with it.";
 /** How a new game starts: the player chooses it in the board page's window, which new_game without choices opens (D-85). */
 export declare const newGameStep = "call new_game without choices: it opens the board page's New game window, where the player chooses the colour, the clock and the level.";
 /** Who plays what, from the AI's side. */

package/dist/commands/answers/lines.js

@@ -72,8 +72,8 @@ export function moveLines({ note, game, warning }) {
     return [...(note === undefined ? [] : [`Note: ${note}`]), ...positionLines(game, false), ...(warning === undefined ? [] : [warning])];
 }
 /** The last lines of a tool's answer: the player's words from the board page, then the next step, which stays the last line. */
-export function closingLines(game, words = [], pageClosed = false) {
-    return [...wordLines(words), nextStep(game, words, pageClosed)];
+export function closingLines(game, words = [], pageClosed = false, doorbell = true) {
+    return [...wordLines(words), nextStep(game, words, pageClosed, doorbell)];
 }
 /**
  * The player's words from the board page, one line each, in analysis with the move the page showed (D-101): lines they broke are joined, so no line of
@@ -84,9 +84,9 @@ export function wordLines(words) {
 }
 /**
  * What the AI does next: the one line every host reads, even where the server's instructions are not shown. Words of the player's ask for an answer. With the
- * board page open in no browser, a new game starts there, never in the chat.
+ * board page open in no browser, a new game starts there, never in the chat. In a host with no `doorbell`, the player tells the chat what they did on the page.
  */
-export function nextStep(game, words = [], pageClosed = false) {
+export function nextStep(game, words = [], pageClosed = false, doorbell = true) {
     const step = pageClosed ? closedPageGameStep : newGameStep;
     // Words written on a game in analysis: the chat answers them there, and corrects the review where they show it wrong (D-101).
     if (words.some((word) => word.place !== undefined) && (game === undefined || game.end !== undefined)) {
@@ -104,7 +104,7 @@ export function nextStep(game, words = [], pageClosed = false) {
     }
     if (game.end !== undefined) {
         const analysis = game.end.analyst === "offer"
-            ? ` To go over it, on their yes, ${analystLine(game.end.archive)}`
+            ? ` To go over it, on their yes, ${analystLine(game.end.archive, game.end.codex === true)}`
             : game.end.analyst === "done"
                 ? ` ${reviewedLine(game.end.archive)}`
                 : "";
@@ -114,7 +114,9 @@ export function nextStep(game, words = [], pageClosed = false) {
             : `Next: answer the player with ai_say.${analysis} When they want another game, ${step}`;
     }
     if (game.turn === game.ai && game.clock?.waiting === true) {
-        return "Next: don't move yet: the player starts the game with Start on the board page, and the doorbell wakes you then. End your turn.";
+        return doorbell
+            ? "Next: don't move yet: the player starts the game with Start on the board page, and the doorbell wakes you then. End your turn."
+            : "Next: don't move yet: the player starts the game with Start on the board page. End your turn, and call status when they tell you they did.";
     }
     if (game.turn === game.ai) {
         return words.length === 0
@@ -124,8 +126,13 @@ export function nextStep(game, words = [], pageClosed = false) {
     if (game.drawOffer === "player") {
         return "Next: accept the draw with end_game draw_agreed, or answer with ai_say and wait for the player's move.";
     }
-    return words.length === 0 ? "Next: wait for the player's move, then call player_move with it." : "Next: answer the player with ai_say, then wait for their move.";
+    if (words.length > 0) {
+        return "Next: answer the player with ai_say, then wait for their move.";
+    }
+    return doorbell ? "Next: wait for the player's move, then call player_move with it." : `Next: wait for the player's move: ${toldMove}`;
 }
+/** What the AI does with the player's move in a host with no doorbell: one played on the board page they tell it of, one written in the chat it plays. */
+export const toldMove = "when they tell you they moved on the board page, call status; when they write it here, call player_move with it.";
 /** How a new game starts: the player chooses it in the board page's window, which new_game without choices opens (D-85). */
 export const newGameStep = "call new_game without choices: it opens the board page's New game window, where the player chooses the colour, the clock and the level.";
 // With the page open in no browser the window cannot open: the player opens the page and presses New game.
@@ -163,8 +170,9 @@ function clockLines(game) {
 }
 function whereLine(game) {
     if (game.end !== undefined) {
-        const archived = game.end.archive === undefined ? "" : ` Archived in ${game.end.archive}.`;
-        return `Game over: ${endText(game.end)}.${archived}`;
+        // Saved where the player's games are: the AI says so, never the file, which past_games names when it is needed.
+        const archived = game.end.archive === undefined ? "" : " Saved with the player's games.";
+        return `Game over: ${endText(game.end, game.ai)}.${archived}`;
     }
     return `${game.turn === game.ai ? "You" : "Player"} (${colourName(game.turn)}) to move, move ${game.moveNumber}.`;
 }

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

@@ -1,13 +1,19 @@
-import { type GameRecord, type Opening } from "../../core/index.ts";
-/** 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 declare function openingLine(record: GameRecord): string | undefined;
+import { type BookPlace, Game, type GameRecord, type Opening } from "../../core/index.ts";
+/**
+ * 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 declare function openingLine(game: Game | GameRecord): string | undefined;
 /** 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 declare function knownMoves(fen: string): readonly string[];
-/** How many plies from the start the book knows, to the last before the game left it (D-69); none from another position. */
-export declare function bookPlies(record: GameRecord): number;
-/** 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 declare function bookReaches(fen: string): boolean;
+/** 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 declare function bookPlies(game: Game | GameRecord): number;
 /** The opening a game reached, ECO and name, without where it left the book: for the games in the archive. */
 export declare function openingName(record: GameRecord): string | undefined;
 /** The last named opening a game reached, and at which ply; none outside the book, or where the build made no index. */
 export declare function bookOpening(record: GameRecord): Opening | 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 declare function bookPlace(game: Game | GameRecord): BookPlace | undefined;

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

@@ -38,13 +38,14 @@ export interface GameSummary {
     mood?: MoodNow;
     /**
      * When the game is over: how it ended, its name in the archive once it is there, and, where an analyst agent runs (D-89), whether the chat offers it or
-     * goes over the review it did.
+     * goes over the review it did, and whether the host is Codex, which starts it with spawn_agent.
      */
     end?: {
         result: string;
         termination?: string;
         archive?: string;
         analyst?: "offer" | "done";
+        codex?: true;
     };
 }
 /** A move numbered as in the game (4.Ng5, 4...d5), with the squares it went from and to. */
@@ -76,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/answers/view.d.ts

@@ -22,5 +22,5 @@ export declare function riskLine(facts: Facts): string | undefined;
 export declare function colourName(side: Side): string;
 /** The material as the player sees it beside the board (D-59): who is ahead and by how much, and the pieces each side took. */
 export declare function materialText(material: Material): string;
-/** Who is ahead in material, and by how many pawns: White +2, or even. */
+/** Who is ahead in material, and by how many pawns, with the unit, so that no AI reads it as pieces: White +2 in pawns, or even. */
 export declare function balanceText(balance: number): string;

package/dist/commands/answers/view.js

@@ -51,9 +51,9 @@ export function materialText(material) {
     }
     return `${ahead} (White took ${takenText(material.taken.white)}, Black took ${takenText(material.taken.black)})`;
 }
-/** Who is ahead in material, and by how many pawns: White +2, or even. */
+/** Who is ahead in material, and by how many pawns, with the unit, so that no AI reads it as pieces: White +2 in pawns, or even. */
 export function balanceText(balance) {
-    return balance === 0 ? "even" : `${balance > 0 ? "White" : "Black"} +${Math.abs(balance)}`;
+    return balance === 0 ? "even" : `${balance > 0 ? "White" : "Black"} +${Math.abs(balance)} in pawns`;
 }
 /** The pieces taken, counted by kind: Q 2R 7P. */
 function takenText(taken) {

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 };
     },