haive.games.clue.controller
===========================

.. py:module:: haive.games.clue.controller

.. autoapi-nested-parse::

   Controller for the Clue game.

   This module provides the game controller that manages the state and flow of the Clue
   game.



Classes
-------

.. autoapisummary::

   haive.games.clue.controller.ClueGameController
   haive.games.clue.controller.ClueGameState
   haive.games.clue.controller.CluePlayer


Module Contents
---------------

.. py:class:: ClueGameController(player_names, max_turns = 20)

   Controller for the Clue game.

   Initialize a new Clue game.

   :param player_names: Names of the players
   :param max_turns: Maximum number of turns before the game ends


   .. py:method:: generate_ai_analysis(player_idx)
      :async:


      Generate an analysis using the player's AI analysis engine.

      :param player_idx: Index of the AI player

      :returns: The generated analysis



   .. py:method:: generate_ai_guess(player_idx)
      :async:


      Generate a guess using the player's AI engine.

      :param player_idx: Index of the AI player

      :returns: The generated guess



   .. py:method:: generate_board_string()

      Generate a string representation of the game board.



   .. py:method:: get_game_state()

      Get the current game state.



   .. py:method:: get_player_view(player_idx)

      Get the game state from a specific player's point of view.

      :param player_idx: Index of the player

      :returns: A dictionary with the game state visible to the player



   .. py:method:: make_guess(player_idx, guess)

      Process a player's guess and return the response.

      :param player_idx: Index of the player making the guess
      :param guess: The guess made by the player

      :returns: A response indicating whether the guess was correct or which player refuted it



.. py:class:: ClueGameState

   Represents the state of a Clue game.


.. py:class:: CluePlayer

   Represents a player in the Clue game.