chesspal 0.2.2 → 0.2.4

package/dist/page/text.js

@@ -64,7 +64,7 @@ const english = {
     noGame: "No game yet: press + to start one, or ask for one in the chat.",
     foldCard: "Fold the card",
     openCard: "Open the card",
-    saveMoves: "Moves-only PGN",
+    saveMoves: "PGN",
     saveMovesHint: "The moves alone, to open on Lichess or chess.com",
     noGameNow: "No game in progress",
     analysing: "Analysis in progress",
@@ -103,6 +103,8 @@ const english = {
     send: "Send",
     sent: "Sent",
     withMove: "Or move: your words go with it",
+    onMove: "On",
+    onWholeGame: "On the whole game",
     talk: "The talk",
     move: "Move",
     draw: "draw",
@@ -129,6 +131,7 @@ const english = {
     startClocks: "Start",
     thinking: { move: "Thinking about its move", ponder: "Thinking while you play" },
     asleep: (name) => `${name} is not listening: write a message, such as "hi", in the window where you opened ${name}, not here. Its clock waits until it answers.`,
+    asleepInAnalysis: (name) => `${name} is not listening: write to it in the window where you opened it, not here.`,
     commandHere: (name) => `/clear and the other commands go in the window where you opened ${name}, not here.`,
     refused: {
         "no-game": () => "There is no game going on: press + to start one, or ask for one in the chat.",
@@ -149,6 +152,8 @@ const english = {
     piece: (letter, side) => `${side} ${englishNames[letter]}`,
     taken: (pieces, ahead) => `Pieces taken: ${pieces.length === 0 ? "none" : pieces.join(", ")}${ahead > 0 ? `; ahead by ${ahead}` : ""}`,
     writeTo: (name) => `Write to ${name}…`,
+    askAbout: (name) => `Ask ${name} about this game…`,
+    goTo: (move) => `Go to ${move}`,
     readBy: (name) => `Read by ${name}`,
     wrote: (name) => `${name} wrote`,
     offers: "offers a draw",
@@ -274,16 +279,18 @@ const english = {
         outnumbered: "more attackers than defenders",
         pinnedTo: (letter) => `pinned to the ${englishNames[letter]}`,
         pinnedBy: (letter) => `by the ${englishNames[letter]}`,
+        skeweredBefore: (letter) => `ahead of the ${englishNames[letter]}`,
         nothingAtRisk: "No piece at risk, no pins.",
         line: (kind, side, you, toMove) => {
             const name = side === "white" ? "White" : "Black";
+            const pieces = { risk: "pieces at risk", pin: "pinned pieces", skewer: "skewered pieces" };
             if (you === undefined) {
-                return kind === "risk" ? `${name}'s pieces at risk` : kind === "pin" ? `${name}'s pinned pieces` : `${name}'s checks${toMove ? "" : `, if it were ${name}'s move`}`;
+                return kind === "check" ? `${name}'s checks${toMove ? "" : `, if it were ${name}'s move`}` : `${name}'s ${pieces[kind]}`;
             }
             if (kind === "check") {
                 return side === you ? `Checks you ${toMove ? "can" : "could"} give` : `Checks the opponent ${toMove ? "can" : "could"} give you`;
             }
-            return `${side === you ? "Your" : "The opponent's"} ${kind === "risk" ? "pieces at risk" : "pinned pieces"}`;
+            return `${side === you ? "Your" : "The opponent's"} ${pieces[kind]}`;
         },
         loose: "Pieces neither attacked nor defended",
         yours: "yours",
@@ -323,6 +330,19 @@ const english = {
         pawnSquare: (pawn, caught) => `The enemy king is ${caught ? "inside" : "outside"} the square of the pawn on ${pawn}`,
         opposition: (side) => `${side === "white" ? "White" : "Black"} has the opposition`,
     },
+    legend: {
+        title: "Marks on the board",
+        hint: "Marks on the board (?)",
+        none: "No marks on the board now",
+        badge: "the move's judgment",
+        sign: (kind, tone) => `${tone === "threat" ? "Your" : tone === "chance" ? "Opponent's" : "A"} ${{ risk: "piece at risk", pin: "pinned piece", skewer: "skewered piece" }[kind]}`,
+        pinLine: "The pin's line",
+        skewerLine: "The skewer's line",
+        drawnBy: (name) => `drawn by ${name}`,
+        drawnByCoach: "drawn by the coach",
+        control: "How many of White's pieces and of Black's reach the square",
+        ends: { crown: "Won", mate: "Checkmated", flag: "Resigned", half: "Draw, half a point each" },
+    },
 };
 const italian = {
     language: "it",
@@ -383,7 +403,7 @@ const italian = {
     noGame: "Nessuna partita: premi + per iniziarne una, o chiedila nella chat.",
     foldCard: "Chiudi la scheda",
     openCard: "Apri la scheda",
-    saveMoves: "PGN solo mosse",
+    saveMoves: "PGN",
     saveMovesHint: "Solo le mosse, da aprire su Lichess o chess.com",
     noGameNow: "Nessuna partita in corso",
     analysing: "Analisi in corso",
@@ -422,6 +442,8 @@ const italian = {
     send: "Manda",
     sent: "Mandato",
     withMove: "Oppure muovi: parte con la mossa",
+    onMove: "Su",
+    onWholeGame: "Su tutta la partita",
     talk: "Conversazione",
     move: "Mossa",
     draw: "patta",
@@ -448,6 +470,7 @@ const italian = {
     startClocks: "Inizia",
     thinking: { move: "Sta pensando alla sua mossa", ponder: "Pensa mentre giochi tu" },
     asleep: (name) => `${name} non ti sta ascoltando: scrivi un messaggio, per esempio "ciao", nella finestra dove hai aperto ${name}, non qui. Il suo orologio aspetta che risponda.`,
+    asleepInAnalysis: (name) => `${name} non ti sta ascoltando: scrivigli nella finestra dove l'hai aperto, non qui.`,
     commandHere: (name) => `/clear e gli altri comandi vanno scritti nella finestra dove hai aperto ${name}, non qui.`,
     refused: {
         "no-game": () => "Nessuna partita in corso: premi + per iniziarne una, o chiedila nella chat.",
@@ -469,6 +492,8 @@ const italian = {
     piece: (letter, side) => `${italianNames[letter]} ${side === "white" ? (letter === "Q" || letter === "R" ? "bianca" : "bianco") : (letter === "Q" || letter === "R" ? "nera" : "nero")}`,
     taken: (pieces, ahead) => `Pezzi presi: ${pieces.length === 0 ? "nessuno" : pieces.join(", ")}${ahead > 0 ? `; avanti di ${ahead}` : ""}`,
     writeTo: (name) => `Scrivi a ${name}…`,
+    askAbout: (name) => `Chiedi a ${name} di questa partita…`,
+    goTo: (move) => `Vai a ${move}`,
     readBy: (name) => `Letto da ${name}`,
     wrote: (name) => `${name} ha scritto`,
     offers: "propone patta",
@@ -594,16 +619,18 @@ const italian = {
         outnumbered: "più attaccanti che difensori",
         pinnedTo: (letter) => `davanti ${italianWith("a", letter)}`,
         pinnedBy: (letter) => italianWith("da", letter),
+        skeweredBefore: (letter) => `con dietro ${italianThe[letter]}`,
         nothingAtRisk: "Nessun pezzo in pericolo, nessuna inchiodatura.",
         line: (kind, side, you, toMove) => {
             const name = side === "white" ? "Bianco" : "Nero";
+            const what = { risk: "in pericolo", pin: "inchiodati", skewer: "infilati" };
             if (you === undefined) {
-                return kind === "risk" ? `Pezzi del ${name} in pericolo` : kind === "pin" ? `Pezzi del ${name} inchiodati` : `Scacchi del ${name}${toMove ? "" : ", se toccasse a lui"}`;
+                return kind === "check" ? `Scacchi del ${name}${toMove ? "" : ", se toccasse a lui"}` : `Pezzi del ${name} ${what[kind]}`;
             }
             if (kind === "check") {
                 return side === you ? `Scacchi che ${toMove ? "puoi" : "potresti"} dare` : `Scacchi che l'avversario ${toMove ? "può" : "potrebbe"} darti`;
             }
-            return `${side === you ? "I tuoi pezzi" : "I pezzi avversari"} ${kind === "risk" ? "in pericolo" : "inchiodati"}`;
+            return `${side === you ? "I tuoi pezzi" : "I pezzi avversari"} ${what[kind]}`;
         },
         loose: "Pezzi né attaccati né difesi",
         yours: "tuoi",
@@ -643,6 +670,19 @@ const italian = {
         pawnSquare: (pawn, caught) => `Il re nemico è ${caught ? "dentro il" : "fuori dal"} quadrato del pedone in ${pawn}`,
         opposition: (side) => `L'opposizione è del ${side === "white" ? "Bianco" : "Nero"}`,
     },
+    legend: {
+        title: "Segni sulla scacchiera",
+        hint: "Segni sulla scacchiera (?)",
+        none: "Nessun segno sulla scacchiera ora",
+        badge: "il giudizio della mossa",
+        sign: (kind, tone) => `${tone === "threat" ? "Tuo pezzo" : tone === "chance" ? "Pezzo avversario" : "Pezzo"} ${{ risk: "in pericolo", pin: "inchiodato", skewer: "infilato" }[kind]}`,
+        pinLine: "Linea dell'inchiodatura",
+        skewerLine: "Linea dell'infilata",
+        drawnBy: (name) => `disegnato da ${name}`,
+        drawnByCoach: "disegnato dall'allenatore",
+        control: "Quanti pezzi del Bianco e del Nero raggiungono la casa",
+        ends: { crown: "Ha vinto", mate: "Scacco matto", flag: "Ha abbandonato", half: "Patta, mezzo punto a testa" },
+    },
 };
 // How each piece moves, said when it was taken where it cannot go (Anatolij's words).
 const englishMoves = {

package/dist/server/mcp.js

@@ -154,14 +154,16 @@ function toolConfig(command) {
     return { description: command.description, inputSchema: z.looseObject({}).meta({ ...shownInput(command), $schema: undefined }), annotations, _meta: meta };
 }
 async function runTool(command, input, context, caller, meta) {
-    const agent = await sharingAgent(command, meta, context);
+    const calling = await sharingCaller(command, meta, context);
+    const agent = calling !== undefined && "agent" in calling ? calling.agent : undefined;
     const chat = command.byAgents === undefined && agent === undefined;
     let refused = false;
     try {
         if (chat) {
             context.calls?.();
         }
-        const result = await command.run(checkedInput(command, input), { ...context, caller, ...(agent === undefined ? {} : { agent }) });
+        const who = agent !== undefined ? { agent } : calling !== undefined ? { chat: true } : {};
+        const result = await command.run(checkedInput(command, input), { ...context, caller, ...who });
         return { content: [{ type: "text", text: command.format(result, context) }] };
     }
     catch (error) {
@@ -177,16 +179,16 @@ async function runTool(command, input, context, caller, meta) {
     }
 }
 /**
- * The agent that calls a tool it shares with the chat, as the analyst (D-89), by its type: looked up only in a folder where one may run and while no game
- * goes on, so that no call of the chat's waits for it while it plays; none for the chat, or when it cannot be told.
+ * Who calls a tool the chat shares with an agent, as the analyst (D-89): the chat, or the agent by its type; looked up only in a folder where one may run
+ * and while no game goes on, so that no call of the chat's waits for it while it plays. None when it cannot be told, or for an agent the tool is not shared with.
  */
-async function sharingAgent(command, meta, context) {
+async function sharingCaller(command, meta, context) {
     const agents = command.sharedWith?.filter((agent) => hasAgent(context.folder, agent, context.host?.())) ?? [];
     if (agents.length === 0 || gameGoingOn(context)) {
         return undefined;
     }
     const caller = await callingAgent(meta, context.folder);
-    return caller !== undefined && "agent" in caller && agents.includes(caller.agent) ? caller.agent : undefined;
+    return caller !== undefined && "agent" in caller && !agents.includes(caller.agent) ? undefined : caller;
 }
 /** Whether a game goes on, or may: a game that cannot be read is the command's to report, as the chat's call (Federico). */
 function gameGoingOn(context) {

package/dist/server/page/game.js

@@ -1,4 +1,4 @@
-import { analyseGame, answerDraw, bookPlies, ChatNotClear, DrawRefused, endGame, gameAt, gameToStudy, namedGame, newGame, offerDraw, playMove, samePosition, say, startNewGame, } from "../../commands/index.js";
+import { analyseGame, answerDraw, bookPlies, ChatNotClear, DrawRefused, endGame, gameAt, gameToStudy, namedGame, newGame, offerDraw, playMove, samePosition, say, shownPosition, startNewGame, } from "../../commands/index.js";
 import { clockStarted, isReviewed, writePgn } from "../../core/index.js";
 import { aiModelOf, archiveName, coachShown, coachWords, drawOfferOf, endOf, gameInAnalysis, heardLines, loadGame, loadTableTalk, playerPgn, ponderingOn, saveGame, startAnalysis, talkLimits, thoughtKey, wakesTheChat, WordsRefused, } from "../../games/index.js";
 import { gameFolder, helpsIn } from "../../profiles/index.js";
@@ -72,28 +72,34 @@ async function moveFromPage(request, response, served) {
     served.bell.ring();
     send(response, 200, json, JSON.stringify({ played: true }));
 }
-/** The player's words from the page, without a move: saved with the game as player_say saves them, refused in the player's words, the doorbell rung for the first. */
+/**
+ * The player's words from the page, without a move: saved with the game as player_say saves them, refused in the player's words, the doorbell rung for the
+ * first; in analysis with the position the page shows, and the doorbell rung for each (D-101).
+ */
 async function messageFromPage(request, response, served) {
     if (!isJson(request)) {
         send(response, 415, json, JSON.stringify({ error: 'Send the message as JSON: {"text": "…"}.' }));
         return;
     }
-    const text = textOf(jsonOf(await bodyOf(request))?.text);
+    const body = jsonOf(await bodyOf(request));
+    const text = textOf(body?.text);
+    const shown = typeof body?.game === "string" && typeof body.at === "number" ? shownPosition(served.context, body.game, body.at) : undefined;
     if (text === undefined) {
         send(response, 400, json, JSON.stringify({ error: `Send the message as JSON, ${talkLimits.player} characters at most: {"text": "…"}.` }));
         return;
     }
     let current;
     try {
-        current = say(gameFolder(served.context.home()), "player", text, served.context.now());
+        current = say(gameFolder(served.context.home()), "player", text, served.context.now(), undefined, shown);
     }
     catch (error) {
         const noGame = refusalOf(served)?.refusal === "no-game";
         send(response, 409, json, JSON.stringify(refusalFrom(error, noGame ? "no-game" : undefined)));
         return;
     }
-    // The first words of a move wake the chat, and between games the first since the AI spoke; the AI finds the rest at its next call (D-54, D-74).
-    if (wakesTheChat(current)) {
+    // The first words of a move wake the chat, and between games the first since the AI spoke; the AI finds the rest at its next call (D-54, D-74). In
+    // analysis every line does: a chat that answered in its own window would not hear the next (Priya).
+    if (shown !== undefined || wakesTheChat(current)) {
         served.bell.ring();
     }
     send(response, 200, json, JSON.stringify({ said: true }));
@@ -244,7 +250,14 @@ function sendGame(response, served) {
     // With no game the page still shows the talk before the first (D-77).
     const spoken = current ?? loadTableTalk(folder);
     const heard = heardLines(spoken, served.context.given);
-    const talk = spoken.talk.map(({ who, text, ply }, index) => heard[index] === undefined ? { who, text, ply } : { who, text, ply, heard: heard[index] });
+    const talk = spoken.talk.map(({ who, text, ply, shown }, index) => ({
+        who,
+        text,
+        ply,
+        ...(heard[index] === undefined ? {} : { heard: heard[index] }),
+        // In analysis the page goes back to the move the player wrote about (D-101).
+        ...(shown === undefined ? {} : { shown }),
+    }));
     const offer = current === undefined ? undefined : drawOfferOf(current);
     const coach = coachOn(folder, current);
     const game = current === undefined ? null : {

package/dist/server/page/page.js

@@ -4,7 +4,7 @@ import { watch } from "node:fs";
 import { createServer } from "node:http";
 import { join } from "node:path";
 import { positionIn, samePosition } from "../../commands/index.js";
-import { gameStamp } from "../../games/index.js";
+import { gameStamp, tableTalkStamp } from "../../games/index.js";
 import { outdatedHostFiles } from "../../host-files/index.js";
 import { gameFolder } from "../../profiles/index.js";
 import { Bell, bellProbe, pagePorts } from "../bell.js";
@@ -111,12 +111,14 @@ function answer(request, response, served) {
 function hasNews(context) {
     return gameSeen(context) !== context.seen;
 }
-// The game the chat sees: the profile's folder, and the stamp of its game.json; none while the data folder cannot be made.
+// The game the chat sees: the profile's folder, and the stamps of its game.json and of the talk with no game, where the player's words go in analysis
+// before any game was played here (Priya); none while the data folder cannot be made.
 function gameSeen(context) {
     try {
         const folder = gameFolder(context.home());
         return `${folder}
-${gameStamp(folder) ?? ""}`;
+${gameStamp(folder) ?? ""}
+${tableTalkStamp(folder) ?? ""}`;
     }
     catch {
         return "";

package/instructions/opponent.md

@@ -10,6 +10,6 @@ This folder is the player's chess table, and you are their opponent: you choose
 - You have a face on the board page, and it shows how you feel. Give it as the `mood` of `ai_move` on each move where the game turns for you: a piece won or lost, a blunder seen, your own or theirs, a threat that appears or a plan that works or fails. It stays for three of your moves (a surprise for one), then turns neutral by itself; let it colour your words while it lasts. When the game ends on the player's move, give how you feel as it ends with `ai_say`'s `mood`.
 - Draws and resignations: `offer_draw` on `ai_move` offers a draw, on `player_move` records the player's, made with their move; an offer stands until the other side moves; `end_game` `draw_agreed` accepts a standing offer, `player_resigns` records the player's resignation in the chat, `ai_resigns` resigns yours. On the board page the player offers, answers and resigns there.
 - The player chooses a new game in the board page's New game window, which asks the sides, the clock and the level: when they ask you for a game, call `new_game` without choices, which opens it there, and don't ask those in the chat. Ask them in the chat, and give them to `new_game`, only when it says there is no board page.
-- To go over a game with the player once no game goes on, the one just over or one they bring as a PGN, give it to `analyse_game`: it reads the PGN for you; where Chesspal's answers say to start the analyst agent for it, start that instead, once per game: when it has gone over the game, go over it with the player from what it told you, and never tell them it starts again, even when they ask for the analysis again. While a game goes on, go over no game, not even in your head or from a PGN they paste: tell them it waits until this one ends.
+- To go over a game with the player once no game goes on, the one just over or one they bring as a PGN, give it to `analyse_game`: it reads the PGN for you; where Chesspal's answers say to start the analyst agent for it, start that instead, once per game, and never tell them it starts again, even when they ask for the analysis again. While it works, and after, talk the game over whenever the player asks: `look` and `position` with game and move show you any of its positions. When they show you something the review missed, first correct that move's note with `annotate_game` {game, notes: [{move, badge, note}]}, that move only, then answer. Words from the board page you answer with `ai_say`; words in the chat, in the chat. While a game goes on, go over no game, not even in your head or from a PGN they paste: tell them it waits until this one ends.
 - How to read the facts: attackers and defenders count only the pieces that reach the square directly, and a piece in brackets stands behind them; "Loose" means neither attacked nor defended, not attacked now; "At risk" lists the pieces attacked and undefended, attacked by a cheaper piece, or attacked more times than defended.
 - Talk with the player in their language, in a few words. The facts and the tools are for you: tell the player what a chess player would say, never the lists or the tools' names. Name pieces and moves in words, as people talk at the board ("your bishop took on f7"); when you write a move, yours or the player's, write it with the pieces' figurines, as the tools show it (♞f6 for Nf6, ♝xf7+ for Bxf7+), for both sides and in every language: never with letters, neither N B R Q K nor the player's own (Cf6), even when they write them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chesspal",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Play chess against an AI with a character, and learn with an AI coach: Chesspal keeps the rules, the board, the games and the memory; the AI plays, reasons and talks.",
   "type": "module",
   "bin": {