Notifications & Webhooks

​

What gets notified

• Run started (sdlc_start)
• Task validated — pass/fail with summary and attempt count
• A rich task execution report — tool calls, guardrail hits, memory actions, checks
• Human approval recorded (sdlc_approve)
• A gate blocking — the moment work is blocked on an approval, every channel is paged

​

Configure — environment variables

​

Configure — .rstack/notifications.json

{
  "channels": {
    "slack":    { "webhook": "https://hooks.slack.com/services/..." },
    "teams":    { "webhook": "https://yourorg.webhook.office.com/..." },
    "discord":  { "webhook": "https://discord.com/api/webhooks/..." },
    "telegram": { "bot_token": "123456:ABC...", "chat_id": "-1001234567890" },
    "whatsapp": { "token": "EAAB...", "phone_number_id": "1055...", "to": "15551234567" }
  }
}

​

Verify in seconds

npx rstack-agents notify          # show which channels are configured
npx rstack-agents notify --test   # send a test message to every channel

​

Channel notes

• Slack — incoming webhook; native Block Kit payloads.
• Teams — incoming webhook (connector); converted to MessageCard.
• Discord — webhook; converted to embeds.
• Telegram — create a bot with @BotFather, add it to your chat/group, use the bot token + chat id. Rendered as plain text.
• WhatsApp — Meta WhatsApp Business Cloud API: a Meta app with the WhatsApp product, a system-user token, the sender phone-number id, and the recipient number in international format (no +).

​

For adapter authors

import { notifyAll, hasConfiguredChannels, formatSlackStageMessage } from 'rstack-agents';

if (hasConfiguredChannels({ projectRoot })) {
  await notifyAll(formatSlackStageMessage(runId, stageId, 'PASS', { message }), { projectRoot });
}