@steadwing/openalerts 0.2.5 → 0.2.6

package/dist/plugin/log-bridge.d.ts

@@ -1,22 +0,0 @@
-import type { OpenAlertsEngine } from "../core/index.js";
-import type { LogTransportRecord } from "openclaw/plugin-sdk";
-/**
- * Create a log-transport bridge that parses structured log records and
- * synthesizes OpenAlertsEvents to fill gaps left by non-firing plugin hooks.
- *
- * Covers:
- * - Tool calls (tool start → tool end, with duration) — fills `after_tool_call` gap
- * - Session lifecycle (idle ↔ processing transitions) — fills `session_start/end` gap
- * - Run prompt duration — enriches session.end with durationMs
- * - Agent run lifecycle — agent start/end at run level
- * - Compaction events — detects costly context compaction
- * - Message delivery — "Committed messaging text" fills `message_sent` gap
- * - Exec commands — attaches elevated commands to tool events
- *
- * Returns the transport function to pass to registerLogTransport().
- * Call the returned cleanup function to release internal state.
- */
-export declare function createLogBridge(engine: OpenAlertsEngine): {
-    transport: (logObj: LogTransportRecord) => void;
-    cleanup: () => void;
-};

package/dist/plugin/log-bridge.js

@@ -1,363 +0,0 @@
-import { BoundedMap } from "../core/index.js";
-// ─── Parsing Helpers ─────────────────────────────────────────────────────────
-const KV_RE = /(\w+)=([\S]+)/g;
-/** Parse key=value pairs from a log message string. */
-function parseKvs(message) {
-    const result = {};
-    let m;
-    KV_RE.lastIndex = 0;
-    while ((m = KV_RE.exec(message)) !== null) {
-        result[m[1]] = m[2];
-    }
-    return result;
-}
-/** Extract subsystem string from field "0" which may be JSON or raw. */
-function extractSubsystem(field0) {
-    if (typeof field0 !== "string")
-        return "";
-    if (field0.startsWith("{")) {
-        try {
-            const parsed = JSON.parse(field0);
-            return typeof parsed.subsystem === "string" ? parsed.subsystem : "";
-        }
-        catch {
-            return "";
-        }
-    }
-    return field0;
-}
-/** Extract timestamp from a log record. */
-function extractTimestamp(logObj) {
-    const meta = logObj._meta;
-    if (meta?.date && typeof meta.date === "string") {
-        const t = new Date(meta.date).getTime();
-        if (!isNaN(t))
-            return t;
-    }
-    if (typeof logObj.time === "string") {
-        const t = new Date(logObj.time).getTime();
-        if (!isNaN(t))
-            return t;
-    }
-    if (typeof logObj.time === "number") {
-        return logObj.time;
-    }
-    return Date.now();
-}
-/** Subsystems the bridge cares about. Everything else is fast-skipped. */
-const WATCHED_SUBSYSTEMS = new Set(["agent/embedded", "diagnostic", "exec"]);
-/**
- * Parse a raw LogTransportRecord into a structured form.
- * Returns null if the record can't be parsed or is from an irrelevant subsystem.
- */
-function parseLogRecord(logObj) {
-    const subsystem = extractSubsystem(logObj["0"]);
-    if (!WATCHED_SUBSYSTEMS.has(subsystem))
-        return null;
-    const message = typeof logObj["1"] === "string" ? logObj["1"] : "";
-    if (!message)
-        return null;
-    return {
-        subsystem,
-        message,
-        ts: extractTimestamp(logObj),
-        kvs: parseKvs(message),
-    };
-}
-// ─── Dedup set with periodic pruning ─────────────────────────────────────────
-const DEDUP_MAX_SIZE = 2000;
-const DEDUP_PRUNE_TARGET = 500;
-/** Prune oldest entries from a dedup set when it grows too large. */
-function pruneDedupeSet(set) {
-    if (set.size <= DEDUP_MAX_SIZE)
-        return;
-    // Set iterates in insertion order; delete oldest entries
-    const toDelete = set.size - DEDUP_PRUNE_TARGET;
-    let deleted = 0;
-    for (const key of set) {
-        if (deleted >= toDelete)
-            break;
-        set.delete(key);
-        deleted++;
-    }
-}
-// ─── Bridge ──────────────────────────────────────────────────────────────────
-/**
- * Create a log-transport bridge that parses structured log records and
- * synthesizes OpenAlertsEvents to fill gaps left by non-firing plugin hooks.
- *
- * Covers:
- * - Tool calls (tool start → tool end, with duration) — fills `after_tool_call` gap
- * - Session lifecycle (idle ↔ processing transitions) — fills `session_start/end` gap
- * - Run prompt duration — enriches session.end with durationMs
- * - Agent run lifecycle — agent start/end at run level
- * - Compaction events — detects costly context compaction
- * - Message delivery — "Committed messaging text" fills `message_sent` gap
- * - Exec commands — attaches elevated commands to tool events
- *
- * Returns the transport function to pass to registerLogTransport().
- * Call the returned cleanup function to release internal state.
- */
-export function createLogBridge(engine) {
-    // ── State ──────────────────────────────────────────────────────────────────
-    // Use bounded maps to prevent memory leaks (max 1000 entries each)
-    const toolFlights = new BoundedMap({ maxSize: 1000 });
-    const sessionStates = new BoundedMap({ maxSize: 500 });
-    const dedupeSet = new Set();
-    let pendingCommand = null;
-    let lastRunDurationMs = null;
-    let pruneCounter = 0;
-    function ingest(event) {
-        engine.ingest(event);
-    }
-    // ── Tool call handling (agent/embedded) ────────────────────────────────────
-    // Fills the `after_tool_call` hook gap (hook is declared but never fires)
-    function handleToolStart(rec) {
-        const { toolCallId, tool, runId } = rec.kvs;
-        if (!toolCallId || !tool)
-            return;
-        toolFlights.set(toolCallId, {
-            tool,
-            runId: runId ?? "",
-            startTs: rec.ts,
-        });
-    }
-    function handleToolEnd(rec) {
-        const { toolCallId, tool, runId } = rec.kvs;
-        if (!toolCallId)
-            return;
-        const dedupeKey = `tool:${toolCallId}`;
-        if (dedupeSet.has(dedupeKey))
-            return;
-        dedupeSet.add(dedupeKey);
-        const flight = toolFlights.get(toolCallId);
-        toolFlights.delete(toolCallId);
-        const durationMs = flight ? rec.ts - flight.startTs : undefined;
-        const toolName = flight?.tool ?? tool ?? "unknown";
-        const event = {
-            type: "tool.call",
-            ts: rec.ts,
-            durationMs,
-            outcome: "success",
-            meta: {
-                toolName,
-                toolCallId,
-                runId: flight?.runId ?? runId,
-                source: "log-bridge",
-            },
-        };
-        if (pendingCommand) {
-            event.meta.command = pendingCommand;
-            pendingCommand = null;
-        }
-        ingest(event);
-    }
-    // ── Session lifecycle handling (diagnostic) ────────────────────────────────
-    // Fills the `session_start/end` hook gap (hooks declared but never fire)
-    function handleSessionState(rec) {
-        const { sessionId, sessionKey, prev, new: newState, reason } = rec.kvs;
-        const sid = sessionId ?? sessionKey;
-        if (!sid || !newState)
-            return;
-        const prevState = prev ?? sessionStates.get(sid);
-        sessionStates.set(sid, newState);
-        // session.start: idle → processing
-        if (newState === "processing" && prevState === "idle") {
-            const startKey = `session:start:${sid}`;
-            if (!dedupeSet.has(startKey)) {
-                dedupeSet.add(startKey);
-                ingest({
-                    type: "session.start",
-                    ts: rec.ts,
-                    sessionKey: sid,
-                    outcome: "success",
-                    meta: { source: "log-bridge" },
-                });
-            }
-        }
-        // session.end: processing → idle with reason=run_completed
-        if (newState === "idle" &&
-            prevState === "processing" &&
-            reason === "run_completed") {
-            const endKey = `session:end:${sid}`;
-            if (!dedupeSet.has(endKey)) {
-                dedupeSet.add(endKey);
-                const event = {
-                    type: "session.end",
-                    ts: rec.ts,
-                    sessionKey: sid,
-                    outcome: "success",
-                    meta: { source: "log-bridge" },
-                };
-                if (lastRunDurationMs !== null) {
-                    event.durationMs = lastRunDurationMs;
-                    lastRunDurationMs = null;
-                }
-                ingest(event);
-            }
-        }
-    }
-    // ── Run prompt duration (agent/embedded) ──────────────────────────────────
-    function handleRunPromptEnd(rec) {
-        const { durationMs } = rec.kvs;
-        if (durationMs) {
-            lastRunDurationMs = parseInt(durationMs, 10) || null;
-        }
-    }
-    // ── Agent run lifecycle (agent/embedded) ──────────────────────────────────
-    // Complements before_agent_start / agent_end hooks with run-level tracking
-    function handleAgentRunStart(rec) {
-        const { runId } = rec.kvs;
-        ingest({
-            type: "custom",
-            ts: rec.ts,
-            outcome: "success",
-            meta: { runId, openclawLog: "agent_run_start", source: "log-bridge" },
-        });
-    }
-    function handleAgentRunEnd(rec) {
-        const { runId } = rec.kvs;
-        ingest({
-            type: "custom",
-            ts: rec.ts,
-            outcome: "success",
-            meta: { runId, openclawLog: "agent_run_end", source: "log-bridge" },
-        });
-    }
-    // ── Compaction (agent/embedded) ───────────────────────────────────────────
-    // OpenClaw compacts when context is full — costly, can lose context.
-    // No hook exists for this. Only available via logs.
-    function handleCompactionStart(rec) {
-        const { runId } = rec.kvs;
-        ingest({
-            type: "custom",
-            ts: rec.ts,
-            outcome: "success",
-            meta: {
-                runId,
-                compaction: true,
-                openclawLog: "compaction_start",
-                source: "log-bridge",
-            },
-        });
-    }
-    function handleCompactionRetry(rec) {
-        const { runId } = rec.kvs;
-        ingest({
-            type: "custom",
-            ts: rec.ts,
-            outcome: "success",
-            meta: {
-                runId,
-                compaction: true,
-                openclawLog: "compaction_retry",
-                source: "log-bridge",
-            },
-        });
-    }
-    // ── Message delivery (agent/embedded) ─────────────────────────────────────
-    // "Committed messaging text" fires when a messaging tool (Telegram, Discord,
-    // etc.) successfully delivers a message. Fills the `message_sent` hook gap.
-    function handleMessageCommitted(rec) {
-        const { tool, len } = rec.kvs;
-        ingest({
-            type: "custom",
-            ts: rec.ts,
-            outcome: "success",
-            meta: {
-                toolName: tool,
-                textLength: len ? parseInt(len, 10) : undefined,
-                openclawLog: "message_committed",
-                source: "log-bridge",
-            },
-        });
-    }
-    // ── Lane task error (diagnostic) ────────────────────────────────────────────
-    // Safety net: catches lane-level errors from diagnostic logs.
-    // The agent_end hook already covers agent errors → llm-errors rule.
-    // This emits as infra.error to avoid double-counting in the llm-errors window
-    // while still ensuring infra-errors fires if the hook path fails.
-    // Format: "lane task error: lane=main durationMs=1 error="Error: ...""
-    function handleLaneTaskError(rec) {
-        const { lane, error: errorMsg } = rec.kvs;
-        const dedupeKey = `lane-error:${lane}:${rec.ts}`;
-        if (dedupeSet.has(dedupeKey))
-            return;
-        dedupeSet.add(dedupeKey);
-        ingest({
-            type: "infra.error",
-            ts: rec.ts,
-            outcome: "error",
-            error: errorMsg,
-            meta: {
-                lane,
-                source: "log-bridge",
-                openclawLog: "lane_task_error",
-            },
-        });
-    }
-    // ── Exec command (exec) ────────────────────────────────────────────────────
-    function handleExecCommand(rec) {
-        pendingCommand = rec.message;
-    }
-    // ── Main transport function ────────────────────────────────────────────────
-    function transport(logObj) {
-        const rec = parseLogRecord(logObj);
-        if (!rec)
-            return;
-        const msg = rec.message;
-        if (rec.subsystem === "agent/embedded") {
-            if (msg.startsWith("embedded run tool start:")) {
-                handleToolStart(rec);
-            }
-            else if (msg.startsWith("embedded run tool end:")) {
-                handleToolEnd(rec);
-            }
-            else if (msg.startsWith("embedded run prompt end:")) {
-                handleRunPromptEnd(rec);
-            }
-            else if (msg.startsWith("embedded run agent start:")) {
-                handleAgentRunStart(rec);
-            }
-            else if (msg.startsWith("embedded run agent end:")) {
-                handleAgentRunEnd(rec);
-            }
-            else if (msg.startsWith("embedded run compaction start:")) {
-                handleCompactionStart(rec);
-            }
-            else if (msg.startsWith("embedded run compaction retry:")) {
-                handleCompactionRetry(rec);
-            }
-            else if (msg.startsWith("Committed messaging text:")) {
-                handleMessageCommitted(rec);
-            }
-        }
-        else if (rec.subsystem === "diagnostic") {
-            if (msg.startsWith("session state:")) {
-                handleSessionState(rec);
-            }
-            else if (msg.startsWith("lane task error:")) {
-                handleLaneTaskError(rec);
-            }
-        }
-        else if (rec.subsystem === "exec") {
-            if (msg.startsWith("elevated command")) {
-                handleExecCommand(rec);
-            }
-        }
-        // Periodic dedup set pruning (check every 100 log records)
-        if (++pruneCounter >= 100) {
-            pruneCounter = 0;
-            pruneDedupeSet(dedupeSet);
-        }
-    }
-    function cleanup() {
-        toolFlights.clear();
-        sessionStates.clear();
-        dedupeSet.clear();
-        pendingCommand = null;
-        lastRunDurationMs = null;
-        pruneCounter = 0;
-    }
-    return { transport, cleanup };
-}

package/openclaw.plugin.json

@@ -1,87 +0,0 @@
-{
-	"id": "openalerts",
-	"configSchema": {
-		"type": "object",
-		"additionalProperties": false,
-		"properties": {
-			"apiKey": { "type": "string" },
-			"alertChannel": { "type": "string" },
-			"alertTo": { "type": "string" },
-			"alertAccountId": { "type": "string" },
-			"cooldownMinutes": { "type": "number", "minimum": 1, "maximum": 1440 },
-			"maxLogSizeKb": { "type": "number", "minimum": 64, "maximum": 10240 },
-			"maxLogAgeDays": { "type": "number", "minimum": 1, "maximum": 90 },
-			"quiet": { "type": "boolean" },
-			"rules": {
-				"type": "object",
-				"properties": {
-					"cost-hourly-spike": {
-						"type": "object",
-						"properties": {
-							"enabled": { "type": "boolean" },
-							"threshold": { "type": "number", "minimum": 0 },
-							"cooldownMinutes": { "type": "number", "minimum": 1 }
-						},
-						"additionalProperties": false
-					},
-					"cost-daily-budget": {
-						"type": "object",
-						"properties": {
-							"enabled": { "type": "boolean" },
-							"threshold": { "type": "number", "minimum": 0 },
-							"cooldownMinutes": { "type": "number", "minimum": 1 }
-						},
-						"additionalProperties": false
-					}
-				},
-				"additionalProperties": {
-					"type": "object",
-					"properties": {
-						"enabled": { "type": "boolean" },
-						"threshold": { "type": "number" },
-						"cooldownMinutes": { "type": "number" }
-					},
-					"additionalProperties": false
-				}
-			}
-		}
-	},
-	"uiHints": {
-		"apiKey": {
-			"label": "OpenAlerts API Key",
-			"sensitive": true,
-			"help": "Optional. Get from app.openalerts.dev. Enables platform diagnosis & dashboard."
-		},
-		"alertChannel": {
-			"label": "Alert Channel",
-			"help": "telegram, discord, slack, etc. Auto-detected if blank."
-		},
-		"alertTo": {
-			"label": "Alert To",
-			"help": "Chat/user ID to send alerts to. Auto-detected from allowFrom if blank."
-		},
-		"alertAccountId": {
-			"label": "Account ID",
-			"help": "For multi-account setups. Default account used if blank.",
-			"advanced": true
-		},
-		"cooldownMinutes": {
-			"label": "Alert Cooldown",
-			"help": "Minimum minutes between repeated alerts of the same type. Default: 15."
-		},
-		"quiet": {
-			"label": "Quiet Mode",
-			"help": "Log alerts to file only — no messages sent to your channels."
-		},
-		"rules.cost-hourly-spike.threshold": {
-			"label": "Hourly Cost Threshold (USD)",
-			"help": "Alert when total LLM spend in the last 60 minutes exceeds this amount. Default: 5.0.",
-			"advanced": true
-		},
-		"rules.cost-daily-budget.threshold": {
-			"label": "Daily Budget Threshold (USD)",
-			"help": "Alert when total LLM spend in the last 24 hours exceeds this amount. Default: 20.0.",
-			"advanced": true
-		}
-	}
-}