// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System;
using System.Diagnostics.CodeAnalysis;
using Microsoft.Shared.DiagnosticIds;
 
namespace Microsoft.Extensions.AI;
 
/// <summary>Provides metadata about an <see cref="ISpeechToTextClient"/>.</summary>
[Experimental(DiagnosticIds.Experiments.AISpeechToText, UrlFormat = DiagnosticIds.UrlFormat)]
public class SpeechToTextClientMetadata
{
    /// <summary>Initializes a new instance of the <see cref="SpeechToTextClientMetadata"/> class.</summary>
    /// <param name="providerName">
    /// The name of the speech to text  provider, if applicable. Where possible, this should map to the
    /// appropriate name defined in the OpenTelemetry Semantic Conventions for Generative AI systems.
    /// </param>
    /// <param name="providerUri">The URL for accessing the speech to text  provider, if applicable.</param>
    /// <param name="defaultModelId">The ID of the speech to text used by default, if applicable.</param>
    public SpeechToTextClientMetadata(string? providerName = null, Uri? providerUri = null, string? defaultModelId = null)
    {
        DefaultModelId = defaultModelId;
        ProviderName = providerName;
        ProviderUri = providerUri;
    }
 
    /// <summary>Gets the name of the speech to text provider.</summary>
    /// <remarks>
    /// Where possible, this maps to the appropriate name defined in the
    /// OpenTelemetry Semantic Conventions for Generative AI systems.
    /// </remarks>
    public string? ProviderName { get; }
 
    /// <summary>Gets the URL for accessing the speech to text provider.</summary>
    public Uri? ProviderUri { get; }
 
    /// <summary>Gets the ID of the default model used by this speech to text client.</summary>
    /// <remarks>
    /// This value can be null if either the name is unknown or there are multiple possible models associated with this instance.
    /// An individual request may override this value via <see cref="SpeechToTextOptions.ModelId"/>.
    /// </remarks>
    public string? DefaultModelId { get; }
}