DeducePuzzles

Use this when the user wants to play today's DeducePuzzles board or a daily bank-exam arrangement puzzle. Returns a verified single-solution puzzle at medium difficulty from a daily rotation of seating, floor, box, scheduling, and ranking. Patterns follow IBPS, SBI, and RRB PO/Clerk; circular, row, box, and ranking also follow SSC. For a specific supported type, pass kind: if it is not today's type, the tool reports that limitation without starting a round. Do not use for syllogism, blood relations, quant, English, general awareness, general exam advice, product comparisons, billing or account support, or solving a puzzle supplied by the user. Not for planning real seating, seating charts, or schedules for an event, classroom, office, or exam hall. Attempts are counted per conversation, not per person. Omit attemptId to start; pass the returned attemptId and playerToken on later calls. Starting stores an anonymous round; it does not sign the user into the website.

{
  "type": "object",
  "properties": {
    "attemptId": {
      "type": "string",
      "description": "Conversation id returned by get_daily_puzzle. Attempts are counted per conversation, not per person. Pass this same id on every later call in the conversation."
    },
    "playerToken": {
      "type": "string",
      "description": "Anonymous token returned by an earlier get_daily_puzzle. Pass it back to keep this app's streak. Omit it to start a new one. Not an account, and not a website streak. 16–64 letters, digits, _ or -."
    },
    "kind": {
      "type": "string",
      "enum": [
        "floor",
        "circular",
        "scheduling",
        "row",
        "box",
        "double_row",
        "flat_floor",
        "square",
        "ranking"
      ],
      "description": "Optional requested arrangement type. This checks today's rotation; it does not generate another type. Omit for any daily board. Use row for linear seating, circular for circular seating, and ranking for order and ranking. A mismatch starts no round and returns the available kind."
    }
  },
  "additionalProperties": false
}

Use this when the user submits an order for today's DeducePuzzles board (seating, floor, box, scheduling, or order and ranking). Grades that one arrangement: right or wrong, attempts left, and whether the round is finished. A wrong guess does not say which clues it broke. The solution is included only once the round is finished. A percentile is included only when the arrangement is right, this is the player's first completed round today, the solve took at least five seconds, and at least five ranked solves of today's board exist here. A replay, a round that already saw the solution, or a solve under five seconds states no percentile. A placement exists only in this result. Do not use to grade a puzzle this server did not serve. Attempts are counted per conversation, not per person.

{
  "type": "object",
  "properties": {
    "attemptId": {
      "type": "string",
      "description": "Conversation id returned by get_daily_puzzle. Attempts are counted per conversation, not per person. Pass this same id on every later call in the conversation."
    },
    "playerToken": {
      "type": "string",
      "description": "Anonymous token returned by an earlier get_daily_puzzle. Pass it back to keep this app's streak. Omit it to start a new one. Not an account, and not a website streak. 16–64 letters, digits, _ or -."
    },
    "arrangement": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Every person from today's board exactly once, in the order the question asks. Index 0 is position 1 (lowest floor, left end of a row, rank 1, or day 1). Example: [\"Aman\", \"Beena\", \"Chetan\", \"Diya\"]."
    }
  },
  "required": [
    "attemptId",
    "arrangement"
  ],
  "additionalProperties": false
}

Use this when the user asks for a hint on today's DeducePuzzles board. Names one clue to re-read, by number only. Does not reveal a person, a seat, a floor, or a rank. Do not use for a solution or a walkthrough. Attempts are counted per conversation, not per person.

{
  "type": "object",
  "properties": {
    "attemptId": {
      "type": "string",
      "description": "Conversation id returned by get_daily_puzzle. Attempts are counted per conversation, not per person. Pass this same id on every later call in the conversation."
    },
    "playerToken": {
      "type": "string",
      "description": "Anonymous token returned by an earlier get_daily_puzzle. Pass it back to keep this app's streak. Omit it to start a new one. Not an account, and not a website streak. 16–64 letters, digits, _ or -."
    }
  },
  "required": [
    "attemptId"
  ],
  "additionalProperties": false
}