Normalise a hero name/alias/shortName to its canonical identity.

Use this to turn messy user input ("am", "anti mage", "Anti-Mage") into the exact key batru.gg expects before calling the prediction tools. The backend SILENTLY DROPS hero names it doesn't recognise, so always normalise first.

Args: query: A hero name, alias, or short name. game: "dota2" (default) or "deadlock".

Returns {id, displayName, shortName, game} for the best match, or an error with did_you_mean candidates if nothing matches.

Predict the CALIBRATED win rate for a Dota 2 draft.

Backed by batru.gg's production model (trained on ~20M real matches and calibrated, so a reported 60% reflects a real ~60% empirical win rate — it is not a guess). Partial drafts are fine; an empty draft returns 50/50. Hero names are normalised internally to shortNames.

Args: my_heroes: Your team's heroes (names/aliases, 0-5). enemy_heroes: Enemy heroes (names/aliases, 0-5). my_side: "radiant" (default) or "dire" — which side is "my_heroes".

Returns calibrated win-rate percentages for both teams. Report these numbers verbatim; do not adjust them.

Recommend the top 3 Dota 2 heroes to pick next, with calibrated win rates.

Backed by batru.gg's production model. Each suggestion comes with the CALIBRATED win rate your team would have after adding that hero against the given enemy draft (a reported 60% reflects a real ~60% empirical win rate). Hero names are normalised internally.

Args: my_heroes: Heroes your team has already picked (names/aliases, 0-4). enemy_heroes: Enemy heroes (names/aliases, 0-5). my_side: "radiant" (default) or "dire" — which side is "my_heroes".

Returns a list of up to 3 {displayName, shortName, win_rate_pct}. Report the win rates verbatim.

Get the strongest matchups (counters) for a Dota 2 hero from real games.

Returns opponents this hero performs BEST and WORST against, by real observed matchup win rate (with sample sizes). This is empirical meta data from batru.gg's match aggregation, not a guess. The hero name is normalised internally.

Args: hero: The hero to look up (name/alias/shortName). limit: Max number of matchups to return (default 12).

Returns {hero, best_against:[...], worst_against:[...]} where each row has {opponent, winrate_pct, matches}. winrate_pct > 50 means hero beats that opponent. Report numbers verbatim.

Predict the CALIBRATED win probability for a Deadlock 6v6 draft.

Backed by batru.gg's Deadlock production model. Provide 6 heroes per team (names are normalised to Deadlock hero ids internally). A reported 60% reflects a real ~60% empirical win rate — it is calibrated, not a guess.

Args: team0_heroes: Team 0's 6 heroes (names/aliases). team1_heroes: Team 1's 6 heroes (names/aliases).

Returns calibrated win-rate percentages for both teams. Report verbatim.