chesspal 0.1.0 → 0.2.0

package/dist/commands/game-summary.d.ts

@@ -1,4 +1,4 @@
-import { type AiLevel, type Facts, type MoodNow, type Side, type Square } from "../core/index.ts";
+import { type AiLevel, type Facts, type GameRecord, type MoodNow, type Side, type Square } from "../core/index.ts";
 import { type CurrentGame, type Speaker, type Thought } from "../games/index.ts";
 import { type ClockSummary } from "./clock.ts";
 /** The current game, as the commands give it. */
@@ -23,19 +23,23 @@ export interface GameSummary {
     plan?: string;
     /** When the AI is to move: what it thought of the player's move on their time (D-72). */
     thought?: Thought;
-    /** When the AI is to move: the helps on, so it may teach (D-78), or turned off since it judged or drew on a move. */
-    helps?: "on" | "off now";
+    /** When the AI is to move: the helps on, so it may teach (D-78), with a coach that judges the player's moves (D-88), or turned off since it drew on a move. */
+    helps?: "on" | "coached" | "off now";
     /** In a game with a time control: the time each side had left when the command ran (D-13). */
     clock?: ClockSummary;
     /** Who offered a draw, while the offer stands (D-65). */
     drawOffer?: Speaker;
     /** The AI's mood while it lasts, in a game going on (D-70). */
     mood?: MoodNow;
-    /** When the game is over: how it ended, and its name in the archive once it is there. */
+    /**
+     * 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.
+     */
     end?: {
         result: string;
         termination?: string;
         archive?: string;
+        analyst?: "offer" | "done";
     };
 }
 /** A move numbered as in the game (4.Ng5, 4...d5), with the squares it went from and to. */
@@ -53,43 +57,22 @@ export interface MovePlayed {
     game: GameSummary;
     /** What went wrong after the move was saved, such as the archive not written. */
     warning?: string;
-    /** What the player wrote on the board page that the AI has not been given yet (T-65). */
+    /** What the player wrote on the board page that the AI has not been given yet. */
     words?: string[];
 }
 /** The game as the commands tell it; a game over with the name it has in the archive, when it is there. */
 export declare function summaryOf(current: CurrentGame, now: Date, archive?: string): GameSummary;
-/** The summary with what the AI reads when it is to move: what it thought of the player's last move on their time (D-72), and whether the helps are on (D-78). */
-export declare function withThought(summary: GameSummary, folder: string, current: CurrentGame): GameSummary;
-/** The current game `now`, refused when there is none or when it is over, on time too. */
-export declare function gameGoingOn(folder: string, now: Date): CurrentGame;
-/** Where the game stands: the AI's position to decide on, with its last move unless the lines before named it; the player's turn; or how it ended. */
-export declare function positionLines(game: GameSummary, withLastMove?: boolean): string[];
-/** The head of a view: where the game stands, the last move unless the lines before named it, the opening, the material as the player sees it, and the FEN. */
-export declare function headLines(game: GameSummary, withLastMove?: boolean): string[];
-/** The last move, as the player is shown it, with its squares: 4.♞g5 (f3-g5). */
-export declare function lastMoveText({ move, from, to }: LastMove): string;
 /**
- * A numbered move as the player is shown it, with the pieces' figurines (D-86): the form alone, without the SAN, which the AI copied into its message
- * (Priya, test of D-86): 4.Ng5 is 4.♞g5.
+ * The summary with what the AI reads when it is to move: what it thought of the player's last move on their time (D-72), and whether the helps are on (D-78),
+ * with a coach when `coached`.
  */
-export declare function shownMove(move: string): string;
-/** The player's language by its English name when it is not English. */
-export interface Speech {
-    language: string;
-}
-/** The player's speech, from the page's settings or the system's language; undefined in English, which the AI speaks unless told. */
-export declare function speechOf(folder: string, systemLanguage: string | undefined): Speech | undefined;
-/** What the AI is told of the player's speech once a chat (Priya, retest of T-54); the moves are SAN in every language (D-87). */
-export declare function speechLine({ language }: Speech): 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 string[]): string[];
-/** The player's words from the board page, one line each: lines they broke are joined, so no line of theirs reads as one of Chesspal's. */
-export declare function wordLines(words: readonly string[]): 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. */
-export declare function nextStep(game: GameSummary | undefined, words?: readonly string[]): string;
-/** How a new game starts: the player chooses it in the board page's window, which new_game without choices opens; in the chat only where there is no page (D-85). */
-export declare const newGameStep: string;
-/** Who plays what, from the AI's side. */
-export declare function sidesLine(ai: Side): string;
+export declare function withThought(summary: GameSummary, folder: string, current: CurrentGame, coached: boolean): GameSummary;
+/** The current game `now`, refused when there is none or when it is over, on time too. */
+export declare function gameGoingOn(folder: string, now: Date): CurrentGame;
+/** How a game ended, in words: its result, and how it came when known. */
+export declare function endText({ result, termination }: {
+    result: string;
+    termination?: 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/game-summary.js

@@ -1,11 +1,9 @@
-// What the chess commands tell about the current game: plain data for the command line's JSON, and the lines an AI reads.
-import { figurinesOf, levelOf, materialOf, moodAt, sees } from "../core/index.js";
-import { currentPlan, drawOfferOf, endOf, talkLimits, thoughtForLastMove } from "../games/index.js";
-import { onQuickModel } from "../host-files/index.js";
-import { helpsIn, languageIn } from "../profiles/index.js";
-import { clockLine, clockSummaryOf, gameAt } from "./clock.js";
+// The current game as the commands give it: plain data for the command line's JSON, from which answer-lines.ts writes the lines an AI reads.
+import { levelOf, moodAt, sees } from "../core/index.js";
+import { currentPlan, drawOfferOf, endOf, thoughtForLastMove } from "../games/index.js";
+import { helpsIn } from "../profiles/index.js";
+import { clockSummaryOf, gameAt } from "./clock.js";
 import { knownMoves, openingLine } from "./opening-book.js";
-import { boardView, colourName, compactView, materialText } from "./view.js";
 /** The game as the commands tell it; a game over with the name it has in the archive, when it is there. */
 export function summaryOf(current, now, archive) {
     const { game, ai } = current;
@@ -40,13 +38,16 @@ export function summaryOf(current, now, archive) {
     }
     return summary;
 }
-/** The summary with what the AI reads when it is to move: what it thought of the player's last move on their time (D-72), and whether the helps are on (D-78). */
-export function withThought(summary, folder, current) {
+/**
+ * The summary with what the AI reads when it is to move: what it thought of the player's last move on their time (D-72), and whether the helps are on (D-78),
+ * with a coach when `coached`.
+ */
+export function withThought(summary, folder, current, coached) {
     if (summary.turn !== summary.ai || summary.end !== undefined) {
         return summary;
     }
     const thought = thoughtForLastMove(folder, current);
-    const helps = helpsIn(folder) ? "on" : judgedBefore(current) ? "off now" : undefined;
+    const helps = helpsIn(folder) ? (coached ? "coached" : "on") : judgedBefore(current) ? "off now" : undefined;
     return { ...summary, ...(thought === undefined ? {} : { thought }), ...(helps === undefined ? {} : { helps }) };
 }
 /** The current game `now`, refused when there is none or when it is over, on time too. */
@@ -61,159 +62,12 @@ export function gameGoingOn(folder, now) {
     }
     return current;
 }
-/** Where the game stands: the AI's position to decide on, with its last move unless the lines before named it; the player's turn; or how it ended. */
-export function positionLines(game, withLastMove = true) {
-    if (game.end !== undefined || game.turn !== game.ai) {
-        return [whereLine(game), ...offerLines(game), ...clockLines(game), ...moodLines(game)];
-    }
-    return [
-        ...headLines(game, withLastMove),
-        ...(game.facts === undefined ? [] : (sees(game.level, "tactics") ? compactView : boardView)(game.facts, game.turn)),
-        ...(game.book === undefined ? [] : [`Book moves, most named lines first: ${game.book.join(", ")}`]),
-        ...(game.plan === undefined ? [] : [`Plan: ${game.plan}`]),
-        ...(game.thought === undefined ? [] : [thoughtLine(game.thought, game.level)]),
-        ...moodLines(game),
-        ...(game.helps === "on" ? [helpsLine] : game.helps === "off now" ? [helpsOffLine] : []),
-    ];
-}
-/** The helps turned on: the AI may teach as the analyst does (D-62, D-78), never playing for the player. */
-const helpsLine = "Helps on: the player wants to learn. Tell your intentions, never their best move; after their move judge it when it stands out (ai_move's badge "
-    + `and note), draw arrows and squares to show what you say, and write up to ${talkLimits.aiHelps} characters.`;
-/** The helps turned off during a game: what the AI said and drew before no longer holds (Priya, round of D-78). */
-const helpsOffLine = `Helps off now: play as at a tournament again: no intentions, badges or arrows, comments of ${talkLimits.ai} characters at most.`;
-/** Whether the AI judged or drew on a move of this game, which only the helps allow: a sign they were on. */
-function judgedBefore(current) {
-    return current.game.record.moves.some((move) => /\[%(badge|review|cal|csl) /.test(move.comment ?? ""));
-}
-/** The head of a view: where the game stands, the last move unless the lines before named it, the opening, the material as the player sees it, and the FEN. */
-export function headLines(game, withLastMove = true) {
-    return [
-        whereLine(game),
-        ...offerLines(game),
-        ...(withLastMove && game.lastMove !== undefined ? [`Last move: ${lastMoveText(game.lastMove)}.`] : []),
-        ...(game.opening === undefined ? [] : [`Opening: ${game.opening}`]),
-        `Material: ${materialText(materialOf(game.fen))}`,
-        ...clockLines(game),
-        `FEN: ${game.fen}`,
-    ];
-}
-/** The last move, as the player is shown it, with its squares: 4.♞g5 (f3-g5). */
-export function lastMoveText({ move, from, to }) {
-    return `${shownMove(move)} (${from}-${to})`;
-}
-/**
- * A numbered move as the player is shown it, with the pieces' figurines (D-86): the form alone, without the SAN, which the AI copied into its message
- * (Priya, test of D-86): 4.Ng5 is 4.♞g5.
- */
-export function shownMove(move) {
-    const [, number = "", san = move] = /^(\d+\.+)(.+)$/.exec(move) ?? [];
-    return `${number}${figurinesOf(san)}`;
-}
-/** The player's speech, from the page's settings or the system's language; undefined in English, which the AI speaks unless told. */
-export function speechOf(folder, systemLanguage) {
-    const language = languageName(languageIn(folder, systemLanguage));
-    return language === undefined ? undefined : { language };
-}
-/** What the AI is told of the player's speech once a chat (Priya, retest of T-54); the moves are SAN in every language (D-87). */
-export function speechLine({ language }) {
-    return `The player speaks ${language}.`;
-}
-/** The lines after a move, which the line before named: its note, where the game stands, a warning. closingLines end them. */
-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 = []) {
-    return [...wordLines(words), nextStep(game, words)];
-}
-/** The player's words from the board page, one line each: lines they broke are joined, so no line of theirs reads as one of Chesspal's. */
-export function wordLines(words) {
-    return words.map((text) => `Player wrote on the board page: «${text.replace(/\s+/g, " ")}»`);
-}
-/** 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. */
-export function nextStep(game, words = []) {
-    if (game === undefined) {
-        return words.length === 0 ? `Next: when the player wants a game, ${newGameStep}` : `Next: answer the player with ai_say. When they want a game, ${newGameStep}`;
-    }
-    if (game.end !== undefined) {
-        return words.length === 0
-            ? "Next: tell the player how the game ended, with ai_say and how you feel as its mood if they play on the board page; then offer them, in words, another game or "
-                + "to go over this one "
-                + `(analyse_game). For another, ${newGameStep}`
-            : `Next: answer the player with ai_say. When they want another game, ${newGameStep}`;
-    }
-    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.";
-    }
-    if (game.turn === game.ai) {
-        return words.length === 0
-            ? "Next: choose your move, then call ai_move with it, your plan and any comment."
-            : "Next: choose your move, then call ai_move with it, your plan and a comment that answers the player.";
-    }
-    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.";
-}
-/** How a new game starts: the player chooses it in the board page's window, which new_game without choices opens; in the chat only where there is no page (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; where there is no board page, it tells you to ask them in the chat.";
-/** Who plays what, from the AI's side. */
-export function sidesLine(ai) {
-    return `you play ${colourName(ai)}, the player ${colourName(ai === "white" ? "black" : "white")}`;
-}
-/** What the AI gets when it is to move: the facts its level sees (D-60), and its plan. */
-function addAiFacts(summary, { game }) {
-    const plan = currentPlan(game.record);
-    summary.facts = game.facts;
-    if (sees(summary.level, "theory")) {
-        const book = knownMoves(summary.fen);
-        if (book.length > 0) {
-            summary.book = book;
-        }
-    }
-    if (plan !== undefined) {
-        summary.plan = plan;
-    }
-}
-/** The draw offer that stands, and how to answer it or what becomes of it (D-65). */
-function offerLines({ drawOffer, turn, ai }) {
-    if (drawOffer === "ai") {
-        return ["Your draw offer stands until the player moves; if they accept it in the chat, end_game draw_agreed ends the game."];
-    }
-    if (drawOffer === "player") {
-        return [turn === ai ? "The player offers a draw: end_game draw_agreed accepts it; your move declines it." : "The player offers a draw before their move; your next move declines it."];
-    }
-    return [];
-}
-/** What the AI thought on the player's time, saying by which model and that Chesspal checked only that it is legal: the facts do not cover every blunder (Anatolij, round of T-109). */
-function thoughtLine({ move, why }, level) {
-    return `Thought on their time ${onQuickModel(level) ? "by a quicker model" : "by your model"} (legal, not checked): ${move}, ${why}`;
-}
-/** The AI's mood while it lasts, and how long its face shows it (D-70). */
-function moodLines({ mood }) {
-    if (mood === undefined) {
-        return [];
-    }
-    const shown = mood.left === 0 ? "until your next move" : `for ${mood.left} more of your moves`;
-    return [`Your mood: ${mood.mood}, on your face ${shown}, then neutral by itself.`];
-}
-/** Who is to move, or how the game ended. */
-function clockLines(game) {
-    return game.clock === undefined ? [] : [clockLine(game.clock, game.ai)];
-}
-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}`;
-    }
-    return `${game.turn === game.ai ? "You" : "Player"} (${colourName(game.turn)}) to move, move ${game.moveNumber}.`;
-}
-function endText({ result, termination }) {
+/** 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}`;
 }
 /** The last plies of a record, numbered as a player writes them, from the move number and side of its FEN. */
-function lastMoves(record, count) {
+export function lastMoves(record, count) {
     const [, turn, , , , number] = (record.tags.FEN ?? "").split(" ");
     const startNumber = Number(number) || 1;
     // The ply count from white's move of the first move number: 1 when black moves first.
@@ -228,12 +82,21 @@ function lastMoves(record, count) {
         return index === 0 ? `${moveNumber}...${move.san}` : move.san;
     }).join(" ");
 }
-/** A language by its English name when it is not English (Italian), from the way the system or the page names it (it-IT, it). */
-function languageName(language) {
-    const code = language?.split(/[-_]/)[0]?.toLowerCase() ?? "";
-    if (!/^[a-z]{2,3}$/.test(code) || code === "en" || code === "und") {
-        return undefined;
+/** Whether the AI judged or drew on a move of this game, which only the helps allow: a sign they were on. */
+function judgedBefore(current) {
+    return current.game.record.moves.some((move) => /\[%(badge|review|cal|csl) /.test(move.comment ?? ""));
+}
+/** What the AI gets when it is to move: the facts its level sees (D-60), and its plan. */
+function addAiFacts(summary, { game }) {
+    const plan = currentPlan(game.record);
+    summary.facts = game.facts;
+    if (sees(summary.level, "theory")) {
+        const book = knownMoves(summary.fen);
+        if (book.length > 0) {
+            summary.book = book;
+        }
+    }
+    if (plan !== undefined) {
+        summary.plan = plan;
     }
-    const name = new Intl.DisplayNames(["en"], { type: "language" }).of(code);
-    return name === undefined || name === code ? undefined : name;
 }

package/dist/commands/index.d.ts

@@ -1,3 +1,18 @@
 import type { AnyCommand } from "./registry.ts";
+export { aiMove } from "./ai-move.ts";
+export { analyseGame } from "./analyse-game.ts";
+export { gameAt } from "./clock.ts";
+export { type Caller, type Context, defaultContext, type SeenPosition } from "./context.ts";
+export { deleteGame } from "./delete-game.ts";
+export { deleteReview } from "./delete-review.ts";
+export { answerDraw, DrawRefused, offerDraw } from "./draw-offer.ts";
+export { endGame } from "./end-game.ts";
+export { ChatNotClear, newGame, startNewGame } from "./new-game.ts";
+export { bookOpening, bookPlies } from "./opening-book.ts";
+export { playMove, PositionChanged, positionIn, samePosition } from "./play-move.ts";
+export { chooseDrawnAvatar, GameGoingOn, newProfile, setAccounts, useProfile } from "./profiles.ts";
+export { type AnyCommand, baseType, type Command, commandLineFieldProblem, inputProblems, isBoolean, isList, takesNumbers } from "./registry.ts";
+export { say } from "./say.ts";
+export { gameToStudy, namedGame } from "./study.ts";
 /** Every command of Chesspal, in the order the command line lists them and the MCP server offers them. */
 export declare const commands: AnyCommand[];

package/dist/commands/index.js

@@ -1,7 +1,11 @@
+// The commands: the only way the AI, the command line and the page change a game (D-5, D-27), each defined once in the file named as its tool.
 import { aiMove } from "./ai-move.js";
 import { aiSay } from "./ai-say.js";
 import { analyseGame } from "./analyse-game.js";
 import { annotateGame } from "./annotate-game.js";
+import { coach } from "./coach.js";
+import { deleteGame } from "./delete-game.js";
+import { deleteReview } from "./delete-review.js";
 import { endGame } from "./end-game.js";
 import { exportGame } from "./export-game.js";
 import { init } from "./init.js";
@@ -12,8 +16,49 @@ import { playerMove } from "./player-move.js";
 import { playerSay } from "./player-say.js";
 import { ponder } from "./ponder.js";
 import { position } from "./position.js";
-import { newProfile, profiles, setAvatar, useProfile } from "./profiles.js";
+import { newProfile, profiles, setAccounts, setAvatar, useProfile } from "./profiles.js";
 import { status } from "./status.js";
 import { studyGames } from "./study-games.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 { aiMove } from "./ai-move.js";
+export { analyseGame } from "./analyse-game.js";
+export { gameAt } from "./clock.js";
+export { defaultContext } from "./context.js";
+export { deleteGame } from "./delete-game.js";
+export { deleteReview } from "./delete-review.js";
+export { answerDraw, DrawRefused, offerDraw } from "./draw-offer.js";
+export { endGame } from "./end-game.js";
+export { ChatNotClear, newGame, startNewGame } from "./new-game.js";
+export { bookOpening, bookPlies } from "./opening-book.js";
+export { playMove, PositionChanged, positionIn, samePosition } from "./play-move.js";
+export { chooseDrawnAvatar, GameGoingOn, newProfile, setAccounts, useProfile } from "./profiles.js";
+export { baseType, commandLineFieldProblem, inputProblems, isBoolean, isList, takesNumbers } from "./registry.js";
+export { say } from "./say.js";
+export { gameToStudy, namedGame } from "./study.js";
 /** Every command of Chesspal, in the order the command line lists them and the MCP server offers them. */
-export const commands = [init, status, newGame, playerMove, playerSay, aiMove, aiSay, ponder, look, position, endGame, exportGame, pastGames, analyseGame, annotateGame, studyGames, profiles, newProfile, useProfile, setAvatar];
+export const commands = [
+    init,
+    status,
+    newGame,
+    playerMove,
+    playerSay,
+    aiMove,
+    aiSay,
+    ponder,
+    coach,
+    look,
+    position,
+    endGame,
+    exportGame,
+    pastGames,
+    analyseGame,
+    annotateGame,
+    studyGames,
+    deleteReview,
+    deleteGame,
+    profiles,
+    newProfile,
+    useProfile,
+    setAvatar,
+    setAccounts,
+];

package/dist/commands/init.d.ts

@@ -1,11 +1,11 @@
 import { z } from "zod";
-/** The player's folder set up for the AI hosts (T-7): the folder, and the files written there. */
+/** The player's folder set up for the AI hosts: the folder, and the files written there. */
 interface FolderSetUp {
     folder: string;
     written: string[];
-    /** The folder as the player goes into it from where init ran, when it is not that one (T-127): chess. */
+    /** The folder as the player goes into it from where init ran, when it is not that one: chess. */
     enter?: string;
-    /** Codex's hooks changed in a folder that had them: Codex runs them only once allowed again in /hooks (T-125). */
+    /** Codex's hooks changed in a folder that had them: Codex runs them only once the player trusts them again. */
     hooksChanged?: true;
 }
 /** Makes a folder the player's chess table: the files through which Claude Code and Codex find Chesspal and the opponent's instructions (D-31). */

package/dist/commands/init.js

@@ -46,10 +46,10 @@ const english = {
     toPlay: "To play:",
     open: (enter) => enter === undefined ? ["Open Claude Code or Codex in this folder."] : [`Go into the folder: cd ${enter}`, "then open Claude Code (claude) or Codex (codex)."],
     steps: [
-        ["The first time, it asks whether to trust the folder: say yes.", "In Codex, also type /hooks and allow Chesspal's two hooks:", "small helpers that let it notice your moves on the board."],
+        ["The first time, it asks whether to trust the folder: say yes.", "Codex also asks about Chesspal's two hooks: choose Trust all.", "They are small helpers that let it notice your moves on the board."],
         ["Say hello: the AI gives you the link to the board."],
     ],
-    hooksChanged: "Chesspal's hooks for Codex have changed: in Codex, type /hooks and allow them again.",
+    hooksChanged: "Chesspal's hooks for Codex have changed: when Codex asks about them, choose Trust all again.",
     updated: (count) => `Updated ${count} ${count === 1 ? "file" : "files"}.`,
 };
 const italian = {
@@ -58,10 +58,10 @@ const italian = {
     toPlay: "Per giocare:",
     open: (enter) => enter === undefined ? ["Apri Claude Code o Codex in questa cartella."] : [`Entra nella cartella: cd ${enter}`, "poi apri Claude Code (claude) o Codex (codex)."],
     steps: [
-        ["La prima volta ti chiede se fidarti della cartella: rispondi sì.", "In Codex scrivi anche /hooks e consenti i due «hook» di Chesspal:", "piccoli aiuti che gli fanno vedere le tue mosse sulla scacchiera."],
+        ["La prima volta ti chiede se fidarti della cartella: rispondi sì.", "Codex chiede anche dei due «hook» di Chesspal: scegli Trust all.", "Sono piccoli aiuti che gli fanno vedere le tue mosse sulla scacchiera."],
         ["Saluta: l'AI ti dà il link della scacchiera."],
     ],
-    hooksChanged: "Gli «hook» di Chesspal per Codex sono cambiati: in Codex scrivi /hooks e consentili di nuovo.",
+    hooksChanged: "Gli «hook» di Chesspal per Codex sono cambiati: quando Codex te lo chiede, scegli di nuovo Trust all.",
     updated: (count) => count === 1 ? "Aggiornato 1 file." : `Aggiornati ${count} file.`,
 };
 function wordsFor(language) {

package/dist/commands/lead-input.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import { type Lead } from "../core/index.ts";
+/** A lead as its input reads it: pawns from White's side as a number, +1.5 or -3, or a mate it sees, "#3" White's or "#-3" Black's. */
+export declare const leadInput: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+/** Who is ahead in words, the side and by how much, so that the AI reads its own sign back (Anatolij). */
+export declare function aheadWords(lead: Lead): string;
+/** The lead an input gave, checked by leadInput. */
+export declare function leadFrom(value: number | string): Lead;

package/dist/commands/lead-input.js

@@ -0,0 +1,21 @@
+// Who is ahead as the AI gives it (D-90): the analyst after each move of a game over, the coach in the position the player is to move in.
+import { z } from "zod";
+import { readLead } from "../core/index.js";
+/** A lead as its input reads it: pawns from White's side as a number, +1.5 or -3, or a mate it sees, "#3" White's or "#-3" Black's. */
+export const leadInput = z.union([z.number(), z.string()]).refine((value) => readLead(String(value)) !== undefined, 'who is ahead is a number of pawns from White\'s side, 1.5 or -3, or a mate you see in moves of the side that mates, "#3" for White\'s or "#-3" for Black\'s, '
+    + "up to 99");
+/** Who is ahead in words, the side and by how much, so that the AI reads its own sign back (Anatolij). */
+export function aheadWords(lead) {
+    if ("mate" in lead) {
+        return `${lead.mate > 0 ? "White" : "Black"} mates in ${Math.abs(lead.mate)}`;
+    }
+    return lead.pawns === 0 ? "even" : `${lead.pawns > 0 ? "White" : "Black"} ahead by ${Math.abs(lead.pawns)}`;
+}
+/** The lead an input gave, checked by leadInput. */
+export function leadFrom(value) {
+    const lead = readLead(String(value));
+    if (lead === undefined) {
+        throw new Error(`${value} is not who is ahead: give a number of pawns from White's side, 1.5 or -3, or a mate you see, "#3" or "#-3". Nothing changed.`);
+    }
+    return lead;
+}

package/dist/commands/look.js

@@ -1,8 +1,10 @@
 import { z } from "zod";
 import { boardText, materialOf } from "../core/index.js";
+import { analystAgent } from "../host-files/index.js";
 import { gameFolder } from "../profiles/index.js";
+import { headLines, wordLines } from "./answer-lines.js";
 import { gameAt } from "./clock.js";
-import { headLines, summaryOf, wordLines } from "./game-summary.js";
+import { summaryOf } from "./game-summary.js";
 import { refuseUnseen } from "./levels.js";
 import { defineCommand } from "./registry.js";
 import { newWords } from "./say.js";
@@ -20,6 +22,7 @@ export const look = defineCommand({
     // Read only for the host: a flag that has fallen is written, as the time already decided.
     readOnly: true,
     idempotent: true,
+    sharedWith: [analystAgent],
     run: ({ only, game, move }, context) => {
         if (game !== undefined || move !== undefined) {
             return studyLook(context, only, game, move);

package/dist/commands/new-game.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import type { Context } from "./context.ts";
-import { type GameSummary, type Speech } from "./game-summary.ts";
+import { type GameSummary } from "./game-summary.ts";
+import { type Speech } from "./speech.ts";
 interface NewGame {
     game: GameSummary;
     /** Where the game before went: one going on, unfinished; one over, when its archive could not be written at its end. */
@@ -64,6 +65,4 @@ export declare function startNewGame({ ai_colour: colour, from, clock, level: ch
 export declare class ChatNotClear extends Error {
     constructor();
 }
-/** From how many plies a game played in a chat asks for a clean one before the next (D-57): one left after a few moves does not. */
-export declare const pliesBeforeClearing = 20;
 export {};

package/dist/commands/new-game.js

@@ -2,14 +2,17 @@ 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 { gameFolder, gameFolders } from "../profiles/index.js";
+import { coachRuns } from "./agents.js";
+import { nextStep, positionLines, sidesLine } from "./answer-lines.js";
 import { gameAt } from "./clock.js";
-import { nextStep, positionLines, sidesLine, speechLine, speechOf, summaryOf, withThought } from "./game-summary.js";
+import { summaryOf, withThought } from "./game-summary.js";
 import { levelText, levelToPlay } from "./levels.js";
 import { closedPage, pageGiven, pageLine } from "./page-link.js";
 import { pastGameLines } from "./past-games.js";
 import { refuseUnseenPosition } from "./play-move.js";
 import { playerLine } from "./profiles.js";
 import { defineCommand } from "./registry.js";
+import { speechLine, speechOf } from "./speech.js";
 const newGameInput = z.object({
     ai_colour: z.enum(["white", "black", "random"]).optional().describe("the colour you play: random draws it; left out with the rest, the page's window asks"),
     from: z.string().optional().describe("a FEN or a PGN to go on from, instead of the standard position"),
@@ -86,7 +89,7 @@ export function startNewGame({ ai_colour: colour, from, clock, level: chosen, re
         pageGiven(context, current.started);
     }
     return {
-        game: withThought(summaryOf(current, now), folder, current),
+        game: withThought(summaryOf(current, now), folder, current, coachRuns(context)),
         ...(archived === undefined ? {} : { archived: { name: archived, finished: going === undefined } }),
         past,
         ...(player === undefined ? {} : { player }),
@@ -140,12 +143,12 @@ export class ChatNotClear extends Error {
 /** How many of the last games new_game recalls. */
 const remembered = 3;
 /** From how many plies a game played in a chat asks for a clean one before the next (D-57): one left after a few moves does not. */
-export const pliesBeforeClearing = 20;
+const pliesBeforeClearing = 20;
 // A FEN's board: eight ranks of pieces and empty counts.
 const fenPattern = /^[pnbrqkPNBRQK1-8]+(?:\/[pnbrqkPNBRQK1-8]+){7}(?:\s|$)/;
 /**
  * Whether the chat must be cleared first: the last game begun, in any profile, was played in it at some length, and the host says how chats start (the hook
- * of Claude Code and Codex, T-85, T-104). Another profile does not clear the chat (D-66), nor a game another chat played, which this one was never shown (D-71).
+ * of Claude Code and Codex). Another profile does not clear the chat (D-66), nor a game another chat played, which this one was never shown (D-71).
  */
 function chatToClear(context) {
     const start = lastChatStart(context.folder);

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

@@ -1,9 +1,8 @@
-import { type MoveReview } from "../core/index.ts";
-import type { Context } from "./context.ts";
+import type { Context, SeenPosition } from "./context.ts";
 import { type MovePlayed } from "./game-summary.ts";
 /** Who plays a move: the AI, or the player through the AI. */
 export type Mover = "ai" | "player";
-/** What comes with a move: the AI's comment, or the player's words from the board page, saved with it (T-65), and a draw offer (D-65). */
+/** What comes with a move: the AI's comment, or the player's words from the board page, saved with it, and a draw offer (D-65). */
 export interface WithMove {
     comment?: string;
     offerDraw?: boolean;
@@ -13,28 +12,20 @@ export interface WithMove {
     };
     /** Milliseconds of the mover's turn that were not theirs, not taken off their clock (D-36). */
     allowance?: number;
-    /** The AI's badge and note on the player's last move, kept in its comment as the analyst keeps them (D-78). */
-    judged?: MoveReview;
+    /** A coach judges the player's moves with the helps on (D-88): the AI reads it after the player's move. */
+    coached?: 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, judged }?: WithMove): MovePlayed;
-/**
- * Where the game a chat sees stands: the game by its start, none when there is none, and how many plies it has. Not by its folder, which a profile
- * completed renames (D-71); a game in another profile started at another time.
- */
-export interface Position {
-    readonly started?: string;
-    readonly plies: number;
-}
+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;
 /** 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();
 }
 /** The position of the profile's game now. */
-export declare function positionIn(folder: string): Position;
+export declare function positionIn(folder: string): SeenPosition;
 /**
  * Refuses a chat's move or ending on a position it has not seen, changed by another chat or on the board page, or before any tool showed it the game
  * (D-71). Words and the clock change no position; the command line and the page, which have no chat, are never refused.
@@ -42,3 +33,5 @@ export declare function positionIn(folder: string): Position;
 export declare function refuseUnseenPosition(context: Context, folder: string): void;
 /** Refuses a chat's words on a game it has not seen, which another chat or the page started: words on a later move of the same game do no harm. */
 export declare function refuseOtherGame(context: Context, folder: string): void;
+/** Whether two positions a chat may see are the same: the same game, as many plies. */
+export declare function samePosition(one: SeenPosition, other: SeenPosition): boolean;