---
name: hydrogen-notifications-mac
description: >
  macOS platform companion to hydrogen-notifications — the Apple-specific half of how
  Adom Hydrogen reaches the user outside the window. The generic notify handler,
  payload shape, levels, and /ui/toast live in hydrogen-notifications (adom/hd-bootstrap);
  THIS skill carries only the macOS delivery mechanics: Notification Center toasts,
  the emergency Dock-icon attention bounce, and the System Settings → Notifications
  grant. Trigger words — macos
  notification, notification center, dock bounce, request attention macos, allow
  notifications macos, toast on mac.
---

# hydrogen-notifications (macOS) — Notification Center + Dock attention

This is the **macOS half** of `hydrogen-notifications`. The cross-platform contract — the
`notify` message, the `NotifyPayload` (`title`/`body`/`level`/`actions`), the levels
`info|warning|error|emergency`, and the in-app `POST /ui/toast` — is identical on
every host and lives in the generic **hydrogen-notifications** skill. Read that first; this
skill only documents what's Apple-specific.

## Delivery

- **Toasts → macOS Notification Center.** A `notify` surfaces as a system
  notification (short for `info`, long-duration for `warning`/`error`/`emergency`),
  rendered by `notifications.rs` → `show_toast`.
- **`emergency` → persistent Dock-icon bounce.** On top of the toast, Hydrogen calls
  `request_user_attention(Critical)` on the main window and shows/unminimizes it. On
  macOS this **bounces Hydrogen's Dock icon persistently** and keeps demanding attention
  until the user clicks through themselves — a programmatic focus does NOT clear it.
- **Identity.** Toasts surface under the **"Adom"** title (Hydrogen prefixes `title` with
  `"Adom: "` unless it already starts with "Adom"), and the notification is attributed
  to Hydrogen's **app bundle** — not via a Start-Menu-shortcut AUMID (that's the Windows
  path).

## macOS gotcha — the Notifications grant

macOS gates notifications per-app: the user must allow **Adom Hydrogen** under
**System Settings → Notifications**. If toasts never appear (but the in-app
`/ui/toast` works), that grant is the first thing to check — there's no Windows-style
"always works" toast. Unlike Screen Recording / Accessibility, Hydrogen does not block setup
on it; it's best-effort.

## Not applicable on macOS

WinRT toast templates, the Start-Menu-shortcut **AUMID** wiring, and taskbar flash are
the Windows delivery. Do not apply that machinery on
macOS.
