@steadwing/openalerts 0.2.5 → 0.2.6

package/dist/collections/types.d.ts

@@ -1,177 +0,0 @@
-export interface MonitorSession {
-    key: string;
-    agentId: string;
-    platform: string;
-    recipient: string;
-    isGroup: boolean;
-    lastActivityAt: number;
-    status: "idle" | "active" | "thinking";
-    spawnedBy?: string;
-    messageCount?: number;
-    totalCostUsd?: number;
-    totalInputTokens?: number;
-    totalOutputTokens?: number;
-}
-export type MonitorActionType = "start" | "streaming" | "complete" | "aborted" | "error" | "tool_call" | "tool_result";
-export type MonitorActionEventType = "chat" | "agent" | "system";
-export interface MonitorAction {
-    id: string;
-    runId: string;
-    sessionKey: string;
-    seq: number;
-    type: MonitorActionType;
-    eventType: MonitorActionEventType;
-    timestamp: number;
-    content?: string;
-    toolName?: string;
-    toolArgs?: unknown;
-    startedAt?: number;
-    endedAt?: number;
-    duration?: number;
-    inputTokens?: number;
-    outputTokens?: number;
-    stopReason?: string;
-    costUsd?: number;
-    model?: string;
-    provider?: string;
-}
-export type MonitorExecEventType = "started" | "output" | "completed";
-export type MonitorExecProcessStatus = "running" | "completed" | "failed";
-export interface MonitorExecOutputChunk {
-    id: string;
-    stream: "stdout" | "stderr" | string;
-    text: string;
-    timestamp: number;
-}
-export interface MonitorExecEvent {
-    id: string;
-    execId: string;
-    runId: string;
-    pid: number;
-    sessionId?: string;
-    sessionKey?: string;
-    eventType: MonitorExecEventType;
-    command?: string;
-    stream?: "stdout" | "stderr" | string;
-    output?: string;
-    startedAt?: number;
-    durationMs?: number;
-    exitCode?: number;
-    status?: string;
-    timestamp: number;
-}
-export interface MonitorExecProcess {
-    id: string;
-    runId: string;
-    pid: number;
-    command: string;
-    sessionId?: string;
-    sessionKey?: string;
-    status: MonitorExecProcessStatus;
-    startedAt: number;
-    completedAt?: number;
-    durationMs?: number;
-    exitCode?: number;
-    outputs: MonitorExecOutputChunk[];
-    outputTruncated?: boolean;
-    timestamp: number;
-    lastActivityAt: number;
-}
-export interface ChatEvent {
-    runId: string;
-    sessionKey: string;
-    seq: number;
-    state: "delta" | "final" | "aborted" | "error";
-    message?: unknown;
-    errorMessage?: string;
-    usage?: {
-        inputTokens?: number;
-        outputTokens?: number;
-    };
-    stopReason?: string;
-}
-export interface AgentEvent {
-    runId: string;
-    seq: number;
-    stream: string;
-    ts: number;
-    data: Record<string, unknown>;
-    sessionKey?: string;
-}
-export interface ExecStartedEvent {
-    pid: number;
-    command: string;
-    sessionId: string;
-    runId: string;
-    startedAt: number;
-}
-export interface ExecOutputEvent {
-    pid: number;
-    runId: string;
-    sessionId?: string;
-    stream: "stdout" | "stderr" | string;
-    output: string;
-}
-export interface ExecCompletedEvent {
-    pid: number;
-    runId: string;
-    sessionId?: string;
-    exitCode: number;
-    durationMs: number;
-    status: string;
-}
-export declare function parseSessionKey(key: string): {
-    agentId: string;
-    platform: string;
-    recipient: string;
-    isGroup: boolean;
-};
-export interface CollectionStats {
-    sessions: number;
-    actions: number;
-    execs: number;
-    runSessionMapSize: number;
-    totalCostUsd?: number;
-}
-export interface DiagnosticUsageEvent {
-    type: "model.usage";
-    ts: number;
-    seq: number;
-    sessionKey?: string;
-    sessionId?: string;
-    channel?: string;
-    provider?: string;
-    model?: string;
-    usage: {
-        input?: number;
-        output?: number;
-        cacheRead?: number;
-        cacheWrite?: number;
-        promptTokens?: number;
-        total?: number;
-    };
-    context?: {
-        limit?: number;
-        used?: number;
-    };
-    costUsd?: number;
-    durationMs?: number;
-}
-export interface CostUsageTotals {
-    input: number;
-    output: number;
-    cacheRead: number;
-    cacheWrite: number;
-    totalTokens: number;
-    totalCost: number;
-    inputCost: number;
-    outputCost: number;
-    cacheReadCost: number;
-    cacheWriteCost: number;
-    missingCostEntries: number;
-}
-export interface CostUsageSummary {
-    totals: CostUsageTotals;
-    byModel?: Record<string, CostUsageTotals>;
-    bySession?: Record<string, CostUsageTotals>;
-}

package/dist/collections/types.js

@@ -1,15 +0,0 @@
-// ─── Session Types ───────────────────────────────────────────────────────────
-// ─── Utility Functions ───────────────────────────────────────────────────────
-export function parseSessionKey(key) {
-    // Format: "agent:main:discord:channel:1234567890"
-    // Or: "agent:main:telegram:group:12345"
-    // Or: "agent:main:whatsapp:+1234567890"
-    const parts = key.split(":");
-    const agentId = parts[1] || "unknown";
-    const platform = parts[2] || "unknown";
-    // Check if 4th part indicates a type (channel, group, dm, etc)
-    const hasType = ["channel", "group", "dm", "thread"].includes(parts[3] || "");
-    const isGroup = parts[3] === "group" || parts[3] === "channel";
-    const recipient = hasType ? parts.slice(3).join(":") : parts.slice(3).join(":");
-    return { agentId, platform, recipient, isGroup };
-}

package/dist/core/index.d.ts

@@ -1,13 +0,0 @@
-export type { AlertChannel, AlertEnricher, AlertEvent, AlertRuleDefinition, AlertSeverity, AlertTarget, DiagnosticSnapshot, EvaluatorState, HeartbeatSnapshot, MonitorConfig, RuleContext, RuleOverride, OpenAlertsEvent, OpenAlertsEventType, OpenAlertsInitOptions, OpenAlertsLogger, StoredEvent, WindowEntry, } from "./types.js";
-export { DEFAULTS, LOG_FILENAME, STORE_DIR_NAME } from "./types.js";
-export { OpenAlertsEngine } from "./engine.js";
-export { OpenAlertsEventBus } from "./event-bus.js";
-export { AlertDispatcher } from "./alert-channel.js";
-export { createEvaluatorState, processEvent, processWatchdogTick, warmFromHistory, } from "./evaluator.js";
-export { ALL_RULES } from "./rules.js";
-export { appendEvent, pruneLog, readAllEvents, readRecentEvents, } from "./store.js";
-export { createLlmEnricher, type LlmEnricherOptions } from "./llm-enrichment.js";
-export { formatAlertMessage, formatAlertsOutput, formatHealthOutput, } from "./formatter.js";
-export { createPlatformSync, type PlatformSync } from "./platform.js";
-export { BoundedMap, type BoundedMapOptions, type BoundedMapStats, } from "./bounded-map.js";
-export type { MonitorSession, MonitorActionType, MonitorActionEventType, MonitorAction, MonitorExecEventType, MonitorExecProcessStatus, MonitorExecOutputChunk, MonitorExecEvent, MonitorExecProcess, CollectionStats, DiagnosticUsageEvent, CostUsageTotals, CostUsageSummary, } from "../collections/types.js";

package/dist/core/index.js

@@ -1,23 +0,0 @@
-// OpenAlerts core — engine, rules, evaluator, store
-// Constants
-export { DEFAULTS, LOG_FILENAME, STORE_DIR_NAME } from "./types.js";
-// Engine
-export { OpenAlertsEngine } from "./engine.js";
-// Event Bus
-export { OpenAlertsEventBus } from "./event-bus.js";
-// Alert Dispatcher
-export { AlertDispatcher } from "./alert-channel.js";
-// Evaluator
-export { createEvaluatorState, processEvent, processWatchdogTick, warmFromHistory, } from "./evaluator.js";
-// Rules
-export { ALL_RULES } from "./rules.js";
-// Store
-export { appendEvent, pruneLog, readAllEvents, readRecentEvents, } from "./store.js";
-// LLM Enrichment
-export { createLlmEnricher } from "./llm-enrichment.js";
-// Formatter
-export { formatAlertMessage, formatAlertsOutput, formatHealthOutput, } from "./formatter.js";
-// Platform
-export { createPlatformSync } from "./platform.js";
-// Bounded Map
-export { BoundedMap, } from "./bounded-map.js";

package/dist/core/llm-enrichment.d.ts

@@ -1,21 +0,0 @@
-import type { AlertEnricher, OpenAlertsLogger } from "./types.js";
-export type LlmEnricherOptions = {
-    /** Model string from config, e.g. "openai/gpt-5-nano" */
-    modelString: string;
-    /** Pre-resolved API key (caller reads from env to avoid env+fetch in same file) */
-    apiKey: string;
-    /** Logger for debug/warn messages */
-    logger?: OpenAlertsLogger;
-    /** Timeout in ms (default: 10000) */
-    timeoutMs?: number;
-};
-/**
- * Resolve the environment variable name for a given model string's provider.
- * Returns null if the model string is invalid or the provider is unknown.
- */
-export declare function resolveApiKeyEnvVar(modelString: string): string | null;
-/**
- * Create an AlertEnricher that calls an LLM to add a summary + action to alerts.
- * Returns null if provider can't be resolved.
- */
-export declare function createLlmEnricher(opts: LlmEnricherOptions): AlertEnricher | null;

package/dist/core/llm-enrichment.js

@@ -1,180 +0,0 @@
-const PROVIDER_MAP = {
-    openai: {
-        type: "openai-compatible",
-        baseUrl: "https://api.openai.com/v1",
-        apiKeyEnvVar: "OPENAI_API_KEY",
-    },
-    groq: {
-        type: "openai-compatible",
-        baseUrl: "https://api.groq.com/openai/v1",
-        apiKeyEnvVar: "GROQ_API_KEY",
-    },
-    together: {
-        type: "openai-compatible",
-        baseUrl: "https://api.together.xyz/v1",
-        apiKeyEnvVar: "TOGETHER_API_KEY",
-    },
-    deepseek: {
-        type: "openai-compatible",
-        baseUrl: "https://api.deepseek.com/v1",
-        apiKeyEnvVar: "DEEPSEEK_API_KEY",
-    },
-    anthropic: {
-        type: "anthropic",
-        baseUrl: "https://api.anthropic.com/v1",
-        apiKeyEnvVar: "ANTHROPIC_API_KEY",
-    },
-};
-// ─── Prompt ─────────────────────────────────────────────────────────────────
-function buildPrompt(alert) {
-    return `You are a concise DevOps alert analyst. Given this monitoring alert, provide:
-1. A brief human-friendly summary (1 sentence, plain language)
-2. One actionable suggestion to resolve it
-
-Alert:
-- Rule: ${alert.ruleId}
-- Severity: ${alert.severity}
-- Title: ${alert.title}
-- Detail: ${alert.detail}
-
-Reply in exactly this format (2 lines only):
-Summary: <your summary>
-Action: <your suggestion>`;
-}
-// ─── Response Parsing ───────────────────────────────────────────────────────
-function parseEnrichment(text) {
-    const lines = text.trim().split("\n");
-    let summary = "";
-    let action = "";
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed.toLowerCase().startsWith("summary:")) {
-            summary = trimmed.slice("summary:".length).trim();
-        }
-        else if (trimmed.toLowerCase().startsWith("action:")) {
-            action = trimmed.slice("action:".length).trim();
-        }
-    }
-    if (!summary && !action)
-        return null;
-    return { summary, action };
-}
-// ─── HTTP Calls ─────────────────────────────────────────────────────────────
-async function callOpenAICompatible(baseUrl, apiKey, model, prompt, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const res = await fetch(`${baseUrl}/chat/completions`, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: `Bearer ${apiKey}`,
-            },
-            body: JSON.stringify({
-                model,
-                messages: [{ role: "user", content: prompt }],
-                max_tokens: 200,
-                temperature: 0.3,
-            }),
-            signal: controller.signal,
-        });
-        if (!res.ok)
-            return null;
-        const data = (await res.json());
-        return data.choices?.[0]?.message?.content ?? null;
-    }
-    catch {
-        return null;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-async function callAnthropic(baseUrl, apiKey, model, prompt, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const res = await fetch(`${baseUrl}/messages`, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                "x-api-key": apiKey,
-                "anthropic-version": "2023-06-01",
-            },
-            body: JSON.stringify({
-                model,
-                max_tokens: 200,
-                messages: [{ role: "user", content: prompt }],
-            }),
-            signal: controller.signal,
-        });
-        if (!res.ok)
-            return null;
-        const data = (await res.json());
-        const textBlock = data.content?.find((b) => b.type === "text");
-        return textBlock?.text ?? null;
-    }
-    catch {
-        return null;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-// ─── Factory ────────────────────────────────────────────────────────────────
-/**
- * Resolve the environment variable name for a given model string's provider.
- * Returns null if the model string is invalid or the provider is unknown.
- */
-export function resolveApiKeyEnvVar(modelString) {
-    const slashIdx = modelString.indexOf("/");
-    if (slashIdx < 1)
-        return null;
-    const providerKey = modelString.slice(0, slashIdx).toLowerCase();
-    return PROVIDER_MAP[providerKey]?.apiKeyEnvVar ?? null;
-}
-/**
- * Create an AlertEnricher that calls an LLM to add a summary + action to alerts.
- * Returns null if provider can't be resolved.
- */
-export function createLlmEnricher(opts) {
-    const { modelString, apiKey, logger, timeoutMs = 10_000 } = opts;
-    // Parse "provider/model-name" format
-    const slashIdx = modelString.indexOf("/");
-    if (slashIdx < 1) {
-        logger?.warn(`openalerts: llm-enrichment skipped — invalid model string "${modelString}"`);
-        return null;
-    }
-    const providerKey = modelString.slice(0, slashIdx).toLowerCase();
-    const model = modelString.slice(slashIdx + 1);
-    const providerConfig = PROVIDER_MAP[providerKey];
-    if (!providerConfig) {
-        logger?.warn(`openalerts: llm-enrichment skipped — unknown provider "${providerKey}"`);
-        return null;
-    }
-    logger?.info(`openalerts: llm-enrichment enabled (${providerKey}/${model})`);
-    return async (alert) => {
-        const prompt = buildPrompt(alert);
-        let responseText = null;
-        if (providerConfig.type === "anthropic") {
-            responseText = await callAnthropic(providerConfig.baseUrl, apiKey, model, prompt, timeoutMs);
-        }
-        else {
-            responseText = await callOpenAICompatible(providerConfig.baseUrl, apiKey, model, prompt, timeoutMs);
-        }
-        if (!responseText)
-            return null;
-        const parsed = parseEnrichment(responseText);
-        if (!parsed)
-            return null;
-        // Append enrichment to the original detail
-        let enrichedDetail = alert.detail;
-        if (parsed.summary) {
-            enrichedDetail += `\n\nSummary: ${parsed.summary}`;
-        }
-        if (parsed.action) {
-            enrichedDetail += `\nAction: ${parsed.action}`;
-        }
-        return { ...alert, detail: enrichedDetail };
-    };
-}

package/dist/core/platform.d.ts

@@ -1,17 +0,0 @@
-import { type OpenAlertsLogger, type StoredEvent } from "./types.js";
-export type PlatformSync = {
-    enqueue: (event: StoredEvent) => void;
-    flush: () => Promise<void>;
-    stop: () => void;
-    isConnected: () => boolean;
-};
-/**
- * Create a platform sync instance that batches events and pushes them
- * to the OpenAlerts backend API. Only active when apiKey is provided.
- */
-export declare function createPlatformSync(opts: {
-    apiKey: string;
-    baseUrl?: string;
-    logger: OpenAlertsLogger;
-    logPrefix?: string;
-}): PlatformSync;

package/dist/core/platform.js

@@ -1,93 +0,0 @@
-import { DEFAULTS } from "./types.js";
-/**
- * Create a platform sync instance that batches events and pushes them
- * to the OpenAlerts backend API. Only active when apiKey is provided.
- */
-export function createPlatformSync(opts) {
-    const { apiKey, logger } = opts;
-    const baseUrl = opts.baseUrl?.replace(/\/+$/, "") ?? "https://api.openalerts.dev";
-    const prefix = opts.logPrefix ?? "openalerts";
-    let batch = [];
-    let flushTimer = null;
-    let disabled = false;
-    let connected = true;
-    // Start periodic flush
-    flushTimer = setInterval(() => {
-        void doFlush().catch(() => { });
-    }, DEFAULTS.platformFlushIntervalMs);
-    async function doFlush() {
-        if (disabled || batch.length === 0)
-            return;
-        const events = batch.splice(0, DEFAULTS.platformBatchSize);
-        const body = JSON.stringify({
-            events,
-            plugin_version: "0.1.0",
-            ts: Date.now(),
-        });
-        let lastErr;
-        for (let attempt = 0; attempt < 2; attempt++) {
-            try {
-                const res = await fetch(`${baseUrl}/api/monitor/ingest`, {
-                    method: "POST",
-                    headers: {
-                        "Content-Type": "application/json",
-                        Authorization: `Bearer ${apiKey}`,
-                    },
-                    body,
-                    signal: AbortSignal.timeout(15_000),
-                });
-                if (res.ok) {
-                    connected = true;
-                    return; // Success
-                }
-                if (res.status === 401 || res.status === 403) {
-                    logger.warn(`${prefix}: invalid API key (${res.status}). Platform sync disabled. Check your key at app.openalerts.dev.`);
-                    disabled = true;
-                    connected = false;
-                    return;
-                }
-                lastErr = `HTTP ${res.status}`;
-            }
-            catch (err) {
-                lastErr = err;
-            }
-            // Wait before retry
-            if (attempt < 1) {
-                await new Promise((r) => setTimeout(r, 5000));
-            }
-        }
-        // Failed after retries — put events back and log
-        batch.unshift(...events);
-        // Cap batch to prevent unbounded growth
-        if (batch.length > DEFAULTS.platformBatchSize * 2) {
-            batch = batch.slice(-DEFAULTS.platformBatchSize);
-        }
-        connected = false;
-        logger.warn(`${prefix}: platform sync failed: ${String(lastErr)}`);
-    }
-    return {
-        enqueue(event) {
-            if (disabled)
-                return;
-            batch.push(event);
-            // Auto-flush if batch full
-            if (batch.length >= DEFAULTS.platformBatchSize) {
-                void doFlush().catch(() => { });
-            }
-        },
-        async flush() {
-            await doFlush();
-        },
-        stop() {
-            if (flushTimer) {
-                clearInterval(flushTimer);
-                flushTimer = null;
-            }
-            // Final flush attempt (best-effort, don't await in stop)
-            void doFlush().catch(() => { });
-        },
-        isConnected() {
-            return connected && !disabled;
-        },
-    };
-}

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-declare const plugin: {
-    id: string;
-    name: string;
-    description: string;
-    register(api: OpenClawPluginApi): void;
-};
-export default plugin;