ai-inference-stepper 1.0.0

package/src/alerts/discord.ts

@@ -0,0 +1,86 @@
+// `packages/stepper/src/alerts/discord.ts
+
+import { logger } from '../logging.js';
+
+const DISCORD_WEBHOOK_URL = process.env.DISCORD_WEBHOOK_URL;
+
+export interface DiscordAlert {
+    title: string;
+    message: string;
+    severity: 'info' | 'warning' | 'critical';
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Send alert to Discord webhook
+ */
+export async function sendDiscordAlert(alert: DiscordAlert): Promise<void> {
+    if (!DISCORD_WEBHOOK_URL) {
+        logger.debug('Discord webhook URL not configured, skipping alert');
+        return;
+    }
+
+    const emoji = alert.severity === 'critical' ? '🚨' : alert.severity === 'warning' ? '⚠️' : 'ℹ️';
+    const content = `${emoji} **${alert.title}**\n${alert.message}`;
+
+    const embed = alert.metadata
+        ? {
+            embeds: [
+                {
+                    title: alert.title,
+                    description: alert.message,
+                    color: alert.severity === 'critical' ? 0xff0000 : alert.severity === 'warning' ? 0xffa500 : 0x00ff00,
+                    fields: Object.entries(alert.metadata).map(([key, value]) => ({
+                        name: key,
+                        value: String(value),
+                        inline: true,
+                    })),
+                    timestamp: new Date().toISOString(),
+                },
+            ],
+        }
+        : { content };
+
+    try {
+        const response = await fetch(DISCORD_WEBHOOK_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(embed),
+        });
+
+        if (!response.ok) {
+            logger.warn({ status: response.status }, 'Discord webhook request failed');
+        }
+    } catch (error) {
+        logger.error({ error }, 'Failed to send Discord alert');
+    }
+}
+
+/**
+ * Send provider failure alert
+ */
+export async function alertProviderFailure(provider: string, errorCount: number, error?: unknown): Promise<void> {
+    const errorDetail = error instanceof Error ? error.message : String(error || 'Unknown error');
+
+    await sendDiscordAlert({
+        title: 'AI Provider Failure',
+        message: `Provider **${provider}** has failed ${errorCount} times\n\n**Error Details:**\n\`${errorDetail}\``,
+        severity: errorCount >= 5 ? 'critical' : 'warning',
+        metadata: { provider, errorCount, error: errorDetail, timestamp: new Date().toISOString() },
+    });
+}
+
+/**
+ * Send circuit breaker alert
+ */
+export async function alertCircuitOpen(provider: string, lastError?: unknown): Promise<void> {
+    const errorDetail = lastError ? (lastError instanceof Error ? lastError.message : String(lastError)) : undefined;
+    const message = `Circuit breaker for provider **${provider}** is now OPEN${errorDetail ? `\n\n**Last Error:**\n\`${errorDetail}\`` : ''}`;
+
+    await sendDiscordAlert({
+        title: 'Circuit Breaker Opened',
+        message,
+        severity: 'critical',
+        metadata: { provider, lastError: errorDetail, timestamp: new Date().toISOString() },
+    });
+}