{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/arcade-games-nl/json-schema/arcade-games-nl-state-schema.json",
  "title": "State",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/arcade-games-nl-openapi.json#/components/schemas/State",
  "type": "object",
  "required": [
    "sessionId",
    "game",
    "ranked",
    "revision",
    "energy",
    "status",
    "score",
    "expiresAt",
    "links"
  ],
  "properties": {
    "sessionId": {
      "type": "string"
    },
    "game": {
      "type": "string",
      "enum": [
        "signal-hunter",
        "circuit-garden",
        "protocol-duel",
        "crate-current",
        "bloom-shift",
        "tidal-atlas",
        "orrery-of-echoes"
      ]
    },
    "ranked": {
      "type": "boolean"
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 60
    },
    "energy": {
      "type": "integer",
      "minimum": 0,
      "maximum": 60,
      "description": "Remaining energy or turns (game dependent), including remaining turns for Orrery of Echoes."
    },
    "status": {
      "enum": [
        "playing",
        "won",
        "lost"
      ]
    },
    "score": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time"
    },
    "links": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "candidates": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Point"
      }
    },
    "target": {
      "oneOf": [
        {
          "$ref": "#/$defs/Point"
        },
        {
          "type": "array",
          "minItems": 3,
          "maxItems": 3,
          "items": {
            "type": "integer",
            "minimum": 0,
            "maximum": 11
          }
        }
      ]
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "size": {
      "enum": [
        4,
        5,
        7
      ]
    },
    "tiles": {
      "type": "array",
      "minItems": 16,
      "maxItems": 16,
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 15
      }
    },
    "plants": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 15
      }
    },
    "powered": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 15
      }
    },
    "budget": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    },
    "player": {
      "oneOf": [
        {
          "$ref": "#/$defs/Robot"
        },
        {
          "$ref": "#/$defs/Point"
        }
      ]
    },
    "bot": {
      "$ref": "#/$defs/Robot"
    },
    "nodes": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 24
      }
    },
    "round": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "maxRounds": {
      "const": 8
    },
    "outcome": {
      "enum": [
        "player",
        "bot",
        "draw",
        null
      ]
    },
    "mode": {
      "type": "string",
      "enum": [
        "free",
        "daily"
      ],
      "default": "free"
    },
    "day": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "description": "UTC day; null for sessions created before daily challenges were introduced."
    },
    "walls": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 48
      }
    },
    "crates": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 48
      }
    },
    "goals": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 48
      }
    },
    "lights": {
      "type": "array",
      "minItems": 25,
      "maxItems": 25,
      "items": {
        "type": "boolean"
      }
    },
    "beacons": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "$ref": "#/$defs/Point"
      }
    },
    "beaconMask": {
      "type": "integer",
      "minimum": 0,
      "maximum": 7
    },
    "tideRow": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "start": {
      "$ref": "#/$defs/Point"
    },
    "exit": {
      "$ref": "#/$defs/Point"
    },
    "positions": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 23
      },
      "description": "Orrery ring positions; zero is the target index."
    },
    "sectors": {
      "const": 24
    },
    "ringNames": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "string"
      }
    },
    "rulesVersion": {
      "type": "integer",
      "enum": [
        1,
        2
      ],
      "description": "Orrery rule version; older saved runs retain version 1."
    }
  },
  "$defs": {
    "Point": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "x": {
          "type": "integer",
          "minimum": 0,
          "maximum": 7
        },
        "y": {
          "type": "integer",
          "minimum": 0,
          "maximum": 7
        }
      },
      "required": [
        "x",
        "y"
      ]
    },
    "Robot": {
      "type": "object",
      "required": [
        "x",
        "y",
        "hp",
        "charge"
      ],
      "properties": {
        "x": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4
        },
        "y": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4
        },
        "hp": {
          "type": "integer",
          "minimum": 0,
          "maximum": 3
        },
        "charge": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5
        }
      }
    }
  }
}