haive.games.fox_and_geese.generic_engines¶

Generic FoxAndGeese engine creation using the generic player agent system.

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

Classes¶

FoxAndGeeseEngineFactory

Factory for creating FoxAndGeese game engines.

FoxAndGeesePlayerIdentifiers

Player identifiers for FoxAndGeese game.

FoxAndGeesePromptGenerator

Prompt generator for FoxAndGeese game.

Functions¶

create_advanced_fox_and_geese_engines(**kwargs)

Create advanced FoxAndGeese engines with high-powered models.

create_budget_fox_and_geese_engines(**kwargs)

Create budget-friendly FoxAndGeese engines.

create_generic_fox_and_geese_config_from_example(...)

Create FoxAndGeese engines from a predefined example configuration.

create_generic_fox_and_geese_engines(player_configs)

Create FoxAndGeese engines from detailed player configurations.

create_generic_fox_and_geese_engines_simple(fox_model, ...)

Create FoxAndGeese engines with simple model specifications.

create_mixed_fox_and_geese_engines(**kwargs)

Create mixed-provider FoxAndGeese engines.

Module Contents¶

class haive.games.fox_and_geese.generic_engines.FoxAndGeeseEngineFactory¶

Bases: haive.games.core.agent.generic_player_agent.GenericGameEngineFactory[str, str]

Factory for creating FoxAndGeese game engines.

Init .

get_structured_output_model(role)¶

Get the structured output model for a specific role.

Parameters:

role (str)

Return type:

type

class haive.games.fox_and_geese.generic_engines.FoxAndGeesePlayerIdentifiers¶

Bases: haive.games.core.agent.generic_player_agent.GamePlayerIdentifiers[str, str]

Player identifiers for FoxAndGeese game.

Init .

class haive.games.fox_and_geese.generic_engines.FoxAndGeesePromptGenerator(players)¶

Bases: haive.games.core.agent.generic_player_agent.GenericPromptGenerator[str, str]

Prompt generator for FoxAndGeese game.

Init .

Parameters:

players (GamePlayerIdentifiers[PlayerType, PlayerType2]) – [TODO: Add description]

create_analyzer_prompt(player)¶

Create analysis prompt for FoxAndGeese game state.

Parameters:

player (str)

Return type:

langchain_core.prompts.ChatPromptTemplate

create_move_prompt(player)¶

Create move prompt for FoxAndGeese player.

Parameters:

player (str)

Return type:

langchain_core.prompts.ChatPromptTemplate

haive.games.fox_and_geese.generic_engines.create_advanced_fox_and_geese_engines(**kwargs)¶

Create advanced FoxAndGeese engines with high-powered models.

Return type:

dict[str, haive.core.engine.aug_llm.AugLLMConfig]

haive.games.fox_and_geese.generic_engines.create_budget_fox_and_geese_engines(**kwargs)¶

Create budget-friendly FoxAndGeese engines.

Return type:

dict[str, haive.core.engine.aug_llm.AugLLMConfig]

haive.games.fox_and_geese.generic_engines.create_generic_fox_and_geese_config_from_example(example_name, temperature=0.3)¶

Create FoxAndGeese engines from a predefined example configuration.

Parameters:

  • example_name (str) – Name of the example configuration

  • temperature (float) – Generation temperature

Returns:

Dictionary of FoxAndGeese engines

Return type:

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

  • “advanced”: High-powered models for strategic gameplay

haive.games.fox_and_geese.generic_engines.create_generic_fox_and_geese_engines(player_configs)¶

Create FoxAndGeese engines from detailed player configurations.

Parameters:

player_configs (dict[str, haive.games.core.agent.player_agent.PlayerAgentConfig]) – Dictionary mapping role names to player configurations

Returns:

Dictionary of FoxAndGeese engines

Return type:

Dict[str, AugLLMConfig]

Expected roles:

  • “fox_player”: Player 1 configuration

  • “geese_player”: Player 2 configuration

  • “fox_analyzer”: Player 1 analyzer configuration

  • “geese_analyzer”: Player 2 analyzer configuration

haive.games.fox_and_geese.generic_engines.create_generic_fox_and_geese_engines_simple(fox_model, geese_model, temperature=0.3)¶

Create FoxAndGeese engines with simple model specifications.

Parameters:

  • fox_model (str) – Model for fox and analyzer

  • geese_model (str) – Model for geese and analyzer

  • temperature (float) – Generation temperature

Returns:

Dictionary of FoxAndGeese engines

Return type:

Dict[str, AugLLMConfig]

haive.games.fox_and_geese.generic_engines.create_mixed_fox_and_geese_engines(**kwargs)¶

Create mixed-provider FoxAndGeese engines.

Return type:

dict[str, haive.core.engine.aug_llm.AugLLMConfig]