McpParameterAttribute.cs

using System;
using System.Collections.Generic;
using Waher.Content.Markdown;
 
namespace Waher.Networking.HTTP.Mcp.Model.Attributes
{
    [AttributeUsage(AttributeTargets.Parameter | AttributeTargets.ReturnValue |
        AttributeTargets.Property | AttributeTargets.Field, 
        Inherited = true, AllowMultiple = false)]
    public class McpParameterAttribute : Attribute
    {
        public McpParameterAttribute(string? Title, string? Description)
        {
            this.Title = Title;
            this.Description = Description;
        }
 
        public string? Title { get; }
 
        public string? Description { get; }
 
        public virtual void Annotate(Dictionary<string, object?> Schema)
        {
            if (!string.IsNullOrEmpty(this.Title))
                Schema["title"] = this.Title;
 
            if (!string.IsNullOrEmpty(this.Description))
                Schema["description"] = this.Description;
        }
 
        public virtual string AnnotatedDescription => MarkdownDocument.Encode(
            this.Description ?? this.Title ?? string.Empty);
 
        public virtual void GetHtmlInputAttributes(Dictionary<string, string> Attributes)
        {
            if (!string.IsNullOrEmpty(this.Description))
                Attributes["title"] = this.Description;
        }
 
        public virtual string GetHtmlAttributeValue(object Value)
        {
            return Value?.ToString() ?? string.Empty;
        }
    }
}