tools.game_turn module

GameGirl Color – Structured choice submission tool.

The LLM calls this tool to submit interactive choices for the current game turn. This bypasses fragile regex parsing by having the model output choices as structured data that gets converted directly into Discord buttons.

In multiplayer, the LLM calls this tool ONCE per player (each call tagged with player_name). Calls ACCUMULATE until the response pipeline consumes them.

# 💀🔥 THE BUTTON IS A CONTRACT. THE MODEL JUST DREAMS THE LABEL.

async tools.game_turn.run(choices, player_name='', ctx=None)[source]

Store structured choices for the response pipeline to render.

In multiplayer, each call APPENDS a player’s choice block to the Redis list. The response pipeline reads ALL accumulated blocks and builds a combined view.

Return type:

str

Parameters:

choices (list[dict[str, str]])
player_name (str)
ctx (ToolContext | None)