// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System;
 
namespace Microsoft.Extensions.AI;
 
/// <summary>Provides metadata about an <see cref="IEmbeddingGenerator{TInput, TEmbedding}"/>.</summary>
public class EmbeddingGeneratorMetadata
{
    /// <summary>Initializes a new instance of the <see cref="EmbeddingGeneratorMetadata"/> class.</summary>
    /// <param name="providerName">The name of the embedding generation provider, if applicable.</param>
    /// <param name="providerUri">The URL for accessing the embedding generation provider, if applicable.</param>
    /// <param name="modelId">The ID of the embedding generation model used, if applicable.</param>
    /// <param name="dimensions">The number of dimensions in vectors produced by this generator, if applicable.</param>
    public EmbeddingGeneratorMetadata(string? providerName = null, Uri? providerUri = null, string? modelId = null, int? dimensions = null)
    {
        ModelId = modelId;
        ProviderName = providerName;
        ProviderUri = providerUri;
        Dimensions = dimensions;
    }
 
    /// <summary>Gets the name of the embedding generation provider.</summary>
    public string? ProviderName { get; }
 
    /// <summary>Gets the URL for accessing the embedding generation provider.</summary>
    public Uri? ProviderUri { get; }
 
    /// <summary>Gets the ID of the model used by this embedding generation provider.</summary>
    /// <remarks>This value can be null if either the name is unknown or there are multiple possible models associated with this instance.</remarks>
    public string? ModelId { get; }
 
    /// <summary>Gets the number of dimensions in the embeddings produced by this instance.</summary>
    public int? Dimensions { get; }
}