Handbook

board_game_rank_moves v1

Invariant: ranked_move_ids must be a permutation of the input legal_moves identifiers (no omissions, no extras, no duplicates).

Updated

Input: player_view, legal_moves (as in board_game_choose_move), optional ranking_criteria, temperature, timeout_sec.

Output: {ranked_move_ids: [string, ...], ranking_criteria: string} (criteria echoed).

Failure modes

  • TransportFailure — chat transport errors.
  • ParseFailure — assistant output not valid JSON.
  • SchemaFailure — input or output rejected vs contract schemas.
  • GatewayFailure — upstream/provider errors.

Verification

Task-internal validation and JSON schema checks per contract.json verification_policy.

Changelog

  • v1 — Maintained in catalog; see git history for semantic changes.