// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Text.Json;
using System.Text.Json.Serialization;
 
namespace Aspire.Cli.Agents.AspireSkills;
 
/// <summary>
/// Describes a published Aspire skills bundle.
/// </summary>
internal sealed class SkillBundleManifest
{
    public string? Version { get; init; }
 
    public SkillBundleSupports? Supports { get; init; }
 
    public SkillBundleSkill?[] Skills { get; init; } = [];
}
 
/// <summary>
/// Describes the Aspire versions supported by a skills bundle.
/// </summary>
internal sealed class SkillBundleSupports
{
    public string? AspireCli { get; init; }
 
    public string? AspireSdk { get; init; }
}
 
/// <summary>
/// Describes a single skill in an Aspire skills bundle.
/// </summary>
internal sealed class SkillBundleSkill
{
    public string? Name { get; init; }
 
    public string? Description { get; init; }
 
    public string[] ApplicableLanguages { get; init; } = [];
 
    public string[] InstallExcludedRelativePaths { get; init; } = [];
 
    public SkillBundleFile?[] Files { get; init; } = [];
}
 
/// <summary>
/// Describes a single file in an Aspire skills bundle.
/// </summary>
internal sealed class SkillBundleFile
{
    public string? RelativePath { get; init; }
 
    // Lowercase hex SHA-512 of the file contents (preferred), read from `skill-manifest.json` inside the
    // bundle archive (an optional `sha512-` SRI-style prefix is tolerated). Emitted per-file by current
    // microsoft/aspire-skills' build-aspire-bundles.mjs and verified by AspireSkillsBundleProvider.
    public string? Sha512 { get; init; }
 
    // Lowercase hex SHA-256 of the file contents, accepted only for bundles published before the SHA-512
    // switch — notably the attestation-verified v0.0.1 snapshot currently embedded in the CLI, whose bytes
    // cannot be re-hashed without breaking their published attestation. When both are present SHA-512 wins;
    // an optional `sha256-` SRI-style prefix is tolerated. New/remote bundles emit `Sha512` and this is null.
    public string? Sha256 { get; init; }
}
 
/// <summary>
/// Describes the Aspire skills bundle archive embedded in the CLI.
/// </summary>
internal sealed class EmbeddedAspireSkillsBundleMetadata
{
    public string? Version { get; init; }
 
    public string? Repository { get; init; }
 
    public string? Tag { get; init; }
 
    public string? AssetName { get; init; }
 
    // Lowercase hex SHA-512 of the embedded `.tgz` archive; verified by AspireSkillsInstaller before extraction.
    public string? Sha512 { get; init; }
}
 
/// <summary>
/// Source-generation context for Aspire skills bundle JSON.
/// </summary>
[JsonSourceGenerationOptions(
    AllowTrailingCommas = true,
    ReadCommentHandling = JsonCommentHandling.Skip,
    PropertyNamingPolicy = JsonKnownNamingPolicy.CamelCase,
    PropertyNameCaseInsensitive = true)]
[JsonSerializable(typeof(SkillBundleManifest))]
[JsonSerializable(typeof(EmbeddedAspireSkillsBundleMetadata))]
internal sealed partial class AspireSkillsJsonSerializerContext : JsonSerializerContext
{
}