namespace ColaFlow.Modules.Mcp.Contracts.Resources;

/// <summary>
/// Interface for MCP Resources
/// Resources provide read-only data to AI agents through the MCP protocol
/// </summary>
public interface IMcpResource
{
    /// <summary>
    /// Resource URI (e.g., "colaflow://projects.list")
    /// </summary>
    string Uri { get; }

    /// <summary>
    /// Resource display name
    /// </summary>
    string Name { get; }

    /// <summary>
    /// Resource description
    /// </summary>
    string Description { get; }

    /// <summary>
    /// MIME type of the resource content (typically "application/json")
    /// </summary>
    string MimeType { get; }

    /// <summary>
    /// Get resource content
    /// </summary>
    /// <param name="request">Resource request with URI and parameters</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Resource content</returns>
    Task<McpResourceContent> GetContentAsync(
        McpResourceRequest request,
        CancellationToken cancellationToken);
}