gameplay-sql

name	gameplay-sql
description	>- Use when this capability is needed.

SQL Gameplay

Test the game through database tools.

Announce: "I'm using gameplay-sql to test via database."

Game Tools

Tool	Purpose
game_start	Start a new game
game_state	See current question/guess/candidates
game_turn	Answer yes/no/not_sure
game_submit	Submit correct place (give up)
game_find_place	Search places by name
game_summary	Review completed session (history + result)

Complete Game Flow

1. Start a Game

game_start(description: "A medieval castle on a hilltop in Poland")

Returns: session_id, initial question, top candidates

2. Check State (optional)

game_state(session_id: "abc123...")

Returns: current status, question or guess, top candidates

3. Answer Questions

game_turn(session_id: "abc123...", answer: "yes")
game_turn(session_id: "abc123...", answer: "no")
game_turn(session_id: "abc123...", answer: "not_sure")

Returns: new state after answer

4a. If Game Guesses Correctly

game_turn(session_id: "abc123...", answer: "yes")

Game ends with status: won

4b. If Game Gives Up or Guesses Wrong

First, find the correct place:

game_find_place(name: "Wawel")

Then submit it:

game_submit(session_id: "abc123...", osm_id: "way/123456")

Example Session

> game_start(description: "A famous tower in Paris")

SESSION: 7f3a2b1c-...

status   | question                          | candidate_count
---------+-----------------------------------+----------------
active   | Is this place in Western Europe?  | 15

TOP CANDIDATES:
place           | confidence
----------------+-----------
Eiffel Tower    | 45%
Notre-Dame      | 22%
Arc de Triomphe | 12%

> game_turn(session_id: "7f3a2b1c-...", answer: "yes")

status | question                    | guess
-------+-----------------------------+------
active | Is it a metal structure?    | 

TOP CANDIDATES:
place           | confidence
----------------+-----------
Eiffel Tower    | 68%
Notre-Dame      | 15%

> game_turn(session_id: "7f3a2b1c-...", answer: "yes")

status | question | guess        | guess_confidence
-------+----------+--------------+-----------------
active |          | Eiffel Tower | 89%

> game_turn(session_id: "7f3a2b1c-...", answer: "yes")

status | 
-------+
won    |

Status Values

• active - Game in progress
• won - Correct guess confirmed
• ended - Game over (gave up or max turns)

Answer Values

• yes - Confirm question or guess
• no - Deny question or guess
• not_sure - Skip question (only for questions, not guesses)

Review Completed Game

game_summary(session_id: "abc123...")

Returns: description, result (won/lost), place name, trait count, and full question history.

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.