openalerts 0.2.6

package/dist/core/evaluator.js

@@ -0,0 +1,168 @@
+import { ALL_RULES } from "./rules.js";
+import { DEFAULTS, } from "./types.js";
+/** Create a fresh evaluator state. */
+export function createEvaluatorState() {
+    const now = Date.now();
+    return {
+        windows: new Map(),
+        cooldowns: new Map(),
+        consecutives: new Map(),
+        hourlyAlerts: { count: 0, resetAt: now + 60 * 60 * 1000 },
+        lastHeartbeatTs: 0,
+        startedAt: now,
+        stats: {
+            messagesProcessed: 0,
+            messageErrors: 0,
+            messagesReceived: 0,
+            webhookErrors: 0,
+            stuckSessions: 0,
+            toolCalls: 0,
+            toolErrors: 0,
+            agentStarts: 0,
+            agentErrors: 0,
+            sessionsStarted: 0,
+            compactions: 0,
+            totalTokens: 0,
+            totalCostUsd: 0,
+            lastResetTs: now,
+        },
+    };
+}
+/**
+ * Warm the evaluator state from persisted events.
+ * Replays recent events to rebuild windows/counters without re-firing alerts.
+ */
+export function warmFromHistory(state, events) {
+    for (const event of events) {
+        if (event.type === "alert") {
+            // Restore cooldowns from recent alerts
+            state.cooldowns.set(event.fingerprint, event.ts);
+        }
+        // Don't replay diagnostic/heartbeat events through rules —
+        // that would re-fire alerts. Just restore cooldown state.
+    }
+}
+/**
+ * Process a single event through all rules.
+ * Returns alerts that should be fired (already filtered by cooldown + hourly cap).
+ */
+export function processEvent(state, config, event) {
+    const now = Date.now();
+    // Reset 24h stats daily
+    if (now - state.stats.lastResetTs > 24 * 60 * 60 * 1000) {
+        state.stats.messagesProcessed = 0;
+        state.stats.messageErrors = 0;
+        state.stats.messagesReceived = 0;
+        state.stats.webhookErrors = 0;
+        state.stats.stuckSessions = 0;
+        state.stats.toolCalls = 0;
+        state.stats.toolErrors = 0;
+        state.stats.agentStarts = 0;
+        state.stats.agentErrors = 0;
+        state.stats.sessionsStarted = 0;
+        state.stats.compactions = 0;
+        state.stats.totalTokens = 0;
+        state.stats.totalCostUsd = 0;
+        state.stats.lastResetTs = now;
+    }
+    // Track event types in stats (independent of rule enabled state)
+    if (event.type === "infra.error") {
+        state.stats.webhookErrors++;
+    }
+    if (event.type === "tool.call" || event.type === "tool.error") {
+        state.stats.toolCalls++;
+        if (event.type === "tool.error")
+            state.stats.toolErrors++;
+    }
+    if (event.type === "agent.start") {
+        state.stats.agentStarts++;
+    }
+    if (event.type === "agent.error") {
+        state.stats.agentErrors++;
+    }
+    if (event.type === "session.start") {
+        state.stats.sessionsStarted++;
+    }
+    if (event.type === "session.stuck") {
+        state.stats.stuckSessions++;
+    }
+    if (event.type === "llm.call" || event.type === "llm.error" || event.type === "agent.error") {
+        state.stats.messagesProcessed++;
+        if (event.type === "llm.error" || event.type === "agent.error" ||
+            event.outcome === "error" || event.outcome === "timeout") {
+            state.stats.messageErrors++;
+        }
+    }
+    if (event.type === "llm.token_usage") {
+        if (typeof event.tokenCount === "number")
+            state.stats.totalTokens += event.tokenCount;
+        if (typeof event.costUsd === "number")
+            state.stats.totalCostUsd += event.costUsd;
+    }
+    if (event.type === "custom" && event.meta?.openclawHook === "message_received") {
+        state.stats.messagesReceived++;
+    }
+    if (event.type === "custom" && event.meta?.compaction === true) {
+        state.stats.compactions++;
+    }
+    // Reset hourly cap if expired
+    if (now >= state.hourlyAlerts.resetAt) {
+        state.hourlyAlerts.count = 0;
+        state.hourlyAlerts.resetAt = now + 60 * 60 * 1000;
+    }
+    const ctx = { state, config, now };
+    const fired = [];
+    for (const rule of ALL_RULES) {
+        let alert;
+        try {
+            alert = rule.evaluate(event, ctx);
+        }
+        catch {
+            // One broken rule must never block the rest
+            continue;
+        }
+        if (!alert)
+            continue;
+        // Check cooldown
+        const cooldownMs = resolveCooldownMs(config, rule);
+        const lastFired = state.cooldowns.get(alert.fingerprint);
+        if (lastFired && now - lastFired < cooldownMs)
+            continue;
+        // Check hourly cap
+        if (state.hourlyAlerts.count >= DEFAULTS.maxAlertsPerHour)
+            continue;
+        // Fire the alert
+        state.cooldowns.set(alert.fingerprint, now);
+        state.hourlyAlerts.count++;
+        fired.push(alert);
+    }
+    // Prune cooldown map if too large
+    if (state.cooldowns.size > DEFAULTS.maxCooldownEntries) {
+        const entries = [...state.cooldowns.entries()].sort((a, b) => a[1] - b[1]);
+        const toRemove = entries.slice(0, entries.length - DEFAULTS.maxCooldownEntries);
+        for (const [key] of toRemove) {
+            state.cooldowns.delete(key);
+        }
+    }
+    return fired;
+}
+/**
+ * Run the watchdog tick — checks for gateway-down condition.
+ * Called every 30 seconds by the engine timer.
+ */
+export function processWatchdogTick(state, config) {
+    return processEvent(state, config, { type: "watchdog.tick", ts: Date.now() });
+}
+/** Resolve the effective cooldown for a rule. */
+function resolveCooldownMs(config, rule) {
+    const override = config.rules?.[rule.id]?.cooldownMinutes;
+    if (typeof override === "number" && override > 0) {
+        return override * 60 * 1000;
+    }
+    const globalOverride = config.cooldownMinutes;
+    if (typeof globalOverride === "number" && globalOverride > 0) {
+        return globalOverride * 60 * 1000;
+    }
+    return rule.defaultCooldownMs;
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/core/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/core/evaluator.ts"],"names":[],"mappings":"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"}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,18 @@
+import type { OpenAlertsEvent } from "./types.js";
+export type EventListener = (event: OpenAlertsEvent) => void;
+/**
+ * Simple pub/sub event bus for OpenAlertsEvents.
+ * Replaces framework-specific event subscriptions (e.g., OpenClaw's onDiagnosticEvent).
+ */
+export declare class OpenAlertsEventBus {
+    private listeners;
+    /** Subscribe to all events. Returns an unsubscribe function. */
+    on(listener: EventListener): () => void;
+    /** Emit an event to all listeners. Errors in listeners are caught and logged. */
+    emit(event: OpenAlertsEvent): void;
+    /** Remove all listeners. */
+    clear(): void;
+    /** Current listener count. */
+    get size(): number;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAE7D;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAA4B;IAE7C,gEAAgE;IAChE,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAKvC,iFAAiF;IACjF,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAUlC,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IAIb,8BAA8B;IAC9B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/core/event-bus.js

@@ -0,0 +1,32 @@
+/**
+ * Simple pub/sub event bus for OpenAlertsEvents.
+ * Replaces framework-specific event subscriptions (e.g., OpenClaw's onDiagnosticEvent).
+ */
+export class OpenAlertsEventBus {
+    listeners = new Set();
+    /** Subscribe to all events. Returns an unsubscribe function. */
+    on(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    /** Emit an event to all listeners. Errors in listeners are caught and logged. */
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                console.error("[openalerts] event listener error:", err);
+            }
+        }
+    }
+    /** Remove all listeners. */
+    clear() {
+        this.listeners.clear();
+    }
+    /** Current listener count. */
+    get size() {
+        return this.listeners.size;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE7C,gEAAgE;IAChE,EAAE,CAAC,QAAuB;QACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,iFAAiF;IACjF,IAAI,CAAC,KAAsB;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/core/formatter.d.ts

@@ -0,0 +1,15 @@
+import type { AlertEvent, EvaluatorState, StoredEvent } from "./types.js";
+export declare function formatAlertMessage(alert: AlertEvent, opts?: {
+    diagnosisHint?: string;
+}): string;
+export declare function formatHealthOutput(opts: {
+    state: EvaluatorState;
+    channelActivity: Array<{
+        channel: string;
+        lastInbound: number | null;
+    }>;
+    activeAlerts: AlertEvent[];
+    platformConnected: boolean;
+}): string;
+export declare function formatAlertsOutput(events: StoredEvent[]): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/core/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/core/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAa/F;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,cAAc,CAAC;IACtB,eAAe,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACxE,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;CAC5B,GAAG,MAAM,CAqET;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAsChE"}

package/dist/core/formatter.js

@@ -0,0 +1,125 @@
+// ─── Alert Messages (sent to user's channel) ────────────────────────────────
+export function formatAlertMessage(alert, opts) {
+    const prefix = alert.severity === "critical"
+        ? "[OpenAlerts] CRITICAL: "
+        : "[OpenAlerts] ";
+    const lines = [prefix + alert.title, "", alert.detail, "", "/health for full status."];
+    if (alert.severity === "critical" && opts?.diagnosisHint) {
+        lines[lines.length - 1] = opts.diagnosisHint;
+    }
+    return lines.join("\n");
+}
+// ─── /health Command Output ──────────────────────────────────────────────────
+export function formatHealthOutput(opts) {
+    const { state, channelActivity, activeAlerts, platformConnected } = opts;
+    const uptime = formatDuration(Date.now() - state.startedAt);
+    const heartbeatAgo = state.lastHeartbeatTs > 0
+        ? `${formatDuration(Date.now() - state.lastHeartbeatTs)} ago`
+        : "none yet";
+    const status = activeAlerts.length > 0 ? "DEGRADED" : "OK";
+    const lines = [
+        "System Health -- OpenAlerts",
+        "",
+        `Status: ${status}`,
+        `Uptime: ${uptime} | Last heartbeat: ${heartbeatAgo}`,
+    ];
+    // Active alerts
+    if (activeAlerts.length > 0) {
+        lines.push("");
+        lines.push(`!! ${activeAlerts.length} active alert${activeAlerts.length > 1 ? "s" : ""}:`);
+        for (const a of activeAlerts.slice(0, 5)) {
+            const ago = formatDuration(Date.now() - a.ts);
+            lines.push(`  [${a.severity.toUpperCase()}] ${a.title} (${ago} ago)`);
+        }
+    }
+    // Channel activity
+    if (channelActivity.length > 0) {
+        lines.push("");
+        lines.push("Channels:");
+        for (const ch of channelActivity) {
+            const ago = ch.lastInbound
+                ? `active (${formatDuration(Date.now() - ch.lastInbound)} ago)`
+                : "no activity";
+            lines.push(`  ${ch.channel.padEnd(10)}: ${ago}`);
+        }
+    }
+    // 24h stats
+    lines.push("");
+    const s = state.stats;
+    const rcvd = s.messagesReceived > 0 ? `, ${s.messagesReceived} received` : "";
+    lines.push(`24h: ${s.messagesProcessed} msgs processed${rcvd}, ${s.messageErrors} errors, ${s.stuckSessions} stuck`);
+    if (s.toolCalls > 0 || s.agentStarts > 0 || s.sessionsStarted > 0) {
+        const parts = [];
+        if (s.toolCalls > 0)
+            parts.push(`${s.toolCalls} tools${s.toolErrors > 0 ? ` (${s.toolErrors} err)` : ""}`);
+        if (s.agentStarts > 0)
+            parts.push(`${s.agentStarts} agents${s.agentErrors > 0 ? ` (${s.agentErrors} err)` : ""}`);
+        if (s.sessionsStarted > 0)
+            parts.push(`${s.sessionsStarted} sessions`);
+        if (s.compactions > 0)
+            parts.push(`${s.compactions} compactions`);
+        lines.push(`     ${parts.join(", ")}`);
+    }
+    if (s.totalTokens > 0) {
+        const tokenStr = s.totalTokens >= 1000 ? `${(s.totalTokens / 1000).toFixed(1)}k` : `${s.totalTokens}`;
+        const costStr = s.totalCostUsd > 0 ? ` ($${s.totalCostUsd.toFixed(4)})` : "";
+        lines.push(`     ${tokenStr} tokens${costStr}`);
+    }
+    // Platform
+    lines.push("");
+    lines.push(platformConnected
+        ? "Platform: connected (openalerts.dev)"
+        : "Platform: not connected (add apiKey for diagnosis)");
+    return lines.join("\n");
+}
+// ─── /alerts Command Output ──────────────────────────────────────────────────
+export function formatAlertsOutput(events) {
+    const alerts = events.filter((e) => e.type === "alert");
+    const cutoff = Date.now() - 24 * 60 * 60 * 1000;
+    const recent = alerts.filter((a) => a.ts >= cutoff);
+    if (recent.length === 0) {
+        return [
+            "Recent Alerts",
+            "",
+            "No alerts in the last 24h. All systems normal.",
+        ].join("\n");
+    }
+    const lines = [
+        `Recent Alerts (${recent.length} in 24h)`,
+        "",
+    ];
+    // Show most recent first, cap at 10
+    const shown = recent.slice(-10).reverse();
+    for (const alert of shown) {
+        const time = new Date(alert.ts).toLocaleTimeString([], {
+            hour: "2-digit",
+            minute: "2-digit",
+        });
+        lines.push(`[${alert.severity.toUpperCase()}] ${time} -- ${alert.title}`);
+        lines.push(`  ${alert.detail}`);
+        lines.push("");
+    }
+    if (recent.length > 10) {
+        lines.push(`Showing 10 of ${recent.length} alerts.`);
+    }
+    return lines.join("\n").trimEnd();
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function formatDuration(ms) {
+    if (ms < 0)
+        ms = 0;
+    const sec = Math.floor(ms / 1000);
+    if (sec < 60)
+        return `${sec}s`;
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `${min}m`;
+    const hr = Math.floor(min / 60);
+    const remainMin = min % 60;
+    if (hr < 24)
+        return remainMin > 0 ? `${hr}h ${remainMin}m` : `${hr}h`;
+    const days = Math.floor(hr / 24);
+    const remainHr = hr % 24;
+    return remainHr > 0 ? `${days}d ${remainHr}h` : `${days}d`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/core/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/core/formatter.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAAC,KAAiB,EAAE,IAAiC;IACrF,MAAM,MAAM,GACV,KAAK,CAAC,QAAQ,KAAK,UAAU;QAC3B,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,eAAe,CAAC;IAEtB,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAEvF,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,IAAI,EAAE,aAAa,EAAE,CAAC;QACzD,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;IAC/C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,kBAAkB,CAAC,IAKlC;IACC,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAEzE,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,GAAG,CAAC;QAC5C,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM;QAC7D,CAAC,CAAC,UAAU,CAAC;IAEf,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3D,MAAM,KAAK,GAAa;QACtB,6BAA6B;QAC7B,EAAE;QACF,WAAW,MAAM,EAAE;QACnB,WAAW,MAAM,sBAAsB,YAAY,EAAE;KACtD,CAAC;IAEF,gBAAgB;IAChB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,MAAM,gBAAgB,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3F,KAAK,MAAM,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,GAAG,OAAO,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW;gBACxB,CAAC,CAAC,WAAW,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO;gBAC/D,CAAC,CAAC,aAAa,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;IACtB,MAAM,IAAI,GAAG,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,KAAK,CAAC,IAAI,CACR,QAAQ,CAAC,CAAC,iBAAiB,kBAAkB,IAAI,KAAK,CAAC,CAAC,aAAa,YAAY,CAAC,CAAC,aAAa,QAAQ,CACzG,CAAC;IACF,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3G,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,UAAU,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClH,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,eAAe,WAAW,CAAC,CAAC;QACvE,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,cAAc,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACtG,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,QAAQ,QAAQ,UAAU,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,WAAW;IACX,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,iBAAiB;QACf,CAAC,CAAC,sCAAsC;QACxC,CAAC,CAAC,oDAAoD,CACzD,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAC3C,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,MAAM,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,eAAe;YACf,EAAE;YACF,gDAAgD;SACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,kBAAkB,MAAM,CAAC,MAAM,UAAU;QACzC,EAAE;KACH,CAAC;IAEF,oCAAoC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE;YACrD,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,gFAAgF;AAEhF,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,GAAG,CAAC;QAAE,EAAE,GAAG,CAAC,CAAC;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAClC,IAAI,GAAG,GAAG,EAAE;QAAE,OAAO,GAAG,GAAG,GAAG,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IACjC,IAAI,GAAG,GAAG,EAAE;QAAE,OAAO,GAAG,GAAG,GAAG,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,GAAG,GAAG,EAAE,CAAC;IAC3B,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,CAAC;IACzB,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AAC7D,CAAC"}

package/dist/core/rules.d.ts

@@ -0,0 +1,3 @@
+import { type AlertRuleDefinition } from "./types.js";
+export declare const ALL_RULES: AlertRuleDefinition[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/core/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/core/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,mBAAmB,EAIxB,MAAM,YAAY,CAAC;AAmepB,eAAO,MAAM,SAAS,EAAE,mBAAmB,EAW1C,CAAC"}