BLACKBOX
flight recorder for AI agents

Real-time Fault Alerts

WEBHOOK DELIVERY
Configure outbound webhooks — fired the moment a fault is caught and contained. Every alert payload includes the chain hash, making it independently verifiable. Slack · PagerDuty · Datadog · HMAC-SHA256 signing · best-effort delivery.
Slack Block Kit auto-formatting: paste a https://hooks.slack.com/services/… URL and BLACKBOX automatically sends a rich Block Kit message — no extra config. Any other URL receives the raw JSON payload below.
No webhooks configured. Add one to receive real-time fault alerts.
SAMPLE FAULT ALERT PAYLOAD — generic webhook
{
  "type": "blackbox.fault",
  "run_id": "run_4187_covenant_review",
  "fault_count": 2,
  "fault_classes": [
    "C1",
    "C2"
  ],
  "chain_head": "a3f8d2c1…",
  "action": "regenerate",
  "_sig": "sha256=<hmac-if-secret-set>"
}
The chain_head is the SHA-256 hash of the decision event — independently verifiable against the BLACKBOX chain. Fault classes: C1 — fabricated value · C2 — fabricated source · C3 — out-of-scope · C4 — contradiction
SLACK BLOCK KIT — auto-formatted when URL contains hooks.slack.com
{
  "blocks": [
    {
      "type": "header",
      "text": {
        "type": "plain_text",
        "text": "BLACKBOX fault alert"
      }
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Run*\n`run_4187_covenant_review`"
        },
        {
          "type": "mrkdwn",
          "text": "*Faults*\n2 (C1, C2)"
        },
        {
          "type": "mrkdwn",
          "text": "*Action*\nregenerate"
        },
        {
          "type": "mrkdwn",
          "text": "*Chain*\n`a3f8d2c1…`"
        }
      ]
    }
  ]
}
Paste any https://hooks.slack.com/services/… URL in the webhook form above — BLACKBOX detects it automatically and sends Block Kit. No extra config needed.