Convert MenuItem to MenuOption for GUI IPC.

Extract all text from an image as a single string. Args: image: Input image as numpy array (BGR or grayscale). Returns:

Find a single template on the screen. Args: template (str | Path): Path to the template image (relative to templa

Converts bytes to numpy array. Raises: OSError ValueError

Entry for pushing AFK Stages. Args: season: Push Season Stage if True otherwise push regular AFK Stages

Set resource dir. Expects contents to have the structure as the adb_auto_player project dir. ./games/afk_journey/templates/...

Return the settings directory.

Create or return the singleton instance of SummaryGenerator. Returns: The singleton instance of SummaryGenerator.

Claim friend rewards.

Call _parse_rankings_rows with a mock Qwen and return the crop height.

Convert a CropValue to pixels. Args: crop_value: The CropValue to convert dimension: The dimension (width or height) to calculate

Lazy-initialize the RapidOCR engine.

Generic stream handler.

Hold single D-pad axis.

Enter Dream Realm, select district rankings, scan configured dates.

Run OCR on the preprocessed popup image using the configured engine. Args: preprocess_result: The preprocessed popup screenshot d

Scan visible date tabs, optionally ignoring the current day.

Find the best matching guild member name using string similarity.

Clean up resources.

Detect text paragraphs and return results with bounding boxes. Args: image: Input RGB image as numpy array config: Op

Store log message in memory. Args: record (logging.LogRecord): The log record to store.

Find the area in the base image that is most different from the template. This function creates a difference map between the template and all

Format debug information string from log record. Args: record (logging.LogRecord): The log record Returns: s

Create a Resolution from a width x height string.

Execute the function with the given keyword arguments. Returns: Exception: The exception encountered during execution, if any. Sp

Get information about the backend. Returns: Backend information dictionary

Get display resolution and orientation. Raises: GenericAdbUnrecoverableError: Unable to determine screen resolution or

Extracts filename without extension from path. Args: filename_with_path: Filename with path. Returns: Filena

Get the most recent frame from the stream.

Get the currently running app. Returns: str | None: Currently running app name, or None if unable to determine.

Release touch at the given coordinates.

Prepare the bot for operation. Validates device resolution, starts the stream (if requested), and ensures the game is running.

Read chunks of video data.

Release any held direction on both axes.

Convert an RGB image to BGR format. Args: image (np.ndarray): Input image in RGB color format. Returns: np.n

Generate a TemplateMatchResult.

Battle Arena opponent. Returns: bool: True if battle completed, False otherwise.

Check stamina with specific crop dimensions. Args: hero_position: The template match result for the hero stamina_area

Choose Arena opponent. Returns: bool: True if opponent chosen, False otherwise.

Detect the active difficulty level. Returns: Tuple of (difficulty_name, max_stamina, max_retries)

Return the directory used for runtime-installed optional packages.

Find excluded hero templates. Args: excluded_heroes (dict[str, str]): Dictionary of excluded heroes. Returns:

Find the closest guild member match and returns (best_match, ratio).

Find and click images relating to quests.

Get menu options from commands in a specific module.

Get list of supported languages. Returns: List of supported language codes

Handles logic for battle screen. Args: use_suggested_formations: if True copy formations from Records Returns:

Return a minimal huggingface_hub module mock. Args: config_result: value returned for the config.json cache check. weights_result

Navigate through a sequence of menus by tapping each template until gone. Replaces repeated blocks of:: self._tap_till_template_

Navigate to the Guild Members list screen. 1. Tap the 'Guild' tab in the bottom navigation bar (detected by OCR). 2. Wait for the gui

Return best name from OCR observations: most frequent fuzzy cluster wins.

Crop each bbox row whose name isn't in guild_set and ask Qwen. Handles members whose name the game font renders as Latin lookalikes (

Write raw OCR frames to ocr_debug.json for troubleshooting.

Creates a 1x1 black PNG image and returns its byte representation.