Words With Attitude

Use this when someone wants to play today's Words With Attitude puzzle: guess a hidden cheeky word (a mild British insult or a grim weather word) in six tries. Returns the puzzle number, the word length and an empty board, never the answer. Pass the player's time zone when it is known so the puzzle follows their local date; without it the puzzle follows the UTC date. After this, each word the player guesses is checked with submit_guess.

{
  "type": "object",
  "properties": {
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "The player's IANA time zone, for example \"Europe/London\" or \"America/New_York\". Picks the puzzle for their local date. Omit if unknown."
    },
    "utc_offset_minutes": {
      "type": "integer",
      "minimum": -720,
      "maximum": 840,
      "description": "The player's UTC offset in minutes (60 for UTC+1, -300 for UTC-5), used only when the time zone is unknown. Omit both to use UTC."
    },
    "conversation_id": {
      "type": "string",
      "maxLength": 44,
      "description": "Set by the Words card so its moves count in the same anonymous usage stats as the chat. Leave it out."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this for each word the player guesses in a Words With Attitude puzzle started with start_daily_puzzle. Send the puzzle number, every earlier guess in this game in order, and the new guess. Returns every guess marked letter by letter (right letter in the right place, right letter in the wrong place, or not in the word) and a short comment on the guess. A guess has to be letters only and the same length as the answer; a guess that is not is returned with a reason and does not count. The answer is returned only when the game ends: a correct guess or the sixth miss. Nothing is stored on the server.

{
  "type": "object",
  "properties": {
    "puzzle_number": {
      "type": "integer",
      "minimum": 1,
      "description": "The puzzle number returned by start_daily_puzzle."
    },
    "previous_guesses": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 32
      },
      "maxItems": 6,
      "description": "Every earlier guess in this game, oldest first. Empty or omitted before the first guess."
    },
    "guess": {
      "type": "string",
      "maxLength": 32,
      "description": "The word the player just guessed. Letters only; spaces are ignored."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "The player's IANA time zone, for example \"Europe/London\" or \"America/New_York\". Picks the puzzle for their local date. Omit if unknown."
    },
    "utc_offset_minutes": {
      "type": "integer",
      "minimum": -720,
      "maximum": 840,
      "description": "The player's UTC offset in minutes (60 for UTC+1, -300 for UTC-5), used only when the time zone is unknown. Omit both to use UTC."
    },
    "conversation_id": {
      "type": "string",
      "maxLength": 44,
      "description": "Set by the Words card so its moves count in the same anonymous usage stats as the chat. Leave it out."
    }
  },
  "required": [
    "puzzle_number",
    "guess"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this only when the player asks to give up on a Words With Attitude puzzle. Ends the game as a loss and returns the answer, the board and a spoiler-free share grid. Send the puzzle number and every guess made so far.

{
  "type": "object",
  "properties": {
    "puzzle_number": {
      "type": "integer",
      "minimum": 1,
      "description": "The puzzle number returned by start_daily_puzzle."
    },
    "previous_guesses": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 32
      },
      "maxItems": 6,
      "description": "Every earlier guess in this game, oldest first. Empty or omitted before the first guess."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "The player's IANA time zone, for example \"Europe/London\" or \"America/New_York\". Picks the puzzle for their local date. Omit if unknown."
    },
    "utc_offset_minutes": {
      "type": "integer",
      "minimum": -720,
      "maximum": 840,
      "description": "The player's UTC offset in minutes (60 for UTC+1, -300 for UTC-5), used only when the time zone is unknown. Omit both to use UTC."
    },
    "conversation_id": {
      "type": "string",
      "maxLength": 44,
      "description": "Set by the Words card so its moves count in the same anonymous usage stats as the chat. Leave it out."
    }
  },
  "required": [
    "puzzle_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Used only by the Words card, never by the model, to record that a result was shared or a link was opened. Anonymous: no guesses, answer, location or account identifier.

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "enum": [
        "connector_card_rendered",
        "connector_link_clicked",
        "puzzle_shared"
      ]
    },
    "tool": {
      "type": "string",
      "enum": [
        "start_daily_puzzle",
        "submit_guess",
        "give_up"
      ]
    },
    "conversation_id": {
      "type": "string",
      "maxLength": 44
    },
    "attitude_level": {
      "not": {}
    },
    "link": {
      "type": "string",
      "enum": [
        "open_site",
        "share"
      ]
    },
    "puzzle_number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    }
  },
  "required": [
    "event",
    "tool"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}