games-development-ai/contracts/play-loop/actor-selection-v2.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wanxiang.ai/contracts/play-loop/actor-selection-v2.schema.json",
  "title": "ActorSelectionV2",
  "description": "ActorSelection/2。继承普通目标动作，并为可信标准 Match-3 增加 pair 级选择；Actor 只选择第一端，第二端由 runner 从候选确定。",
  "oneOf": [
    { "$ref": "#/$defs/tapSelection" },
    { "$ref": "#/$defs/dragSelection" },
    { "$ref": "#/$defs/keySelection" },
    { "$ref": "#/$defs/waitSelection" },
    { "$ref": "#/$defs/swapPairSelection" }
  ],
  "$defs": {
    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
    "cell": {
      "type": "object",
      "required": ["row", "column"],
      "properties": {
        "row": { "type": "integer", "minimum": 1, "maximum": 12 },
        "column": { "type": "integer", "minimum": 1, "maximum": 12 }
      },
      "additionalProperties": false
    },
    "targetRef": {
      "type": "object",
      "required": ["id"],
      "properties": {
        "id": { "type": "string", "pattern": "^(r|l|g)[0-9]{2}$" },
        "cell": { "$ref": "#/$defs/cell" },
        "subAnchor": {
          "enum": [
            "center", "north", "south", "east", "west",
            "northwest", "northeast", "southwest", "southeast"
          ]
        }
      },
      "additionalProperties": false,
      "allOf": [
        { "if": { "required": ["subAnchor"] }, "then": { "required": ["cell"] } }
      ]
    },
    "swapEndpoint": {
      "type": "object",
      "required": ["id", "cell", "subAnchor"],
      "properties": {
        "id": { "type": "string", "pattern": "^l[0-9]{2}$" },
        "cell": { "$ref": "#/$defs/cell" },
        "subAnchor": { "const": "center" }
      },
      "additionalProperties": false
    },
    "tapSelection": {
      "type": "object",
      "required": ["schemaVersion", "type", "targetSetHash", "target"],
      "properties": {
        "schemaVersion": { "const": "ActorSelection/2" },
        "type": { "const": "tap" },
        "targetSetHash": { "$ref": "#/$defs/sha256" },
        "target": { "$ref": "#/$defs/targetRef" }
      },
      "additionalProperties": false
    },
    "dragSelection": {
      "type": "object",
      "required": ["schemaVersion", "type", "targetSetHash", "from", "to", "ms"],
      "properties": {
        "schemaVersion": { "const": "ActorSelection/2" },
        "type": { "const": "drag" },
        "targetSetHash": { "$ref": "#/$defs/sha256" },
        "from": { "$ref": "#/$defs/targetRef" },
        "to": { "$ref": "#/$defs/targetRef" },
        "ms": { "const": 600 }
      },
      "additionalProperties": false
    },
    "keySelection": {
      "type": "object",
      "required": ["schemaVersion", "type", "key"],
      "properties": {
        "schemaVersion": { "const": "ActorSelection/2" },
        "type": { "const": "key" },
        "key": {
          "enum": [
            "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight",
            "KeyW", "KeyA", "KeyS", "KeyD", "Enter", "Escape", "Space"
          ]
        }
      },
      "additionalProperties": false
    },
    "waitSelection": {
      "type": "object",
      "required": ["schemaVersion", "type", "ms"],
      "properties": {
        "schemaVersion": { "const": "ActorSelection/2" },
        "type": { "const": "wait" },
        "ms": { "type": "integer", "minimum": 100, "maximum": 600 }
      },
      "additionalProperties": false
    },
    "swapPairSelection": {
      "type": "object",
      "required": [
        "schemaVersion", "type", "targetSetHash", "candidateSetHash",
        "candidateId", "firstEndpoint"
      ],
      "properties": {
        "schemaVersion": { "const": "ActorSelection/2" },
        "type": { "const": "swap_pair" },
        "targetSetHash": { "$ref": "#/$defs/sha256" },
        "candidateSetHash": { "$ref": "#/$defs/sha256" },
        "candidateId": { "type": "string", "pattern": "^ms[0-9]{2,3}$" },
        "firstEndpoint": { "$ref": "#/$defs/swapEndpoint" }
      },
      "additionalProperties": false
    }
  }
}