AI Tools

Expose local notifications as reminder-style Microsoft.Extensions.AI tool functions that LLM agents can call directly — “Remind me to call the dentist at 3pm”, “Set a daily reminder to take my meds at 8:30am”, “What reminders do I have?”. You opt-in exactly which operations the model can see, read-only by default.

The AI layer (Shiny.Notifications.Extensions.AI) sits on top of INotificationManager and does not change its behavior. It frames the notification operations you opt-in to as reminder AIFunction tools.

Setup

1. Install the AI extensions package

   dotnet add package Shiny.Notifications.Extensions.AI

2. Register notifications and the AI tools

   using Shiny.Notifications;
   using Shiny.Notifications.Extensions.AI;
   
   builder.Services.AddNotifications();
   
   builder.Services.AddNotificationAITools(tools => tools
       .AddReminders(ReminderAICapabilities.ReadWrite, channel: "reminders")   // channel is optional
   );

3. Resolve NotificationAITools and hand .Tools to your chat client

   var reminders = sp.GetRequiredService<NotificationAITools>();
   
   var response = await chatClient.GetResponseAsync(
       messages,
       new ChatOptions { Tools = [.. reminders.Tools] }
   );

Request permissions first

The generated tools assume notification permissions are already granted — they do not trigger the platform permission UI (which needs a foreground activity). Call INotificationManager.RequestAccess(...) from your app before invoking the agent. If you pass a channel, register it first via AddChannel.

Capabilities

AddReminders defaults to ReminderAICapabilities.Read. Pass ReadWrite (or Write) to also expose the create/cancel tools. This is an allow-list you control on behalf of the agent — not an OS permission prompt.

[Flags]
public enum ReminderAICapabilities
{
    None = 0,
    Read = 1 << 0,
    Write = 1 << 1,
    ReadWrite = Read | Write
}

Generated Tools Reference

Tool	Capability	Arguments	Notes
list_reminders	Read	(none)	Returns pending/scheduled/repeating reminders with id, title, message, and when each fires.
create_reminder	Write	message, title?, scheduleFor?, repeatDailyAt?	Omit both time args to notify now; scheduleFor for a one-time reminder; repeatDailyAt ("HH:mm") for a daily one. Returns the reminder id.
cancel_reminder	Write	id	Cancels a reminder (displayed or pending) by id.

scheduleFor and repeatDailyAt are mutually exclusive. Dates are ISO-8601 (2026-07-06T15:00:00Z); repeatDailyAt is a 24-hour local time ("08:30").

Combine with your app’s own functions

The functions your app exposes to Siri and Gemini can join these tools in the same chat. Shiny.AppFunctions.Extensions.AI turns them into AIFunctions with the same *AITools bundle shape, so you concatenate the .Tools lists into one ChatOptions.Tools.

AOT

Shiny.Notifications.Extensions.AI is IsAotCompatible — tool schemas are hand-built and results are emitted as JsonNode, so there is no reflection-based serialization in the tool path.