@steadwing/openalerts 0.2.5 → 0.2.6

package/dist/cli.js

@@ -0,0 +1,234 @@
+#!/usr/bin/env node
+/**
+ * openalerts CLI
+ *
+ * Usage:
+ *   openalerts start                 Start monitoring daemon
+ *   openalerts start --port 4242     Custom port
+ *   openalerts start --config ./openalerts.config.json
+ *   openalerts status                Print engine state (if running)
+ *   openalerts init                  Create default config file
+ *   openalerts test                  Send test alert (daemon must be running)
+ */
+import path from "node:path";
+import os from "node:os";
+import { openDb, pruneDb } from "./db/index.js";
+import { loadConfig, detectGatewayToken, writeDefaultConfig } from "./config.js";
+import { loadAll } from "./readers/openclaw.js";
+import { FileWatcher } from "./watchers/files.js";
+import { GatewayClient } from "./watchers/gateway.js";
+import { translateGatewayEvent } from "./watchers/gateway-adapter.js";
+import { OpenAlertsEngine } from "./core/engine.js";
+import { TelegramChannel } from "./channels/telegram.js";
+import { WebhookChannel } from "./channels/webhook.js";
+import { ConsoleChannel } from "./channels/console.js";
+import { startHttpServer } from "./server/index.js";
+// ── CLI arg parsing ───────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const command = args[0] ?? "start";
+function getFlag(name, defaultVal) {
+    const idx = args.indexOf(name);
+    if (idx !== -1 && args[idx + 1])
+        return args[idx + 1];
+    return defaultVal;
+}
+// ── Commands ──────────────────────────────────────────────────────────────────
+if (command === "init") {
+    const configPath = getFlag("--config") ?? path.join(os.homedir(), ".openalerts", "config.json");
+    writeDefaultConfig(configPath);
+    console.log(`[init] Created config at ${configPath}`);
+    console.log(`[init] Edit it and run: openalerts start`);
+    process.exit(0);
+}
+if (command === "test") {
+    const port = parseInt(getFlag("--port") ?? "4242");
+    fetch(`http://127.0.0.1:${port}/api/test`, { method: "POST" })
+        .then(r => r.json())
+        .then(d => { console.log("[test]", d); process.exit(0); })
+        .catch(err => { console.error("[test] Failed (is daemon running?):", err.message); process.exit(1); });
+    // guard: exit after 5s if fetch hangs
+    setTimeout(() => process.exit(1), 5000);
+    process.exitCode = 0; // allow async
+}
+else if (command === "status") {
+    const port = parseInt(getFlag("--port") ?? "4242");
+    fetch(`http://127.0.0.1:${port}/api/engine`)
+        .then(r => r.json())
+        .then(d => { console.log(JSON.stringify(d, null, 2)); process.exit(0); })
+        .catch(err => { console.error("[status] Failed (is daemon running?):", err.message); process.exit(1); });
+    setTimeout(() => process.exit(1), 5000);
+}
+else if (command === "start") {
+    const configPath = getFlag("--config");
+    const portArg = getFlag("--port");
+    const config = loadConfig(configPath);
+    if (portArg)
+        config.server.port = parseInt(portArg);
+    // Auto-detect gateway token if not configured
+    if (!config.gatewayToken) {
+        config.gatewayToken = detectGatewayToken(config.watch.openclawDir);
+        if (config.gatewayToken) {
+            console.log("[config] Auto-detected gateway operator token");
+        }
+    }
+    startDaemon(config);
+}
+else {
+    console.error(`Unknown command: ${command}`);
+    console.error("Usage: openalerts [start|init|status|test] [--port N] [--config path]");
+    process.exit(1);
+}
+// ── Daemon startup ────────────────────────────────────────────────────────────
+async function startDaemon(config) {
+    console.log("[openalerts] Starting…");
+    console.log(`[openalerts] State dir: ${config.stateDir}`);
+    console.log(`[openalerts] Watching: ${config.watch.openclawDir}`);
+    // ── 1. Open database ───────────────────────────────────────────────────────
+    const db = openDb(config.stateDir);
+    console.log("[db] SQLite opened");
+    // ── 2. Build alert channels ────────────────────────────────────────────────
+    const channels = [];
+    for (const ch of config.channels) {
+        if (ch.type === "telegram" && ch.token && ch.chatId) {
+            channels.push(new TelegramChannel(ch.token, ch.chatId));
+            console.log("[channels] Telegram channel added");
+        }
+        else if (ch.type === "webhook" && ch.webhookUrl) {
+            channels.push(new WebhookChannel(ch.webhookUrl));
+            console.log("[channels] Webhook channel added");
+        }
+        else if (ch.type === "console") {
+            channels.push(new ConsoleChannel());
+            console.log("[channels] Console channel added");
+        }
+    }
+    if (channels.length === 0) {
+        channels.push(new ConsoleChannel());
+        console.log("[channels] No channels configured — using console fallback");
+    }
+    // ── 3. Start alert engine ──────────────────────────────────────────────────
+    const engine = new OpenAlertsEngine({
+        stateDir: path.join(config.stateDir, "events"),
+        config: {
+            quiet: config.quiet,
+            rules: config.rules,
+        },
+        channels,
+        diagnosisHint: 'Run "openclaw doctor" in your terminal',
+        db,
+    });
+    engine.start();
+    // ── 4. Initial file load ───────────────────────────────────────────────────
+    console.log("[loader] Loading OpenClaw files…");
+    try {
+        loadAll(db, config.watch);
+        console.log("[loader] Initial load complete");
+    }
+    catch (err) {
+        console.warn(`[loader] Initial load warning: ${err}`);
+    }
+    // ── 5. Gateway connection state (declared early so closure captures it) ──────
+    let gatewayConnected = false;
+    let startupGwAlertFired = false;
+    // ── 6. Start HTTP server + SSE ─────────────────────────────────────────────
+    const httpServer = startHttpServer(config.server, db, engine, () => gatewayConnected);
+    // Wire engine events to SSE (push live alerts/diagnostics to dashboard)
+    engine.bus.on(event => {
+        httpServer.sse.emit("diagnostic", {
+            event_type: event.type, ts: event.ts,
+            summary: `${event.type}${event.outcome ? `:${event.outcome}` : ""}`,
+            channel: event.channel, session_key: event.sessionKey, agent_id: event.agentId,
+        });
+    });
+    // ── 7. File watcher ────────────────────────────────────────────────────────
+    const fileWatcher = new FileWatcher(db, config.watch, (changed) => {
+        console.log(`[watcher] Changed: ${path.basename(changed)}`);
+        // Push updated state to SSE clients
+        try {
+            import("./db/queries.js").then(({ getDashboardState }) => {
+                httpServer.sse.emit("state", getDashboardState(db));
+            }).catch(() => { });
+        }
+        catch { /* ignore */ }
+    });
+    fileWatcher.start();
+    // ── 8. Gateway WebSocket ───────────────────────────────────────────────────
+    const gwClient = new GatewayClient({
+        url: config.gatewayUrl,
+        token: config.gatewayToken,
+    });
+    gwClient.on("ready", () => {
+        gatewayConnected = true;
+        console.log("[gateway] Connected to OpenClaw gateway ✓");
+        // Push updated state (heartbeats, sessions) to dashboard
+        import("./db/queries.js").then(({ getDashboardState }) => {
+            httpServer.sse.emit("state", getDashboardState(db));
+        }).catch(() => { });
+    });
+    gwClient.on("disconnected", () => {
+        const wasConnected = gatewayConnected;
+        gatewayConnected = false;
+        if (wasConnected) {
+            console.log("[gateway] Lost connection — reconnecting…");
+            engine.ingest({ type: "infra.heartbeat", ts: Date.now(), outcome: "error" });
+        }
+    });
+    gwClient.on("error", (err) => {
+        // ECONNREFUSED = openclaw not running, suppress noisy repeat logs
+        if (!err.message.includes("ECONNREFUSED") && !err.message.includes("connect ECONNREFUSED")) {
+            console.warn(`[gateway] ${err.message}`);
+        }
+    });
+    // All real gateway event names from OpenClaw's WS protocol
+    const GW_EVENTS = ["health", "tick", "agent", "chat", "cron.run", "exec.started", "exec.output", "exec.completed"];
+    for (const evt of GW_EVENTS) {
+        gwClient.on(evt, (payload) => {
+            const result = translateGatewayEvent(evt, payload, db);
+            if (result.event)
+                engine.ingest(result.event);
+            if (result.sseType && result.ssePayload) {
+                httpServer.sse.emit(result.sseType, result.ssePayload);
+            }
+        });
+    }
+    gwClient.start();
+    // Fire gateway-down alert if not connected within 30s of startup
+    setTimeout(() => {
+        if (!gatewayConnected && !startupGwAlertFired) {
+            startupGwAlertFired = true;
+            console.warn("[gateway] Not connected after 30s — OpenClaw may be down");
+            engine.ingest({ type: "infra.heartbeat", ts: Date.now(), outcome: "error" });
+            // Manually fire a gateway-down style alert via 3 consecutive heartbeat failures
+            for (let i = 0; i < 3; i++) {
+                engine.ingest({ type: "infra.heartbeat", ts: Date.now() + i, outcome: "error" });
+            }
+        }
+    }, 30_000);
+    // ── 9. Periodic tasks ─────────────────────────────────────────────────────
+    // Re-sync files + DB prune every 5 minutes
+    const syncInterval = setInterval(() => {
+        try {
+            loadAll(db, config.watch);
+        }
+        catch { /* ignore */ }
+        try {
+            pruneDb(db);
+        }
+        catch { /* ignore */ }
+    }, 5 * 60 * 1000);
+    // ── 10. Graceful shutdown ──────────────────────────────────────────────────
+    function shutdown(sig) {
+        console.log(`\n[openalerts] ${sig} — shutting down…`);
+        clearInterval(syncInterval);
+        gwClient.stop();
+        fileWatcher.stop();
+        engine.stop();
+        httpServer.close();
+        db.close();
+        process.exit(0);
+    }
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    console.log("[openalerts] Running. Press Ctrl+C to stop.");
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,51 @@
+export interface ChannelConfig {
+    type: "telegram" | "discord" | "slack" | "webhook" | "console";
+    token?: string;
+    chatId?: string;
+    webhookUrl?: string;
+    url?: string;
+}
+export interface RuleOverride {
+    enabled?: boolean;
+    threshold?: number;
+    cooldownMinutes?: number;
+}
+export interface WatchConfig {
+    /** Path to ~/.openclaw or custom openclaw data dir */
+    openclawDir: string;
+    /** Workspaces to watch (relative to openclawDir or absolute) */
+    workspaces: string[];
+}
+export interface ServerConfig {
+    port: number;
+    host: string;
+}
+export interface AppConfig {
+    /** OpenClaw gateway WebSocket URL */
+    gatewayUrl: string;
+    /** Gateway operator token (gateway.auth.token from openclaw.json) */
+    gatewayToken: string;
+    /** Where openalerts stores its own data */
+    stateDir: string;
+    /** File watching config */
+    watch: WatchConfig;
+    /** HTTP server config */
+    server: ServerConfig;
+    /** Alert channels */
+    channels: ChannelConfig[];
+    /** Per-rule overrides */
+    rules?: Record<string, RuleOverride>;
+    /** Suppress outbound alerts (log only) */
+    quiet?: boolean;
+    /** Hourly alert cap (default 10) */
+    maxAlertsPerHour?: number;
+}
+export declare function loadConfig(configPath?: string): AppConfig;
+export declare function writeDefaultConfig(targetPath: string): void;
+/**
+ * Auto-detect the OpenClaw gateway operator token.
+ * Primary source: gateway.auth.token in openclaw.json (the master operator token).
+ * This is the correct token for WS connect with client.id = "cli".
+ */
+export declare function detectGatewayToken(openclawDir: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAE/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,yBAAyB;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkBD,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAsBzD;AAYD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAgB3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAa9D"}

package/dist/config.js

@@ -0,0 +1,86 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const DEFAULTS = {
+    gatewayUrl: "ws://127.0.0.1:18789",
+    gatewayToken: "",
+    stateDir: path.join(os.homedir(), ".openalerts"),
+    watch: {
+        openclawDir: path.join(os.homedir(), ".openclaw"),
+        workspaces: ["workspace", "workspace-study"],
+    },
+    server: {
+        port: 4242,
+        host: "127.0.0.1",
+    },
+    channels: [],
+    quiet: false,
+};
+export function loadConfig(configPath) {
+    const candidates = [
+        configPath,
+        path.join(process.cwd(), "openalerts.config.json"),
+        path.join(os.homedir(), ".openalerts", "config.json"),
+        // legacy path migration
+        path.join(os.homedir(), ".openalerts-watch", "config.json"),
+        path.join(os.homedir(), ".config", "openalerts", "config.json"),
+    ].filter(Boolean);
+    for (const p of candidates) {
+        if (fs.existsSync(p)) {
+            try {
+                const raw = JSON.parse(fs.readFileSync(p, "utf8"));
+                return mergeConfig(DEFAULTS, raw);
+            }
+            catch (err) {
+                console.error(`[openalerts] Failed to parse config at ${p}: ${err}`);
+            }
+        }
+    }
+    return { ...DEFAULTS };
+}
+function mergeConfig(base, override) {
+    return {
+        ...base,
+        ...override,
+        watch: { ...base.watch, ...(override.watch ?? {}) },
+        server: { ...base.server, ...(override.server ?? {}) },
+        channels: override.channels ?? base.channels,
+    };
+}
+export function writeDefaultConfig(targetPath) {
+    const openclawDir = path.join(os.homedir(), ".openclaw");
+    const autoToken = detectGatewayToken(openclawDir);
+    const sample = {
+        ...DEFAULTS,
+        gatewayToken: autoToken || "PASTE_YOUR_OPERATOR_TOKEN_HERE",
+        channels: [
+            {
+                type: "telegram",
+                token: "YOUR_BOT_TOKEN",
+                chatId: "YOUR_CHAT_ID",
+            },
+        ],
+    };
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, JSON.stringify(sample, null, 2) + "\n");
+}
+/**
+ * Auto-detect the OpenClaw gateway operator token.
+ * Primary source: gateway.auth.token in openclaw.json (the master operator token).
+ * This is the correct token for WS connect with client.id = "cli".
+ */
+export function detectGatewayToken(openclawDir) {
+    // Primary: master token from openclaw.json gateway.auth.token
+    const configPath = path.join(openclawDir, "openclaw.json");
+    try {
+        const data = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        const gw = data.gateway;
+        const auth = gw?.auth;
+        if (typeof auth?.token === "string" && auth.token) {
+            return auth.token;
+        }
+    }
+    catch { /* ignore */ }
+    return "";
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/alert-channel.d.ts

@@ -1,23 +1,16 @@
 import type { AlertChannel, AlertEvent, OpenAlertsLogger } from "./types.js";
-/**
- * Dispatches alerts to all registered channels.
- * Fire-and-forget: individual channel failures don't block others.
- */
 export declare class AlertDispatcher {
     private channels;
     private logger;
-    private diagnosisHint?;
+    private diagnosisHint;
     constructor(opts: {
         channels?: AlertChannel[];
         logger?: OpenAlertsLogger;
         diagnosisHint?: string;
     });
-    /** Add a channel at runtime. */
     addChannel(channel: AlertChannel): void;
-    /** Send an alert to all registered channels. */
-    dispatch(alert: AlertEvent): Promise<void>;
-    /** Whether any channels are registered. */
     get hasChannels(): boolean;
-    /** Number of registered channels. */
     get channelCount(): number;
+    dispatch(alert: AlertEvent): Promise<void>;
 }
+//# sourceMappingURL=alert-channel.d.ts.map

package/dist/core/alert-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-channel.d.ts","sourceRoot":"","sources":["../../src/core/alert-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG7E,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAS;gBAElB,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAMlG,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIvC,IAAI,WAAW,IAAI,OAAO,CAAqC;IAC/D,IAAI,YAAY,IAAI,MAAM,CAAiC;IAErD,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAWjD"}

package/dist/core/alert-channel.js

@@ -1,44 +1,23 @@
-import { formatAlertMessage } from "./formatter.js";
-/**
- * Dispatches alerts to all registered channels.
- * Fire-and-forget: individual channel failures don't block others.
- */
+import { formatAlertMessage as formatAlert } from "./formatter.js";
 export class AlertDispatcher {
-    channels = [];
+    channels;
     logger;
     diagnosisHint;
     constructor(opts) {
-        this.channels = opts.channels ?? [];
+        this.channels = opts.channels ? [...opts.channels] : [];
         this.logger = opts.logger ?? console;
-        this.diagnosisHint = opts.diagnosisHint;
+        this.diagnosisHint = opts.diagnosisHint ?? "";
     }
-    /** Add a channel at runtime. */
     addChannel(channel) {
         this.channels.push(channel);
     }
-    /** Send an alert to all registered channels. */
+    get hasChannels() { return this.channels.length > 0; }
+    get channelCount() { return this.channels.length; }
     async dispatch(alert) {
         if (this.channels.length === 0)
             return;
-        const formatted = formatAlertMessage(alert, {
-            diagnosisHint: this.diagnosisHint,
-        });
-        const results = this.channels.map(async (ch) => {
-            try {
-                await ch.send(alert, formatted);
-            }
-            catch (err) {
-                this.logger.error(`[openalerts] alert channel "${ch.name}" failed: ${String(err)}`);
-            }
-        });
-        await Promise.allSettled(results);
-    }
-    /** Whether any channels are registered. */
-    get hasChannels() {
-        return this.channels.length > 0;
-    }
-    /** Number of registered channels. */
-    get channelCount() {
-        return this.channels.length;
+        const formatted = formatAlert(alert, { diagnosisHint: this.diagnosisHint });
+        await Promise.allSettled(this.channels.map(ch => Promise.resolve(ch.send(alert, formatted)).catch(err => this.logger.warn(`[channel:${ch.name}] send failed: ${String(err)}`))));
     }
 }
+//# sourceMappingURL=alert-channel.js.map

package/dist/core/alert-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-channel.js","sourceRoot":"","sources":["../../src/core/alert-channel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAiB;IACzB,MAAM,CAAmB;IACzB,aAAa,CAAS;IAE9B,YAAY,IAAsF;QAChG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,UAAU,CAAC,OAAqB;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,WAAW,KAAc,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,YAAY,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3D,KAAK,CAAC,QAAQ,CAAC,KAAiB;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACvC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC5E,MAAM,OAAO,CAAC,UAAU,CACtB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CACrB,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CACrE,CACF,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/bounded-map.d.ts

@@ -49,3 +49,4 @@ export declare class BoundedMap<K extends string, V> {
     /** Evict oldest (least recently used) entry */
     private evictOldest;
 }
+//# sourceMappingURL=bounded-map.d.ts.map

package/dist/core/bounded-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-map.d.ts","sourceRoot":"","sources":["../../src/core/bounded-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAQF,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC;IAM7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;gBAEO,OAAO,EAAE,iBAAiB;IAMvD,kBAAkB;IAClB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAkB3B,kBAAkB;IAClB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAwB1B,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAgBpB,mBAAmB;IACnB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAQvB,wBAAwB;IACxB,KAAK,IAAI,IAAI;IASb,uBAAuB;IACvB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mBAAmB;IACnB,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI3B,qBAAqB;IACrB,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI7B,sBAAsB;IACtB,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAInC,gBAAgB;IAChB,QAAQ,IAAI,eAAe;IAU3B,+CAA+C;IAC/C,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/core/bounded-map.js

@@ -126,3 +126,4 @@ export class BoundedMap {
         }
     }
 }
+//# sourceMappingURL=bounded-map.js.map

package/dist/core/bounded-map.js.map

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

package/dist/core/engine.d.ts

@@ -1,48 +1,36 @@
 import { OpenAlertsEventBus } from "./event-bus.js";
 import { type AlertEvent, type EvaluatorState, type OpenAlertsEvent, type OpenAlertsInitOptions, type StoredEvent } from "./types.js";
-/**
- * OpenAlertsEngine — central orchestrator for monitoring and alerting.
- *
- * Framework-agnostic. Adapters (OpenClaw, Nanobot, LangChain, etc.)
- * translate their events into OpenAlertsEvent and feed them to `ingest()`.
- */
+import type { DatabaseSync } from "node:sqlite";
 export declare class OpenAlertsEngine {
     readonly bus: OpenAlertsEventBus;
     readonly state: EvaluatorState;
     private config;
     private stateDir;
     private dispatcher;
-    private platform;
     private enricher;
     private logger;
     private logPrefix;
+    private db;
     private watchdogTimer;
     private pruneTimer;
     private running;
     private eventRing;
     private static readonly RING_MAX;
-    constructor(options: OpenAlertsInitOptions);
-    /** Start the engine: warm from history, start timers. */
+    constructor(options: OpenAlertsInitOptions & {
+        db?: DatabaseSync | null;
+    });
     start(): void;
-    /** Ingest a universal event. Can be called directly or via the event bus. */
     ingest(event: OpenAlertsEvent): void;
-    /** Stop the engine: clear timers, flush platform, clear bus. */
     stop(): void;
-    /** Add a channel at runtime (e.g., after detecting available transports). */
     addChannel(channel: {
         readonly name: string;
         send(alert: AlertEvent, formatted: string): Promise<void> | void;
     }): void;
-    /** Fire a test alert to verify delivery. */
     sendTestAlert(): void;
-    /** Whether the platform sync is connected. */
-    get platformConnected(): boolean;
-    /** Whether the engine is running. */
     get isRunning(): boolean;
-    /** Read recent stored events (for /alerts command). */
     getRecentEvents(limit?: number): StoredEvent[];
-    /** Get recent full events from the in-memory ring buffer (for dashboard history). */
     getRecentLiveEvents(limit?: number): OpenAlertsEvent[];
     private handleEvent;
     private fireAlert;
 }
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIpD,OAAO,EAEL,KAAK,UAAU,EAEf,KAAK,cAAc,EAEnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAE1B,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,EAAE,CAAsB;IAEhC,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAO;gBAE3B,OAAO,EAAE,qBAAqB,GAAG;QAAE,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE;IAmBzE,KAAK,IAAI,IAAI;IAoCb,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAEpC,IAAI,IAAI,IAAI;IASZ,UAAU,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAItH,aAAa,IAAI,IAAI;IAUrB,IAAI,SAAS,IAAI,OAAO,CAAyB;IAEjD,eAAe,CAAC,KAAK,SAAM,GAAG,WAAW,EAAE;IAC3C,mBAAmB,CAAC,KAAK,SAAM,GAAG,eAAe,EAAE;IAEnD,OAAO,CAAC,WAAW;YAgCL,SAAS;CA8BxB"}