メニュー
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).
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/BuilderIO/agent-native --skill notificationsコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Continue a coding session on a paired always-on computer. Use when work must survive closing the primary laptop, needs remote computer-use testing, or should run on a scheduled/self-hosted execution host.
How to look up version-matched Agent Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.
Complete the Slack feedback cycle: read every thread and linked evidence, fix verified repo-owned issues, and reply in-thread with honest status, clarification questions, and release follow-up. Use when the user asks to address feedback and respond as themselves.
SKILL.md を表示中
SOC 職業分類に基づく
| 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). |
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.
| Tool | Purpose |
|---|---|
notify | Send a notification (severity + title + optional body/metadata/channels) |
list-notifications | Show recent notifications for the current user |
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).
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."
| 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.
// 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).
Mounted at /_agent-native/notifications/* by core-routes-plugin, all session-scoped:
GET /notifications?unread=true&limit=50&before=<iso>GET /notifications/countPOST /notifications/:id/readPOST /notifications/read-allDELETE /notifications/:idimport { 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.
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.