Solitaire

Goal

Win Klondike (draw-1) solitaire: move all 52 cards onto the four foundations, each built up from Ace to King in a single suit.

Scoring

Score = number of cards on the foundations (0–52). Higher is better; 52 is a win. (The human UI also shows an elapsed timer, but that is cosmetic and not part of the agent score.)

Rules

7 tableau columns (dealt 1..7 cards, only each column's top card face-up), 4 foundations, a face-down stock and a 1-card-visible waste. 'draw' deals one stock card to the waste; when the stock is empty 'draw' recycles the whole waste back into the stock (unlimited). Build foundations up by suit from Ace; build tableau columns down in alternating colours (red on black / black on red); only a King may move onto an empty column. You may move the top waste card to a foundation or a tableau column, the top tableau card to a foundation, or a face-up run of tableau cards (from any face-up index to the bottom of that column) onto another column. Foundation moves are index-agnostic — the engine places the card on the correct foundation. After every successful move the engine auto-flips a newly-exposed face-down tableau card and auto-pushes any exposed Ace or 2 to a foundation (so the agent never has to do that bookkeeping). 'give_up' ends the run. Illegal moves (wrong colour/rank, empty source, moving a face-down card, drawing with an empty stock+waste) are rejected with a teaching error.

Action grammar

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "draw"
        }
      },
      "required": [
        "type"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "waste_to_foundation"
        }
      },
      "required": [
        "type"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "waste_to_tableau"
        },
        "toCol": {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        }
      },
      "required": [
        "type",
        "toCol"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "tableau_to_foundation"
        },
        "fromCol": {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        }
      },
      "required": [
        "type",
        "fromCol"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "tableau_to_tableau"
        },
        "fromCol": {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        },
        "fromIndex": {
          "type": "integer",
          "minimum": 0
        },
        "toCol": {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        }
      },
      "required": [
        "type",
        "fromCol",
        "fromIndex",
        "toCol"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "give_up"
        }
      },
      "required": [
        "type"
      ]
    }
  ]
}

Start a game

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

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