Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nullbridge.ai/llms.txt

Use this file to discover all available pages before exploring further.

Setup

1. Set Your Notification Email

Go to app.nullbridge.aiSettingsNotifications → enter your email → click Save Changes.

2. Enable Alert Types

ToggleWhen it fires
Alert on Critical EventsKill switch activated, critical anomaly, T4 auto-suspended
Alert on WarningsAnomaly warning below suspend threshold
Alert on Agent SuspensionAny agent suspended

Alert Types

⚡ Kill Switch

Subject: ⚡ Kill Switch — [Agent Name] | NullBridge Fires when an operator activates the kill switch. Contains agent name, operator, tier, environment, and timestamp.

⚠️ Agent Suspended

Subject: ⚠️ Agent Suspended — [Agent Name] | NullBridge Fires when any agent is suspended manually or by the anomaly engine.

🚨 Anomaly Detected

Subject: 🚨 Critical Anomaly — [Agent Name] | NullBridge Fires when the anomaly engine detects unusual behavior. Contains metric, current value, baseline mean, and z-score.

✅ Agent Restored

Subject: ✅ Agent Restored — [Agent Name] | NullBridge Fires when a suspended agent is restored to active status.

Anomaly Detection

Thresholds

ThresholdDefaultEffect
Warning (σ)2.0SIEM warning logged, email sent if enabled
Auto-Suspend (σ)3.0Agent suspended, critical email sent

Recording Metrics via SDK

nb.anomaly.record(agent.id, 'api_calls_per_minute', 14);
nb.anomaly.record(agent.id, 'tokens_used', 3200);

nb.anomaly.onAlert(alert => {
  console.error(`Anomaly: ${alert.metric} — z=${alert.zScore}`);
});

Testing

  1. Set notification email in Settings
  2. Enable Alert on Critical Events
  3. Kill any test agent in the Agent Registry
  4. Check your inbox — alert arrives within seconds

Support

Contact brian@nullbridge.ai for help.