Show & Tell

Reviewed 1d ago.

• tools: 5 tools scanned
• metadata: scanned

No findings.

Tools (5)

• start_round

  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.

• submit_guess

  Lock in exactly one single-word guess for the user's newest photo, or for the hint they just spent, based on all of today's photos together. First describe the photo to the user in one sentence (after a hint, say what it changes). One guess per new photo or hint: otherwise 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.

• call_foul

  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.

• use_lifeline

  Use this only when the user asks for a hint. Reveals the word's category (after the first photo), its length (after 2 shots), or its first letter (after 4 shots). A hint is a shot of its own: right after it, call submit_guess with your guess, using every photo so far plus the hint; no new photo needed. One hint per shot. Each hint adds a 💡 to the user's share grid, and solving with no hints is the brag.

• get_status

  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.