using SVSim.BattleNode.Bridge;

namespace SVSim.EmulatedEntrypoint.Matching;

/// <summary>
/// Picks a bot opponent for an incoming AI rank battle. Used by
/// <c>RankBattleController.AiStart</c> to compose <c>oppo_info</c>.
/// </summary>
/// <remarks>
/// Backed by the <c>BotRoster</c> table (seeded from
/// <c>SVSim.Bootstrap/Data/seeds/bot-roster.json</c>). Edit the seed + re-run
/// <c>SVSim.Bootstrap</c> to change the pool without recompiling.
/// </remarks>
public interface IBotRoster
{
    /// <summary>
    /// Returns a bot profile for the calling viewer. Deterministic per
    /// <see cref="MatchContext"/> — the same context value returns the same bot, so a
    /// mid-flight retry of <c>/ai_&lt;fmt&gt;/start</c> picks the same opponent.
    /// </summary>
    Task<AIBotProfile> PickAsync(MatchContext selfCtx, CancellationToken ct = default);
}