@steadwing/openalerts 0.2.4 → 0.2.6

package/dist/index.js

@@ -1,213 +0,0 @@
-import { OpenAlertsEngine } from "./core/index.js";
-import { onDiagnosticEvent, registerLogTransport } from "openclaw/plugin-sdk";
-import { createLogBridge } from "./plugin/log-bridge.js";
-import { OpenClawAlertChannel, createOpenClawEnricher, parseConfig, resolveAlertTarget, translateOpenClawEvent, translateToolCallHook, translateAgentStartHook, translateAgentEndHook, translateSessionStartHook, translateSessionEndHook, translateMessageSentHook, translateMessageReceivedHook, translateBeforeToolCallHook, translateBeforeCompactionHook, translateAfterCompactionHook, translateMessageSendingHook, translateToolResultPersistHook, translateGatewayStartHook, translateGatewayStopHook, } from "./plugin/adapter.js";
-import { bindEngine, createMonitorCommands } from "./plugin/commands.js";
-import { createDashboardHandler, closeDashboardConnections, } from "./plugin/dashboard-routes.js";
-const PLUGIN_ID = "openalerts";
-const LOG_PREFIX = "openalerts";
-let engine = null;
-let unsubDiagnostic = null;
-let unsubLogTransport = null;
-let logBridgeCleanup = null;
-function createMonitorService(api) {
-    return {
-        id: PLUGIN_ID,
-        async start(ctx) {
-            const logger = ctx.logger;
-            const config = parseConfig(api.pluginConfig);
-            // Resolve alert target + create OpenClaw alert channel
-            const target = await resolveAlertTarget(api, config);
-            const channels = target ? [new OpenClawAlertChannel(api, target)] : [];
-            // Create LLM enricher if enabled (default: false)
-            const enricher = config.llmEnriched === true
-                ? createOpenClawEnricher(api, logger)
-                : null;
-            // Create and start the universal engine
-            engine = new OpenAlertsEngine({
-                stateDir: ctx.stateDir,
-                config,
-                channels,
-                logger,
-                logPrefix: LOG_PREFIX,
-                diagnosisHint: 'Run "openclaw doctor" to diagnose.',
-                enricher: enricher ?? undefined,
-            });
-            engine.start();
-            // Wire commands to engine
-            bindEngine(engine, api);
-            // ── Bridge 1: Diagnostic events → engine ──────────────────────────────
-            // Covers: webhook.*, message.*, session.stuck, session.state,
-            //         model.usage, queue.lane.*, diagnostic.heartbeat, run.attempt
-            unsubDiagnostic = onDiagnosticEvent((event) => {
-                const translated = translateOpenClawEvent(event);
-                if (translated) {
-                    engine.ingest(translated);
-                }
-            });
-            // ── Bridge 2: Log transport → engine (fills gaps from non-firing hooks) ─
-            // Parses structured log records to synthesize tool.call, session.start/end,
-            // and run duration events that hooks don't provide in long-polling mode.
-            const logBridge = createLogBridge(engine);
-            unsubLogTransport = registerLogTransport(logBridge.transport);
-            logBridgeCleanup = logBridge.cleanup;
-            // ── Bridge 3: Plugin hooks → engine ───────────────────────────────────
-            // Covers: tool calls, agent lifecycle, session lifecycle, gateway, messages
-            // These events are NOT emitted as diagnostic events — they come through
-            // the plugin hook system (api.on).
-            const apiOn = api.on?.bind(api);
-            if (apiOn) {
-                // Tool execution tracking
-                apiOn("after_tool_call", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateToolCallHook(data, {
-                        sessionId: hookCtx.sessionId,
-                        agentId: hookCtx.agentId,
-                    }));
-                });
-                // Agent lifecycle
-                apiOn("before_agent_start", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateAgentStartHook(data, {
-                        sessionId: hookCtx.sessionId,
-                        agentId: hookCtx.agentId,
-                    }));
-                });
-                apiOn("agent_end", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateAgentEndHook(data, {
-                        sessionId: hookCtx.sessionId,
-                        agentId: hookCtx.agentId,
-                    }));
-                });
-                // Session lifecycle
-                apiOn("session_start", (data) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateSessionStartHook(data));
-                });
-                apiOn("session_end", (data) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateSessionEndHook(data));
-                });
-                // Message delivery tracking (all messages — success and failure)
-                apiOn("message_sent", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    const d = data;
-                    engine.ingest(translateMessageSentHook(d, {
-                        channel: hookCtx.channel,
-                        sessionId: hookCtx.sessionId,
-                    }));
-                });
-                // Inbound message tracking (fires reliably in all modes)
-                apiOn("message_received", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateMessageReceivedHook(data, {
-                        channelId: hookCtx.channelId,
-                        accountId: hookCtx.accountId,
-                    }));
-                });
-                // Tool start tracking (fires reliably — complements log-bridge tool end)
-                apiOn("before_tool_call", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateBeforeToolCallHook(data, {
-                        sessionId: hookCtx.sessionId,
-                        agentId: hookCtx.agentId,
-                    }));
-                });
-                // Tool result persistence tracking
-                apiOn("tool_result_persist", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateToolResultPersistHook(data, {
-                        sessionKey: hookCtx.sessionKey,
-                        agentId: hookCtx.agentId,
-                        toolName: hookCtx.toolName,
-                    }));
-                });
-                // Compaction lifecycle (before + after)
-                apiOn("before_compaction", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateBeforeCompactionHook(data, {
-                        sessionKey: hookCtx.sessionKey,
-                        agentId: hookCtx.agentId,
-                    }));
-                });
-                apiOn("after_compaction", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateAfterCompactionHook(data, {
-                        sessionKey: hookCtx.sessionKey,
-                        agentId: hookCtx.agentId,
-                    }));
-                });
-                // Pre-send message tracking (fires before message_sent)
-                apiOn("message_sending", (data, hookCtx) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateMessageSendingHook(data, {
-                        channelId: hookCtx.channelId,
-                        accountId: hookCtx.accountId,
-                    }));
-                });
-                // Gateway lifecycle
-                apiOn("gateway_start", (data) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateGatewayStartHook(data));
-                });
-                apiOn("gateway_stop", (data) => {
-                    if (!engine)
-                        return;
-                    engine.ingest(translateGatewayStopHook(data));
-                });
-                logger.info(`${LOG_PREFIX}: subscribed to 13 plugin hooks (100% coverage: tool, agent, session, gateway, message, compaction)`);
-            }
-            const targetDesc = target
-                ? `alerting to ${target.channel}:${target.to}`
-                : "log-only (no alert channel detected)";
-            logger.info(`${LOG_PREFIX}: started, ${targetDesc}, log-bridge active, 8 rules active`);
-        },
-        stop() {
-            closeDashboardConnections();
-            if (unsubLogTransport) {
-                unsubLogTransport();
-                unsubLogTransport = null;
-            }
-            if (logBridgeCleanup) {
-                logBridgeCleanup();
-                logBridgeCleanup = null;
-            }
-            if (unsubDiagnostic) {
-                unsubDiagnostic();
-                unsubDiagnostic = null;
-            }
-            if (engine) {
-                engine.stop();
-                engine = null;
-            }
-        },
-    };
-}
-const plugin = {
-    id: PLUGIN_ID,
-    name: "OpenAlerts",
-    description: "Alerting & monitoring — texts you when your bot is sick",
-    register(api) {
-        api.registerService(createMonitorService(api));
-        for (const cmd of createMonitorCommands(api)) {
-            api.registerCommand(cmd);
-        }
-        // Register dashboard HTTP routes under /openalerts*
-        api.registerHttpHandler(createDashboardHandler(() => engine));
-    },
-};
-export default plugin;

package/dist/plugin/adapter.d.ts

@@ -1,150 +0,0 @@
-import type { AlertChannel, AlertEnricher, AlertEvent, AlertTarget, MonitorConfig, OpenAlertsEvent } from "../core/index.js";
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-/**
- * Translate an OpenClaw diagnostic event into a universal OpenAlertsEvent.
- * Returns null for unmapped event types.
- */
-export declare function translateOpenClawEvent(event: {
-    type: string;
-    [key: string]: unknown;
-}): OpenAlertsEvent | null;
-/** Translate after_tool_call hook data into OpenAlertsEvent. */
-export declare function translateToolCallHook(data: {
-    toolName: string;
-    params: Record<string, unknown>;
-    result?: unknown;
-    error?: string;
-    durationMs?: number;
-}, context: {
-    sessionId?: string;
-    agentId?: string;
-}): OpenAlertsEvent;
-/** Translate before_agent_start hook data into OpenAlertsEvent. */
-export declare function translateAgentStartHook(data: {
-    prompt: string;
-    messages?: unknown[];
-}, context: {
-    sessionId?: string;
-    agentId?: string;
-}): OpenAlertsEvent;
-/** Translate agent_end hook data into OpenAlertsEvent. */
-export declare function translateAgentEndHook(data: {
-    messages: unknown[];
-    success: boolean;
-    error?: string;
-    durationMs?: number;
-}, context: {
-    sessionId?: string;
-    agentId?: string;
-}): OpenAlertsEvent;
-/** Translate session_start hook data into OpenAlertsEvent. */
-export declare function translateSessionStartHook(data: {
-    sessionId: string;
-    resumedFrom?: string;
-}): OpenAlertsEvent;
-/** Translate session_end hook data into OpenAlertsEvent. */
-export declare function translateSessionEndHook(data: {
-    sessionId: string;
-    messageCount: number;
-    durationMs?: number;
-}): OpenAlertsEvent;
-/** Translate message_sent hook data into OpenAlertsEvent (delivery tracking). */
-export declare function translateMessageSentHook(data: {
-    to: string;
-    content: string;
-    success: boolean;
-    error?: string;
-}, context: {
-    channel?: string;
-    sessionId?: string;
-}): OpenAlertsEvent;
-/** Translate gateway_start hook data into OpenAlertsEvent. */
-export declare function translateGatewayStartHook(data: {
-    port: number;
-}): OpenAlertsEvent;
-/** Translate gateway_stop hook data into OpenAlertsEvent. */
-export declare function translateGatewayStopHook(data: {
-    reason?: string;
-}): OpenAlertsEvent;
-/** Translate message_received hook data into OpenAlertsEvent (inbound tracking). */
-export declare function translateMessageReceivedHook(data: {
-    from: string;
-    content: string;
-    timestamp?: number;
-    metadata?: Record<string, unknown>;
-}, context: {
-    channelId?: string;
-    accountId?: string;
-}): OpenAlertsEvent;
-/** Translate before_tool_call hook data into OpenAlertsEvent (tool start tracking). */
-export declare function translateBeforeToolCallHook(data: {
-    toolName: string;
-    params: Record<string, unknown>;
-}, context: {
-    sessionId?: string;
-    agentId?: string;
-}): OpenAlertsEvent;
-/** Translate before_compaction hook data into OpenAlertsEvent. */
-export declare function translateBeforeCompactionHook(data: {
-    messageCount: number;
-    tokenCount?: number;
-}, context: {
-    sessionKey?: string;
-    agentId?: string;
-}): OpenAlertsEvent;
-/** Translate after_compaction hook data into OpenAlertsEvent. */
-export declare function translateAfterCompactionHook(data: {
-    messageCount: number;
-    tokenCount?: number;
-    compactedCount: number;
-}, context: {
-    sessionKey?: string;
-    agentId?: string;
-}): OpenAlertsEvent;
-/** Translate message_sending hook data into OpenAlertsEvent (pre-send tracking). */
-export declare function translateMessageSendingHook(data: {
-    to: string;
-    content: string;
-    metadata?: Record<string, unknown>;
-}, context: {
-    channelId?: string;
-    accountId?: string;
-}): OpenAlertsEvent;
-/** Translate tool_result_persist hook data into OpenAlertsEvent. */
-export declare function translateToolResultPersistHook(data: {
-    toolName?: string;
-    toolCallId?: string;
-    isSynthetic?: boolean;
-}, context: {
-    sessionKey?: string;
-    agentId?: string;
-    toolName?: string;
-}): OpenAlertsEvent;
-/**
- * AlertChannel that sends through OpenClaw's runtime channel API.
- * Bridges the universal AlertChannel interface to OpenClaw's messaging system.
- */
-export declare class OpenClawAlertChannel implements AlertChannel {
-    readonly name: string;
-    private api;
-    private target;
-    private warnedMissing;
-    constructor(api: OpenClawPluginApi, target: AlertTarget);
-    send(alert: AlertEvent, formatted: string): Promise<void>;
-}
-/**
- * Resolve the alert target from plugin config or by auto-detecting from OpenClaw config.
- */
-export declare function resolveAlertTarget(api: OpenClawPluginApi, pluginConfig: MonitorConfig): Promise<AlertTarget | null>;
-export declare function parseConfig(raw: Record<string, unknown> | undefined): MonitorConfig;
-/**
- * Create an AlertEnricher from the OpenClaw plugin API.
- * Reads the model from api.config.agents.defaults.model.primary (e.g. "openai/gpt-5-nano")
- * and resolves the API key from process.env.
- * Returns null if no model is configured or enricher can't be created.
- */
-export declare function createOpenClawEnricher(api: OpenClawPluginApi, logger?: {
-    info: (msg: string) => void;
-    warn: (msg: string) => void;
-    error: (msg: string) => void;
-}): AlertEnricher | null;