919 B
919 B
name, description, metadata
| name | description | metadata |
|---|---|---|
| shd-notifications | Use when the user asks to inspect SHD notifications, notification modules, read state or preferences, or mark notifications read. | modules=notifications |
SHD notifications
See references/notification-contract.md for read-state and preference
boundaries.
Read
- Use
shd_list_notificationswith 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.