Add a CLI front-end

// cli/src/index.ts
import { stdout } from "node:process";
import { createLocalSession } from "@openturn/core";
import { ticTacToe } from "@my/tic-tac-toe-game";

const session = createLocalSession(ticTacToe, { match: { players: ticTacToe.playerIDs } });
const reader = Bun.stdin.stream().pipeThrough(new TextDecoderStream()).getReader();

async function prompt(text: string) {
  stdout.write(text);
  const { value } = await reader.read();
  return value?.trim() ?? null;
}

while (true) {
  const snap = session.getState();
  printBoard(snap.G.board);
  if (snap.meta.result !== null) {
    console.log(snap.meta.result);
    break;
  }
  const player = snap.derived.activePlayers[0]!;
  const line = await prompt(`Player ${player} (row col): `);
  if (line === null || line === "q") break;
  const [row, col] = line.split(" ").map(Number);
  const result = session.applyEvent(player, "placeMark", { row, col });
  if (!result.ok) console.log("rejected:", result.error);
}

{
  "name": "@my/tic-tac-toe-cli",
  "openturn": { "runtime": "bun" },
  "scripts": { "demo": "bun run src/index.ts" },
  "dependencies": {
    "@openturn/core": "workspace:*",
    "@my/tic-tac-toe-game": "workspace:*"
  }
}

import { createSavedReplayFromSession, serializeSavedReplay } from "@openturn/replay";

const session = createLocalSession(ticTacToe, {
  match: { players: ticTacToe.playerIDs },
  seed: "cli-run",
});
// ... play the match ...

const envelope = createSavedReplayFromSession({
  gameID: "example/tic-tac-toe",
  playerID: "0",
  session,
});
await Bun.write("replay.json", serializeSavedReplay(envelope));

while (session.getState().meta.result === null) {
  const snap = session.getState();
  const player = snap.derived.activePlayers[0]!;
  const move = pickMove(snap, player);     // your logic
  session.applyEvent(player, move.name, move.args);
}