Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

notifications

/notifications

Zapewnia powiadomienia w aplikacji z wymiennymi kanałami serwerowymi (dzwonek i toast, webhook, Slack, własne), aby agent mógł informować o postępie, alertach i zakończeniach.

Repozytorium
agent-native ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zapewnia powiadomienia w aplikacji z wymiennymi kanałami serwerowymi (dzwonek i toast, webhook, Slack, własne), aby agent mógł informować o postępie, alertach i zakończeniach.

Oryginalny opis (EN)

In-app notifications primitive with pluggable server-side channels. Use when the agent needs to surface progress, alerts, or completions to the user — both in-app (bell + toast) and out-of-band (webhook, Slack, custom).

Jak działa

  1. Tools
  2. Sending
  3. Delivery
  4. Built-in Channels
  5. Registering a Custom Channel
  6. HTTP API
  7. UI
  8. Related
Sekcje z nagłówków SKILL.md, w oryginale · 89 linii, 471 słów
Podgląd SKILL.md
---
name: notifications
description: >-
  In-app notifications primitive with pluggable server-side channels. Use when
  the agent needs to surface progress, alerts, or completions to the user —
  both in-app (bell + toast) and out-of-band (webhook, Slack, custom).
---

# Notifications

`notify()` is the framework's "tell the user something" primitive. Every call persists a row to the inbox (drives the bell UI) and fans out to any registered server-side channels. Channels follow the same pluggable-provider pattern as `tracking` — register at startup, `notify()` fans out, errors are isolated.

Use for: *agent progress milestones, automation triggers firing, background job completions, critical errors*. Don't use for chat replies — those go through the conversation.

## Tools

| Tool | Purpose |
|---|---|
| `notify` | Send a notification (severity + title + optional body/metadata/channels) |
| `list-notifications` | Show recent notifications for the current user |

## Sending

```
notify --severity info --title "Booking confirmed" --body "Jane at 3pm"
```

| Severity | When |
|---|---|
| `info` | FYI / progress / confirmation |
| `warning` | Something to look at soon |
| `critical` | Needs immediate attention |

Optional: `--metadataJson '{"threadId":"abc"}'`, `--channels inbox,webhook` (omit to run all registered).

## Delivery

`notify()` always inserts into the `notifications` table (unless `channels` explicitly excludes `inbox`), then fans out to every registered channel in parallel (best-effort; a failing channel doesn't block others). Finally it emits `notification.sent` on the event bus so automations can chain — e.g. *"when a critical notification fires, also page on-call."*

## Built-in Channels

| Channel | How | Requires |
|---|---|---|
| `inbox` | INSERT → drives bell UI | (always on) |
| `webhook` | POST JSON to `NOTIFICATIONS_WEBHOOK_URL` (+ optional `NOTIFICATIONS_WEBHOOK_AUTH`); both support `${keys.NAME}` + URL allowlists from the ad-hoc-keys system | env var set |

The webhook channel resolves `${keys.NAME}` server-side — the raw value never enters the agent context.

## Registering a Custom Channel

```ts
// server/plugins/notifications-slack.ts
import { registerNotificationChannel } from "@agent-native/core/notifications";

export default () => {
  registerNotificationChannel({
    name: "slack-ops",
    async deliver(input, meta) {
      await fetch(process.env.OPS_SLACK_WEBHOOK!, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({ text: `*${input.severity}* — ${input.title}`, owner: meta.owner }),
      });
    },
  });
};
```

Names are unique — re-registering replaces. `deliver()` must be best-effort; a thrown error is logged and ignored. Do NOT call `notify()` from inside a channel (recursion).

## HTTP API

Mounted at `/_agent-native/notifications/*` by `core-routes-plugin`, all session-scoped:

- `GET    /notifications?unread=true&limit=50&before=<iso>`
- `GET    /notifications/count`
- `POST   /notifications/:id/read`
- `POST   /notifications/read-all`
- `DELETE /notifications/:id`

## UI

```tsx
import { NotificationsBell } from "@agent-native/core/client/notifications";

<NotificationsBell browserNotifications />
```

Bell icon + unread badge + lazy-loaded dropdown. Pass `browserNotifications` to also fire system `new Notification(...)` popups for items that arrive after mount (dedups by id, renders an "Enable" prompt until permission is granted, silently no-ops on denied / unsupported). Styled with shadcn tokens — adapts to the host theme.

## Related

- `automations` — event-triggered bodies can call `notify`.
- `secrets` — `${keys.NAME}` substitution + URL allowlists powering the webhook channel.
- `tracking` — analytics; separate concern, don't route through notifications.

Wersje

RepozytoriumWynikLicencja
Ta strona · builderio/agent-native100MIT
r3dlex/oh-my-auggie100Apache-2.0
rlajous/claude-code-commands100MIT
neha/rn-developer-skills100MIT
tomaspozo/agentlink100MIT
sallaumen/elixir-agent-kit90MIT

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki f2d89a36997f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100frontmcp-channels
    Przesyła powiadomienia i zdarzenia w czasie rzeczywistym do sesji Claude Code lub innego klienta MCP oraz buduje dwukierunkowe mosty czatu z WhatsApp, Telegram, Slack i Discord.
  • 93argentos-webhook-subscriptions
    Tworzy subskrypcje webhooków, aby zewnętrzne usługi uruchamiały agentów lub wysyłały powiadomienia bez kosztu modelu.
  • 93community-webhook-subscriptions
    Tworzy subskrypcje webhooków, które uruchamiają agenta przy zdarzeniach zewnętrznych lub wysyłają powiadomienia do czatów.
  • 90hive.slack-notifications-setup
    Konfiguruje kanał powiadomień Slack (Sentinel) dla kolonii przez przeglądarkę: aplikacja z manifestu JSON, instalacja, tokeny, kanał przez API Slacka i włączenie Sentinela.
  • 95pilot-slack-bridge
    Łączy agentów Pilot Protocol ze Slackiem w obu kierunkach: wysyła powiadomienia na kanały i odbiera wiadomości jako strumień zdarzeń.
  • 100autoresearch-hooks
    Tworzy hooki uruchamiane przed i po iteracji sesji autoresearch, na przykład pobieranie źródeł, powiadomienia Slack lub webhook, zapis wniosków i automatyczne tagowanie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.