50 lines
4.3 KiB
C#
50 lines
4.3 KiB
C#
using PostFundManagement.Application.Abstractions.Services;
|
|
using PostFundManagement.Application.Extensions;
|
|
using PostFundManagement.Application.Services.Communications;
|
|
using PostFundManagement.Domain;
|
|
using PostFundManagement.Domain.Models;
|
|
|
|
namespace PostFundManagement.Application.Mcp;
|
|
|
|
/// <summary>
|
|
/// MCP tools proxying Communications, Onboarding Invites & Notification Services (Module M25, Recipient Onboarding M03).
|
|
/// </summary>
|
|
[McpServerToolType]
|
|
public class CommunicationsMcpTools(ICommunicationsService service)
|
|
{
|
|
[McpServerTool(Name = "communications_get_notifications", Title = "Get Organisation Notifications", ReadOnly = true)]
|
|
[Description("Retrieves notifications and alerts dispatched to an organisation.")]
|
|
public async Task<Records<Notification[]>> GetNotificationsAsync([Description("Organisation hash identifier")] string organisationIdHash, CancellationToken cancellationToken = default) =>
|
|
(await service.GetNotificationsAsync(organisationIdHash, cancellationToken)).ToMcpResult();
|
|
|
|
[McpServerTool(Name = "communications_get_user_notifications", Title = "Get User Notifications", ReadOnly = true)]
|
|
[Description("Retrieves pending notifications and task reminders for a specific user.")]
|
|
public async Task<Records<Notification[]>> GetUserNotificationsAsync([Description("Target user identifier")] Guid userId, CancellationToken cancellationToken = default) =>
|
|
(await service.GetUserNotificationsAsync(userId, cancellationToken)).ToMcpResult();
|
|
|
|
[McpServerTool(Name = "communications_create_notification", Title = "Dispatch Notification", Destructive = false)]
|
|
[Description("Creates and queues a system, in-app, or email notification for delivery (FR-M25-001).")]
|
|
public async Task<McpToolResult> CreateNotificationAsync([Description("Notification creation request")] CreateNotificationRequest request, [Description("Optional acting user ID; defaults to System user if omitted")] Guid? userId = null, CancellationToken cancellationToken = default) =>
|
|
(await service.CreateNotificationAsync(request, userId ?? SystemUser, cancellationToken)).ToMcpResult("Notification successfully created and queued for delivery.");
|
|
|
|
[McpServerTool(Name = "communications_update_notification", Title = "Update Notification Status", Destructive = false)]
|
|
[Description("Updates the delivery or read status of a notification.")]
|
|
public async Task<McpToolResult> UpdateNotificationAsync([Description("Notification update request")] UpdateNotificationRequest request, CancellationToken cancellationToken = default) =>
|
|
(await service.UpdateNotificationAsync(request, cancellationToken)).ToMcpResult("Notification status successfully updated.");
|
|
|
|
[McpServerTool(Name = "communications_send_invite", Title = "Send Onboarding Invite", Destructive = false)]
|
|
[Description("Sends an invitation email and onboarding link to an external grantee or partner organisation user (Module M03).")]
|
|
public async Task<Records<Invite>> SendInviteAsync([Description("Invite request parameters")] InviteRequest request, [Description("Optional acting user ID; defaults to System user if omitted")] Guid? userId = null, CancellationToken cancellationToken = default) =>
|
|
(await service.SendInviteAsync(request, userId ?? SystemUser, cancellationToken)).ToMcpResult();
|
|
|
|
[McpServerTool(Name = "communications_get_invites", Title = "Get Onboarding Invites", ReadOnly = true)]
|
|
[Description("Retrieves a paginated list of sent onboarding invitations and their verification states.")]
|
|
public async Task<Records<Invite[]>> GetInvitesAsync([Description("Page index (1-based)")] int page = 1, [Description("Page size (1-100)")] int pageSize = 50, CancellationToken cancellationToken = default) =>
|
|
(await service.GetInvitesAsync(new Pagination(page, pageSize), cancellationToken)).ToMcpResult();
|
|
|
|
[McpServerTool(Name = "communications_get_applicant_data", Title = "Get Applicant Intake Data", ReadOnly = true)]
|
|
[Description("Retrieves captured applicant and grantee profile data for onboarding validation.")]
|
|
public async Task<Records<ApplicantData[]>> GetApplicantDataAsync([Description("Applicant user identifier")] Guid applicantUserId, CancellationToken cancellationToken = default) =>
|
|
(await service.GetApplicantDataAsync(applicantUserId, cancellationToken)).ToMcpResult();
|
|
}
|