haive.games.mafia.config
========================

.. py:module:: haive.games.mafia.config

.. autoapi-nested-parse::

   Configuration for the Mafia game agent.

   This module provides configuration classes and utilities for the Mafia game
   agent, including:
       - Game settings (max days, discussion rounds)
       - LLM engine configurations
       - Role mappings and assignments
       - Debug settings

   .. rubric:: Example

   >>> from mafia.config import MafiaAgentConfig
   >>>
   >>> # Create a default configuration for 7 players
   >>> config = MafiaAgentConfig.default_config(
   ...     player_count=7,
   ...     max_days=3
   ... )
   >>> print(config.max_days)  # Shows 3



Classes
-------

.. autoapisummary::

   haive.games.mafia.config.MafiaAgentConfig


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

.. py:class:: MafiaAgentConfig

   Bases: :py:obj:`haive.games.framework.multi_player.config.MultiPlayerGameConfig`


   Configuration for the Mafia game agent.

   This class extends MultiPlayerGameConfig to provide Mafia-specific
   configuration options and defaults.

   .. attribute:: max_days

      Maximum number of days before forcing game end

      :type: int

   .. attribute:: day_discussion_rounds

      Number of discussion rounds per day

      :type: int

   .. attribute:: engines

      LLM configs by role

      :type: Dict[str, Dict[str, AugLLMConfig]]

   .. attribute:: state_schema

      State schema for the game

      :type: Type[MafiaGameState]

   .. attribute:: role_mapping

      Engine key to role mapping

      :type: Dict[str, PlayerRole]

   .. attribute:: debug

      Enable debug mode for detailed logging

      :type: bool

   .. rubric:: Example

   >>> config = MafiaAgentConfig(
   ...     name="mafia_game",
   ...     max_days=3,
   ...     engines=aug_llm_configs,
   ...     initial_player_count=7
   ... )
   >>> print(config.max_days)  # Shows 3


   .. py:method:: default_config(player_count = 7, max_days = 3)
      :classmethod:


      Create a default configuration for a Mafia game.

      This method creates a standard configuration with appropriate role
      mappings and engine configurations for the specified number of players.

      :param player_count: Number of players including narrator.
                           Defaults to 7.
      :type player_count: int, optional
      :param max_days: Maximum number of days before forcing
                       game end. Defaults to 3.
      :type max_days: int, optional

      :returns: Configured agent ready for game initialization
      :rtype: MafiaAgentConfig

      .. rubric:: Example

      >>> config = MafiaAgentConfig.default_config(
      ...     player_count=9,
      ...     max_days=4
      ... )
      >>> print(len(config.role_mapping))  # Shows 5 (all roles)