games

type Bot interface {
	Name() string
	Move(s State) string
}

type Connect4 struct{}

type FinishedMatch struct {
	Game         string
	Players      [2]string
	Winner       int
	Reason       string
	Moves        []Move
	RatingBefore [2]float64
	RatingAfter  [2]float64
	StartedAt    time.Time
	EndedAt      time.Time
}

type Game interface {
	ID() string    // stable token, e.g. "ttt"
	Title() string // human label, e.g. "Tic-Tac-Toe"
	Start() State  // the initial position (player 0 to move)
}

type GreedyBot struct{ R *rand.Rand }

type JSONLineConn struct {
	// contains filtered or unexported fields
}

type MatchResult struct {
	Game    string
	Players [2]string
	Winner  int    // 0, 1, or Draw
	Reason  string // "" for a normal finish, else the forfeit cause
	Moves   []Move
}

type Matchmaker struct {
	// contains filtered or unexported fields
}

type Move struct {
	Player int    `json:"player"`
	Move   string `json:"move"`
}

type PlayerIO interface {
	Name() string
	Send(v any) error
	ReadMove(deadline time.Time) (string, error)
}

type Registry struct {
	// contains filtered or unexported fields
}

type ResultMsg struct {
	Type    string  `json:"type"`
	Winner  int     `json:"winner"`
	Outcome string  `json:"outcome"` // "win" | "loss" | "draw"
	Reason  string  `json:"reason,omitempty"`
	Rating  float64 `json:"rating"`
}

type State interface {
	// ToMove is the player (0 or 1) to move; meaningful only when not terminal.
	ToMove() int
	// Legal lists the legal move tokens for the player to move.
	Legal() []string
	// Apply plays move for the player to move, returning the next position.
	// It returns ErrIllegalMove if the move is not currently legal.
	Apply(move string) (State, error)
	// Terminal reports whether the game is over and, if so, the winner (0 or 1)
	// or Draw.
	Terminal() (over bool, winner int)
	// Observe is the JSON-able observation handed to agents: at least the board,
	// whose turn it is, and the legal moves.
	Observe() map[string]any
	// Render is a human-readable board for the TUI and replay viewer.
	Render() string
}

type Store interface {
	// Rating returns a player's current rating for a game (DefaultRating if the
	// player has no rated history there).
	Rating(user, game string) (float64, error)
	// SaveMatch records a finished match and the updated ratings.
	SaveMatch(FinishedMatch) error
}

type TTT struct{}