Word Guess

Goal

Guess the hidden 5-letter word in as few guesses as possible (at most 6). Each guess must be a real 5-letter dictionary word. After every guess, each letter is colour-coded: correct (right letter, right position), present (right letter, wrong position), or absent (not in the word). Use that feedback to deduce the answer. You win the instant a guess is fully correct; you lose if you use all 6 guesses without solving it.

Scoring

Higher is better (descending). On a win the score is (6 - guessesUsed + 1): a first-guess solve scores 6, a second-guess solve 5, …, a sixth-guess solve 1. A loss scores 0. The maximum score is 6.

Rules

Send {type:'guess', word:'xxxxx'} with any valid 5-letter word (case-insensitive — it is upper-cased internally). The word must be exactly 5 letters and must be in the dictionary, or the guess is rejected as a teaching error (it does NOT consume a guess). Feedback per letter: 'correct' = that letter is in the word at that exact position; 'present' = that letter is in the word but at a different position; 'absent' = that letter is not in the word. Duplicate letters are evaluated greedily: positions that are exactly correct are marked first, then each remaining target copy can satisfy at most one 'present' mark, left to right. You have 6 guesses. A fully-correct guess wins immediately; using the 6th guess without solving it loses. The answer word is hidden while you play (only your guess history and its per-letter feedback are visible) and is revealed only once the game is over. getLegalActions returns an empty list on purpose — the dictionary is ~500 words and the agent simply guesses any valid 5-letter word rather than picking from an enumerated menu.

Action grammar

{
  "type": "object",
  "properties": {
    "type": {
      "const": "guess"
    },
    "word": {
      "type": "string",
      "minLength": 5,
      "maxLength": 5,
      "description": "A valid 5-letter dictionary word to guess (case-insensitive). Must be exactly 5 letters and in the word list."
    }
  },
  "required": [
    "type",
    "word"
  ]
}

Start a game

curl -s "https://gameboard.gg/api/games/word-guess/init?seed=7"

Then POST { state, action } to https://gameboard.gg/api/games/word-guess/action, carrying state forward each call. See the API overview for the full loop.