Return game instance associated to given power name.

Get lowest value in sorted set greater than given element, or None if such values does not exists in the sorted set. Given element may no

Get greatest value in sorted set less the given element, or None if such value does not exists in the sorted set. Given element may not e

Return True if this game is a player game.

Adds a formatted entry string to the agent's private journal.

Retrieves the list of units for a power or for all powers :param power_name: Optional. The name of the power (e.g. ``'FRANCE'``) or None

Builds the response

Constructor

Finds the occupant of a site :param site: The site name (e.g. "STP") :param any_coast: Boolean to indicate to return unit on

Adds a rule to the current rule list :param rule: Name of rule to add (e.g. 'NO_PRESS') :return: Nothing

Clears the power's orders :param power_name: Optional. The name of the power to clear (e.g. 'FRANCE') or will clear orders for

Returns the zobrist hash for the current game

Get the appropriate prompt path based on USE_UNFORMATTED_PROMPTS setting. Args: prompt_name: Base name of the prompt file (e.g., "convers

Removes ownership of supply centers :param power_name: Optional. The name of the power whose centers will be cleared (e.g. 'FRANCE'),

Retrieves the list of owned supply centers for a power or for all powers :param power_name: Optional. The name of the power (e.g. 'FRANC

Returns a list or a dict representing the order status ('', 'no convoy', 'bounce', 'void', 'cut', 'dislodged', 'disrupted') for orders su

Convert this object to a JSON string ready to be sent/saved. :return: string

Returns the next timestamp at a specific 'hh:mm' :param timestamp: The unix timestamp to convert :param time_at: The next 'hh:mm' to

Truncates time at a specific interval (e.g. 20M) (i.e. Rounds to the next :20, :40, :60) :param timestamp: The unix epoch to truncate (e.g.

Returns the adjacency list for the site :param site: The province we want the adjacency list for :param incl_no_coast: Boole

Clears all caches

* Start the event queue with current time as reference

Compute coordinates of unit center. :param loc: unit location :param is_dislodged: boolean to tell if unit is dislodged

Return the number of controlled map powers.

Return a filtered version of given phase data for given gam role. :param phase_data: GamePhaseData object to filter. :param

Returns the full unit string (e.g., 'A PAR (FRA)') if a unit is at the location, else None.

Notify addresses of a game with a notification. Game ID is automatically provided to notification. Token and game role are au

Calls `client.generate_response` with robust retry logic and returns the raw output. This function handles exceptions gracefully: - It r

Transfers supply centers ownership :param power_name: The name of the power who will control the supply centers (e.g. 'FRANCE')

Set game status with given status (should be in diplomacy.utils.strings.ALL_GAME_STATUSES).

Register a notification to send. :param notification: a notification instance. :type notification: notifications._AbstractNo

Checks that expect == computed.

Check if given game is not yet completed or canceled, otherwise raise a GameFinishedException. :param server_game: server game to check

Return a function to build sorted sets from content (sequence of values). Returned function expects a content parameter like SortedSet in

* Helper function to get a DOM element by ID and throw an error if not found * @param id The element ID to search for * @returns The HTMLElement *

Return True if users have given token.

Return True if given power name is currently controlled. :param power_name: power name :type power_name: str :rt

(for server game) Return True if given power name is controlled by given username.

Normalise a sentence (add spaces before /, replace -+, with ' ', remove .: :param phrase: Phrase to normalise :return: Norma

* Return a dictionary of local orders for given game engine. * Returned dictionary maps each power name to either: * - a dictionary of order

Send a game notification. Game token, game ID and game role will be automatically provided to notification object. :param se

Adds a formatted entry to both the permanent and context diaries.

Drop a place :param place: Name of place to remove :return: Nothing

Returns the long name of the phase coming immediately after the phase :param phase: The long name of the current phase (e.g. SPRING 1905

* Helper function to get a typed DOM element by ID and throw an error if not found * @param id The element ID to search for * @returns The typed HTM

Return a ParserType sub-class that matches given type. :param desired_type: basic type or ParserType sub-class. :return: ParserType

Return True if game has given token (either observer, omniscient or player).

Async version of log_llm_response that runs in a thread pool.

Transfer all units, centers, and homes of the other_power to this power :param other_power: The other power (will be empty after the mer

Return True if given token is a master token for given game data. :param token: token :param server_game: game data

Determines if a unit is moving via a convoy or through land :param unit: The name of the unit (e.g. 'A PAR') :return: A bool

Returns the coast for a fleet move order that can only be to a single coast (e.g. F GRE-BUL returns F GRE-BUL/SC) :param wor

Finds all coasts for a given location :param loc: The name of a location (e.g. 'BUL') :return: Returns the list of all coast

(Network Method) Return current power controller name ('dummy' if power is not controlled).

Return the number of map powers expected to be controlled in this game. This number is either specified in settings or the number of map

Return game saved on server matching given game ID. Raise an exception if game ID not found. Return game if already loaded on

Find the location requiring an order for a power (or for all powers) :param power_name: Optionally, the name of the power (e.g. 'FRANCE'

Return True if given username is an administrator.

Return True if game has given observer token.

Return True if game has given omniscient observer token.

Get the highest key from the dict.

Normalise the name of a power (removes spaces) :param power: Name of power to normalise :return: Normalised power name