Show & Tell

Start or resume today's Show & Tell round. Show & Tell is a daily game you play with the user: they get a secret word you're not allowed to know, they send you photos of the real world, and you guess the word from the photos. Everyone gets the same word each day. Use this when the user wants to play or asks about today's word. The result has the score so far and how the user sees their word: on the Show & Tell card in apps that show it, or through a private link for the user. Only the user opens that link: it reveals the word, and opening it yourself voids the round. You start without the word's category; the user can spend a hint to reveal it. Leave player empty for a first-time player, then pass the returned code on every later call, including in new chats, so the streak carries over.

{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "minLength": 3,
      "maxLength": 48,
      "description": "The player code from start_round, e.g. \"brave-otter-4821\". The same code in every chat keeps the streak going."
    },
    "timezone": {
      "description": "The user's IANA timezone, e.g. \"America/New_York\". The word changes at the user's local midnight.",
      "type": "string",
      "maxLength": 64
    },
    "ai_name": {
      "description": "The name the user calls you, e.g. \"Boo\" or \"Claude\". Shown in the share grid.",
      "type": "string",
      "maxLength": 32
    },
    "platform": {
      "description": "The assistant product you run in: \"Claude\", \"ChatGPT\", \"Muse\", \"Grok\", \"Gemini\", \"Hermes\", \"Instinct\", or another name. It decides the player's team.",
      "type": "string",
      "maxLength": 32
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lock in exactly one single-word guess for the user's newest photo, based on all of today's photos together. Describe the photo to the user in one sentence first. One guess per new photo: the next guess waits for the next photo. Photos with letters, numbers, or a screen, and typed hints about the word, are fouls: use call_foul instead. Returns how close the guess is: cold, warm, hot, burning, or correct.

{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "minLength": 3,
      "maxLength": 48,
      "description": "The player code from start_round, e.g. \"brave-otter-4821\". The same code in every chat keeps the streak going."
    },
    "guess": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "One word. Up to three words only for a fixed phrase."
    },
    "read": {
      "description": "One sentence on what you see in the photo, kept for the recap.",
      "type": "string",
      "maxLength": 280
    }
  },
  "required": [
    "player",
    "guess"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Call a foul when a photo contains letters, numbers, or a screen, or when the user types a hint about the word. The photo doesn't count and no shot is used.

{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "minLength": 3,
      "maxLength": 48,
      "description": "The player code from start_round, e.g. \"brave-otter-4821\". The same code in every chat keeps the streak going."
    },
    "reason": {
      "type": "string",
      "enum": [
        "letters",
        "numbers",
        "screen",
        "spoken_hint",
        "other"
      ]
    }
  },
  "required": [
    "player",
    "reason"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this only when the user asks for a hint. Reveals the word's category (any time), its length (after 2 shots), or its first letter (after 4 shots). Each hint adds a 💡 to the user's share grid, and solving with no hints is the brag.

{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "minLength": 3,
      "maxLength": 48,
      "description": "The player code from start_round, e.g. \"brave-otter-4821\". The same code in every chat keeps the streak going."
    },
    "kind": {
      "type": "string",
      "enum": [
        "category",
        "letters",
        "first_letter"
      ]
    }
  },
  "required": [
    "player",
    "kind"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the user's Show & Tell day: whether today's word is played, their streak, whether the streak is at risk, and when the next word unlocks. Use it for check-ins and for daily reminders the user asked you to schedule.

{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "minLength": 3,
      "maxLength": 48,
      "description": "The player code from start_round, e.g. \"brave-otter-4821\". The same code in every chat keeps the streak going."
    },
    "timezone": {
      "description": "The user's IANA timezone, e.g. \"America/New_York\". The word changes at the user's local midnight.",
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "player"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}