chore: keep widget sources only

2026-09-17 23:29:09 +03:00
commit e0404617d2
125 changed files with 8935 additions and 0 deletions
@@ -0,0 +1,25 @@
+---
+name: shd-notifications
+description: Use when the user asks to inspect SHD notifications, notification modules, read state or preferences, or mark notifications read.
+---
+
+# SHD notifications
+
+See `references/notification-contract.md` for read-state and preference
+boundaries.
+
+## Read
+
+- Use `shd_list_notifications` with bounded filters and preserve notification
+  IDs and timestamps.
+- Use module, read-state and preference tools only for the authenticated user
+  or the explicitly authorized scope.
+- Distinguish unread, read, muted and unavailable data; do not invent a missing
+  notification source.
+
+## State changes
+
+Marking one or more notifications read or changing preferences changes user
+state. Do it only when explicitly requested, use the returned IDs, and report
+the number and final state. Never mark a whole feed read merely because it was
+displayed or summarized.
@@ -0,0 +1,5 @@
+interface:
+  display_name: "SHD notifications"
+  short_description: "Review alerts and notification state"
+policy:
+  allow_implicit_invocation: false
@@ -0,0 +1,11 @@
+# Notification contract
+
+Read with `shd_list_notifications`, `shd_list_notification_modules`,
+`shd_get_notification_read_state`, `shd_get_notification_preferences` and,
+for document-specific items, `shd_list_document_notifications`.
+
+State-changing tools are `shd_update_notification_preferences`,
+`shd_mark_notification_read`, `shd_mark_all_notifications_read` and
+`shd_mark_notifications_read`. Require explicit scope for bulk marking,
+prefer stable notification IDs, and report server readback. A list response is
+not authorization to alter every item in it.