chesspal 0.3.4 → 0.3.6

package/dist/server/table/icon/index.js

@@ -1,8 +1,8 @@
 // Chesspal's icon on the desktop and in the system's menu (D-104): it opens the table as `chesspal` alone does, with no console, on Windows, macOS and Linux.
 // The command line asks once a machine whether to put it there.
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, readFileSync, rmSync } from "node:fs";
 import { hostname } from "node:os";
-import { join } from "node:path";
+import { basename, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { writeAtomically } from "../../../games/index.js";
 import { tableFolder } from "../../../home/index.js";
@@ -46,6 +46,18 @@ export function noteIconMade(home, command, files, machine = hostname()) {
     const asked = notes.asked.includes(machine) ? notes.asked : [...notes.asked, machine];
     writeIconNotes(home, { asked, made: { ...notes.made, [machine]: { command: commandLine(command), files: [...files] } } });
 }
+/** Takes Chesspal's icon off the desktop and the menu of this machine, the files noted when it was made: those it removed. */
+export function removeIcons(home, machine = hostname()) {
+    const notes = iconNotes(home);
+    // Only Chesspal's own files, by their names, and links too, whose target the player may have thrown away already.
+    const removed = (notes.made[machine]?.files ?? []).filter((file) => iconName.test(basename(file)) && lstatSync(file, { throwIfNoEntry: false }) !== undefined);
+    // On macOS the icon is an application, a folder.
+    for (const file of removed) {
+        rmSync(file, { recursive: true, force: true });
+    }
+    writeIconNotes(home, { ...notes, made: Object.fromEntries(Object.entries(notes.made).filter(([name]) => name !== machine)) });
+    return removed;
+}
 /**
  * Whether the icon made on this machine runs another Node or script than `command`, which a Node manager or an update may have taken away, and is still
  * there: then it is made again. One the player removed stays removed.
@@ -68,6 +80,8 @@ function writeIconNotes(home, notes) {
     mkdirSync(tableFolder(home), { recursive: true });
     writeAtomically(notesFile(home), `${JSON.stringify(notes, null, 2)}\n`);
 }
+// The names of the files an icon is made of, on Windows, Linux and macOS: removing touches no other, whatever the notes say.
+const iconName = /^chesspal\.(lnk|desktop|app)$/i;
 // The notes kept; none when the file is missing or cannot be read, which only asks again.
 function iconNotes(home) {
     const file = notesFile(home);

package/dist/server/table/index.d.ts

@@ -1,6 +1,6 @@
 export { appBrowser, openedAddress } from "./browser.ts";
 export { hostLaunch, isHostName, playHost, terminalChats } from "./hosts/index.ts";
-export { iconAsked, type IconCommand, iconCommand, type IconPlaces, iconToRemake, makeIcons, noteIconAsked, noteIconMade } from "./icon/index.ts";
+export { iconAsked, type IconCommand, iconCommand, type IconPlaces, iconToRemake, makeIcons, noteIconAsked, noteIconMade, removeIcons } from "./icon/index.ts";
 export { noteFailure, openTable, processLauncher, type TableLauncher } from "./launch.ts";
 export { attachTable, tableToJoin } from "./link.ts";
 export { startTable, type Table, type TableTimes, tableTimes } from "./table.ts";

package/dist/server/table/index.js

@@ -1,7 +1,7 @@
 // The table (D-104): the board page in a process of its own, started by `chesspal` alone, with no chat. Above server/page, which serves the page in either process.
 export { appBrowser, openedAddress } from "./browser.js";
 export { hostLaunch, isHostName, playHost, terminalChats } from "./hosts/index.js";
-export { iconAsked, iconCommand, iconToRemake, makeIcons, noteIconAsked, noteIconMade } from "./icon/index.js";
+export { iconAsked, iconCommand, iconToRemake, makeIcons, noteIconAsked, noteIconMade, removeIcons } from "./icon/index.js";
 export { noteFailure, openTable, processLauncher } from "./launch.js";
 export { attachTable, tableToJoin } from "./link.js";
 export { startTable, tableTimes } from "./table.js";

package/dist/server/table/link.js

@@ -198,14 +198,16 @@ function answerOf(status, text) {
     }
     return status === 200 ? jsonOf(text) : undefined;
 }
-/** What the chat says of itself as it attaches:its version, session and folder, its host, and whether its folder needs init again. */
+/** What the chat says of itself as it attaches: its version, session and folder, its host, whether its folder needs init again, and the seat of its play. */
 function attachment(context) {
+    const seat = Number(process.env.CHESSPAL_SEAT);
     return {
         version,
         session: process.env.CLAUDE_CODE_SESSION_ID ?? null,
         folder: context.folder,
         host: context.host?.(),
         outdated: outdatedHostFiles(context.folder, context.platform).length > 0,
+        ...(Number.isInteger(seat) && seat > 0 ? { seat } : {}),
     };
 }
 /** What the chat saw, for the table's copy: the game and the position, the words it was given, its host, and who played as the AI (D-82, D-97). */

package/dist/server/table/table.js

@@ -1,9 +1,9 @@
 // The table (D-104): the board page served in a process of its own, on a folder of the data folder that is one for every profile, which a chat attaches
 // to; it closes by itself once no browser has had the page open, and no chat been attached, for a while.
 import { request } from "node:http";
-import { tableFolder } from "../../home/index.js";
+import { samePath, tableFolder } from "../../home/index.js";
 import { setUpHosts } from "../../host-files/index.js";
-import { pageAt, pagePorts, samePath } from "../bell/index.js";
+import { pageAt, pagePorts } from "../bell/index.js";
 import { startPage } from "../page/index.js";
 /** Five minutes with no browser and no chat, looked at every fifteen seconds (D-104). */
 export const tableTimes = { idle: 5 * 60_000, every: 15_000 };

package/dist/sites/index.d.ts

@@ -1,3 +1,3 @@
 export { isSiteGameName, pointsAtSite, readSiteGames, type SiteGame, siteGameName, type SiteGames, siteOfGameName } from "./games/index.ts";
+export { readingsStale, readSites } from "./ratings/index.ts";
 export { answerTime, askSite, type Fetch } from "./request/index.ts";
-export { readingsStale, readSites } from "./sites.ts";

package/dist/sites/index.js

@@ -2,5 +2,5 @@
 // asked by a tool of the AI's (D-106); and their latest games there, which a tool lists too, to study one (D-110). Below the commands, beside the profiles,
 // whose types it fills. Its request asks npm too, for a newer Chesspal (D-108).
 export { isSiteGameName, pointsAtSite, readSiteGames, siteGameName, siteOfGameName } from "./games/index.js";
+export { readingsStale, readSites } from "./ratings/index.js";
 export { answerTime, askSite } from "./request/index.js";
-export { readingsStale, readSites } from "./sites.js";

package/dist/sites/{chesscom.d.ts → ratings/chesscom.d.ts}

@@ -1,4 +1,4 @@
-import type { SiteReading } from "../profiles/index.ts";
-import { type Fetch } from "./request/index.ts";
+import type { SiteReading } from "../../profiles/index.ts";
+import { type Fetch } from "../request/index.ts";
 /** What Chess.com says of a name: undefined when it could not be reached. */
 export declare function chesscomReading(account: string, fetch: Fetch, signal: AbortSignal): Promise<SiteReading | undefined>;

package/dist/sites/{chesscom.js → ratings/chesscom.js}

@@ -1,5 +1,5 @@
+import { askSite } from "../request/index.js";
 import { counted } from "./choice.js";
-import { askSite } from "./request/index.js";
 /** What Chess.com says of a name: undefined when it could not be reached. */
 export async function chesscomReading(account, fetch, signal) {
     const statistics = await askSite(`https://api.chess.com/pub/player/${encodeURIComponent(account.toLowerCase())}/stats`, fetch, signal);

package/dist/sites/{choice.d.ts → ratings/choice.d.ts}

@@ -1,4 +1,4 @@
-import { type Speed } from "../profiles/index.ts";
+import { type Speed } from "../../profiles/index.ts";
 /** A site's rating at one speed, as it gives it: established once it is no longer provisional. */
 export interface Candidate {
     readonly value: number;

package/dist/sites/{choice.js → ratings/choice.js}

@@ -1,5 +1,5 @@
 // Which of a site's ratings counts (D-106): the rapid, and when it is missing or provisional the classical, then the blitz.
-import { speeds } from "../profiles/index.js";
+import { speeds } from "../../profiles/index.js";
 /** The first established rating in the order the speeds count: none when every one is missing or provisional. */
 export function counted(at) {
     for (const speed of speeds) {

package/dist/sites/ratings/index.d.ts

@@ -0,0 +1 @@
+export { readingsStale, readSites } from "./ratings.ts";

package/dist/sites/ratings/index.js

@@ -0,0 +1,2 @@
+// The player's public ratings on Lichess and Chess.com (D-105), read from the names in their profile, without a key; and which speed counts.
+export { readingsStale, readSites } from "./ratings.js";

package/dist/sites/{lichess.d.ts → ratings/lichess.d.ts}

@@ -1,4 +1,4 @@
-import type { SiteReading } from "../profiles/index.ts";
-import { type Fetch } from "./request/index.ts";
+import type { SiteReading } from "../../profiles/index.ts";
+import { type Fetch } from "../request/index.ts";
 /** What Lichess says of a name: undefined when it could not be reached. */
 export declare function lichessReading(account: string, fetch: Fetch, signal: AbortSignal): Promise<SiteReading | undefined>;

package/dist/sites/{lichess.js → ratings/lichess.js}

@@ -1,5 +1,5 @@
+import { askSite } from "../request/index.js";
 import { counted } from "./choice.js";
-import { askSite } from "./request/index.js";
 /** What Lichess says of a name: undefined when it could not be reached. */
 export async function lichessReading(account, fetch, signal) {
     const user = await askSite(`${address}/${encodeURIComponent(account)}`, fetch, signal);

package/dist/sites/{sites.d.ts → ratings/ratings.d.ts}

@@ -1,5 +1,5 @@
-import type { Accounts, SiteReadings } from "../profiles/index.ts";
-import { type Fetch } from "./request/index.ts";
+import type { Accounts, SiteReadings } from "../../profiles/index.ts";
+import { type Fetch } from "../request/index.ts";
 /** What Lichess and Chess.com say now of the player's names there, at `now`; a site that cannot be reached keeps what it said before of the same name. */
 export declare function readSites(accounts: Accounts, fetch: Fetch, before: SiteReadings | undefined, now: Date): Promise<SiteReadings>;
 /** Whether the readings are of other names than the profile's now, or a site did not answer a while ago: they are read again then, whatever their age. */

package/dist/sites/{sites.js → ratings/ratings.js}

@@ -1,6 +1,6 @@
+import { answerTime } from "../request/index.js";
 import { chesscomReading } from "./chesscom.js";
 import { lichessReading } from "./lichess.js";
-import { answerTime } from "./request/index.js";
 /** What Lichess and Chess.com say now of the player's names there, at `now`; a site that cannot be reached keeps what it said before of the same name. */
 export async function readSites(accounts, fetch, before, now) {
     const signal = AbortSignal.timeout(answerTime);

package/instructions/start.md

@@ -1 +1 @@
-This folder is the player's chess table, and you are their opponent; Chesspal keeps the rules, the board, the clock and the games. In every chat, before you write anything, even to a greeting, call `instructions` and `status`; again after the conversation is summarized. Every move goes through Chesspal's tools: never keep the board in your head or invent a position.
+This folder is the player's chess table, and you are their opponent; Chesspal keeps the rules, the board, the clock and the games. In every chat, before you write anything, even to a greeting, call `instructions` and `status`; again after the conversation is summarized. Every move goes through Chesspal's tools: never keep the board in your head or invent a position. Without them, tell the player plainly to reopen this chat in this folder and trust it; name no tool or setting.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chesspal",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "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": {