var activeMods = serviceProvider.GetRequiredService<IActiveModsService>();

ActiveModInfo info = await activeMods.GetActiveModsAsync(dotaPath);

Console.WriteLine($"Total mods: {info.TotalModCount}");
Console.WriteLine($"Status: {info.OverallStatus}");   // Ready, NotInstalled, Error
Console.WriteLine($"Has mods: {info.HasActiveMods}");
Console.WriteLine($"Generated: {info.LastGeneratedAt}");

// List hero cosmetic sets
foreach (var hero in info.HeroMods)
    Console.WriteLine($"  Hero: {hero.HeroId} -> {hero.SetName} ({hero.InstalledFiles.Count} files)");

// List misc mods (weather, HUD, terrain)
foreach (var misc in info.MiscMods)
    Console.WriteLine($"  {misc.Category}: {misc.SelectedChoice} ({misc.InstalledFiles.Count} files)");

IReadOnlyList<string> categories = info.GetActiveCategories();
// Returns: ["Hero", "Weather", "HUD", "Terrain"]

var antiMage = await activeMods.GetActiveHeroModAsync(dotaPath, "npc_dota_hero_antimage");
if (antiMage != null)
    Console.WriteLine($"Anti-Mage: {antiMage.SetName}");

var weather = await activeMods.GetActiveMiscModAsync(dotaPath, "Weather");
if (weather != null)
    Console.WriteLine($"Weather: {weather.SelectedChoice}");

IReadOnlyList<ActiveHeroMod> heroes = await activeMods.GetActiveHeroModsAsync(dotaPath);

IReadOnlyList<ActiveMiscMod> misc = await activeMods.GetActiveMiscModsAsync(dotaPath);

public record ActiveModInfo
{
    public ModStatus OverallStatus { get; init; }          // Ready, NotInstalled, Error, NotChecked
    public IReadOnlyList<ActiveHeroMod> HeroMods { get; init; }
    public IReadOnlyList<ActiveMiscMod> MiscMods { get; init; }
    public int TotalModCount { get; }                      // HeroMods.Count + MiscMods.Count
    public bool HasActiveMods { get; }                     // TotalModCount > 0
    public DateTime? LastGeneratedAt { get; init; }
    public IReadOnlyList<string> GetActiveCategories();    // Distinct active categories
}

public record ActiveHeroMod
{
    public string HeroId { get; init; }           // "npc_dota_hero_antimage"
    public string SetName { get; init; }          // "Mage Slayer"
    public IReadOnlyList<string> InstalledFiles { get; init; }
}

public record ActiveMiscMod
{
    public string Category { get; init; }          // "Weather", "HUD", "Terrain"
    public string SelectedChoice { get; init; }    // "Rain", "Immortal Gardens"
    public IReadOnlyList<string> InstalledFiles { get; init; }
}