haive.games.monopoly.generic_engines
====================================

.. py:module:: haive.games.monopoly.generic_engines

.. autoapi-nested-parse::

   Generic Monopoly engine creation using the generic player agent system.

   This module provides generic engine creation functions for Monopoly games, allowing for
   configurable LLM models and game-specific player identifiers.



Classes
-------

.. autoapisummary::

   haive.games.monopoly.generic_engines.MonopolyEngineFactory
   haive.games.monopoly.generic_engines.MonopolyPlayerIdentifiers
   haive.games.monopoly.generic_engines.MonopolyPromptGenerator


Functions
---------

.. autoapisummary::

   haive.games.monopoly.generic_engines.create_budget_monopoly_engines
   haive.games.monopoly.generic_engines.create_generic_monopoly_config_from_example
   haive.games.monopoly.generic_engines.create_generic_monopoly_engines
   haive.games.monopoly.generic_engines.create_generic_monopoly_engines_simple
   haive.games.monopoly.generic_engines.create_mixed_monopoly_engines
   haive.games.monopoly.generic_engines.create_property_tycoon_monopoly_engines
   haive.games.monopoly.generic_engines.create_real_estate_mogul_monopoly_engines


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

.. py:class:: MonopolyEngineFactory

   Bases: :py:obj:`haive.games.core.agent.generic_player_agent.GenericGameEngineFactory`\ [\ :py:obj:`str`\ , :py:obj:`str`\ ]


   Factory for creating Monopoly game engines.

   Init  .

   :returns: Add return description]
   :rtype: [TODO


   .. py:method:: get_structured_output_model(role)

      Get the structured output model for a specific role.



.. py:class:: MonopolyPlayerIdentifiers

   Bases: :py:obj:`haive.games.core.agent.generic_player_agent.GamePlayerIdentifiers`\ [\ :py:obj:`str`\ , :py:obj:`str`\ ]


   Player identifiers for Monopoly game.

   Init  .

   :returns: Add return description]
   :rtype: [TODO


.. py:class:: MonopolyPromptGenerator(players)

   Bases: :py:obj:`haive.games.core.agent.generic_player_agent.GenericPromptGenerator`\ [\ :py:obj:`str`\ , :py:obj:`str`\ ]


   Prompt generator for Monopoly game.

   Init  .

   :param players: [TODO: Add description]


   .. py:method:: create_analysis_prompt(player)

      Create analysis prompt - alias for create_analyzer_prompt.



   .. py:method:: create_analyzer_prompt(player)

      Create analysis prompt for Monopoly game state.



   .. py:method:: create_move_prompt(player)

      Create move prompt for Monopoly player.



   .. py:method:: get_analysis_output_model(role)

      Get analysis output model.



   .. py:method:: get_move_output_model(role)

      Get move output model.



.. py:function:: create_budget_monopoly_engines(**kwargs)

   Create budget-friendly Monopoly engines.


.. py:function:: create_generic_monopoly_config_from_example(example_name, temperature = 0.3)

   Create Monopoly engines from a predefined example configuration.

   :param example_name: Name of the example configuration
   :param temperature: Generation temperature

   :returns: Dictionary of Monopoly engines
   :rtype: Dict[str, AugLLMConfig]

   Available examples:
       - "gpt_vs_claude": GPT vs Claude
       - "gpt_only": GPT for both players
       - "claude_only": Claude for both players
       - "budget": Cost-effective models
       - "mixed": Different provider per role
       - "real_estate_moguls": High-powered models for strategic gameplay
       - "property_tycoons": Specialized for property investment



.. py:function:: create_generic_monopoly_engines(player_configs)

   Create Monopoly engines from detailed player configurations.

   :param player_configs: Dictionary mapping role names to player configurations

   :returns: Dictionary of Monopoly engines
   :rtype: Dict[str, AugLLMConfig]

   Expected roles:
       - "player1_player": Player 1 configuration
       - "player2_player": Player 2 configuration
       - "player1_analyzer": Player 1 analyzer configuration
       - "player2_analyzer": Player 2 analyzer configuration



.. py:function:: create_generic_monopoly_engines_simple(player1_model, player2_model, temperature = 0.3)

   Create Monopoly engines with simple model specifications.

   :param player1_model: Model for player 1 and analyzer
   :param player2_model: Model for player 2 and analyzer
   :param temperature: Generation temperature

   :returns: Dictionary of Monopoly engines
   :rtype: Dict[str, AugLLMConfig]


.. py:function:: create_mixed_monopoly_engines(**kwargs)

   Create mixed-provider Monopoly engines.


.. py:function:: create_property_tycoon_monopoly_engines(**kwargs)

   Create property tycoon-style Monopoly engines.


.. py:function:: create_real_estate_mogul_monopoly_engines(**kwargs)

   Create real estate mogul-style Monopoly engines with high-powered models.