turn
Manage a Civilization V seat: check status or briefing, run queued actions, end the current round, and wait until play returns to you.
Instructions
The clock: my seat's turn loop, one action per call.
Actions:
status -- whose turn it is, the gate (answer it before anything else), what blocks the end. Read-only.
briefing -- my turn in one read: decisions with their actions rows, changes, board, threats, notes.
finish -- run actions as a batch, end my turn, wait until it is mine again, return the new turn.
end -- end the turn only, no wait.
wait -- block until it is my turn again.
Arguments by action: since, limit and detail belong to briefing (since='turn' after a context reset; detail='digest' is the event digest alone); actions and notes to finish; timeout_seconds to finish and wait; args (skip_quiet_turns, wake_on, autosave, force, briefing) to finish and end.
Side effects: finish and end hand the game to the other players, and nothing they do can be undone -- order and answer everything first; a session save is the way back. finish autosaves to the quick-save slot. A refused row in actions stops the batch and the turn is not ended. Safe to repeat: when it is not my turn, finish only waits. A second client of my seat is refused with turn_claim (args.force takes the turn over).
Timeouts: past timeout_seconds (600 by default) the reply says my_turn false, timed_out true and next is the call that resumes the wait; progress notifications go out every 5 s meanwhile, so one long call beats several short ones.
Not this tool: question / answer for what the game asks (nothing ends while gate is set); state for the board; batch for orders that leave the turn open; session for saves.
Returns: turn, my_turn, gate, todo / decisions, digest (what happened meanwhile), notes; game_over with victory / defeat at the end. A refusal is {ok: false, err, end_turn: {todo, skip_actions}}: what blocks the turn and the rows that clear it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "turn"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | finish / end only, by name: skip_quiet_turns (a count: keep ending turns, up to N more, while nothing needs you), wake_on (words that stop a quiet run), autosave (default true), force (take the turn over from another client of my seat), briefing (finish: the new turn as a briefing) | |
| limit | No | briefing: rows per list of changes and notes (default 8) | |
| notes | No | finish: which notebook notes ride on the reply, 'new' (default) or 'all' | |
| since | No | briefing: 'previous' (default) compares with my last briefing, 'turn' with the last turn end (after a context reset) | |
| action | Yes | status | briefing | finish | end | wait | |
| detail | No | briefing: 'compact' (default) or 'digest' (the event digest alone) | |
| actions | No | finish only: order rows to run before the turn ends, [{tool, args}] as the reads hand them back | |
| timeout_seconds | No | finish / wait: seconds to wait for my turn before answering with the state so far (default 600) |