@relayplane/proxy 1.5.46 → 1.7.2

package/dist/alerts.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * RelayPlane Cost Alerts & Webhooks
+ *
+ * Alert types: threshold (budget %), anomaly, breach.
+ * Webhook delivery via POST to configured URL.
+ * SQLite storage for alert history.
+ * Alert deduplication per window.
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertManager = exports.DEFAULT_ALERTS_CONFIG = void 0;
+exports.getAlertManager = getAlertManager;
+exports.resetAlertManager = resetAlertManager;
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const fs = __importStar(require("node:fs"));
+// ─── Defaults ────────────────────────────────────────────────────────
+exports.DEFAULT_ALERTS_CONFIG = {
+    enabled: false,
+    cooldownMs: 300_000,
+    maxHistory: 500,
+};
+function openDatabase(dbPath) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.pragma('synchronous = NORMAL');
+    return db;
+}
+// ─── AlertManager ───────────────────────────────────────────────────
+class AlertManager {
+    config;
+    db = null;
+    _initialized = false;
+    // In-memory deduplication: key → last fired timestamp
+    dedup = new Map();
+    // In-memory alert history for when DB is unavailable
+    memoryAlerts = [];
+    alertCounter = 0;
+    constructor(config) {
+        this.config = { ...exports.DEFAULT_ALERTS_CONFIG, ...config };
+    }
+    /** Initialize SQLite storage */
+    init() {
+        if (this._initialized)
+            return;
+        if (!this.config.enabled)
+            return;
+        this._initialized = true;
+        const dir = path.join(os.homedir(), '.relayplane');
+        fs.mkdirSync(dir, { recursive: true });
+        try {
+            const dbPath = path.join(dir, 'alerts.db');
+            this.db = openDatabase(dbPath);
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS alerts (
+          id TEXT PRIMARY KEY,
+          type TEXT NOT NULL,
+          message TEXT NOT NULL,
+          severity TEXT NOT NULL,
+          timestamp INTEGER NOT NULL,
+          data TEXT NOT NULL DEFAULT '{}',
+          delivered INTEGER NOT NULL DEFAULT 0
+        );
+        CREATE INDEX IF NOT EXISTS idx_alerts_timestamp ON alerts(timestamp);
+        CREATE INDEX IF NOT EXISTS idx_alerts_type ON alerts(type);
+      `);
+            // Prune old alerts
+            const cutoff = Date.now() - 7 * 86400_000;
+            this.db.prepare('DELETE FROM alerts WHERE timestamp < ?').run(cutoff);
+        }
+        catch (err) {
+            console.warn('[RelayPlane Alerts] SQLite unavailable, memory-only mode:', err.message);
+            this.db = null;
+        }
+    }
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Fire a threshold alert (budget % crossed)
+     */
+    fireThreshold(threshold, currentPercent, currentSpend, limit) {
+        if (!this.config.enabled)
+            return null;
+        const dedupKey = `threshold:${threshold}`;
+        if (this.isDuplicate(dedupKey))
+            return null;
+        const severity = threshold >= 95 ? 'critical' : threshold >= 80 ? 'warning' : 'info';
+        return this.createAlert('threshold', `Budget ${threshold}% threshold crossed (${currentPercent.toFixed(1)}% used: $${currentSpend.toFixed(2)} / $${limit})`, severity, {
+            threshold, currentPercent, currentSpend, limit,
+        });
+    }
+    /**
+     * Fire an anomaly alert
+     */
+    fireAnomaly(anomaly) {
+        if (!this.config.enabled)
+            return null;
+        const dedupKey = `anomaly:${anomaly.type}`;
+        if (this.isDuplicate(dedupKey))
+            return null;
+        return this.createAlert('anomaly', `Anomaly detected: ${anomaly.message}`, anomaly.severity === 'critical' ? 'critical' : 'warning', {
+            anomalyType: anomaly.type, ...anomaly.data,
+        });
+    }
+    /**
+     * Fire a breach alert (budget limit exceeded)
+     */
+    fireBreach(breachType, currentSpend, limit) {
+        if (!this.config.enabled)
+            return null;
+        const dedupKey = `breach:${breachType}`;
+        if (this.isDuplicate(dedupKey))
+            return null;
+        return this.createAlert('breach', `Budget breach: ${breachType} limit exceeded ($${currentSpend.toFixed(2)} / $${limit})`, 'critical', {
+            breachType, currentSpend, limit,
+        });
+    }
+    /**
+     * Get recent alerts
+     */
+    getRecent(limit = 20) {
+        if (this.db) {
+            const rows = this.db.prepare('SELECT id, type, message, severity, timestamp, data, delivered FROM alerts ORDER BY timestamp DESC LIMIT ?').all(limit);
+            return rows.map(r => ({
+                id: r.id,
+                type: r.type,
+                message: r.message,
+                severity: r.severity,
+                timestamp: r.timestamp,
+                data: JSON.parse(r.data),
+                delivered: r.delivered === 1,
+            }));
+        }
+        return this.memoryAlerts.slice(-limit).reverse();
+    }
+    /**
+     * Get alert count by type
+     */
+    getCounts() {
+        const counts = { threshold: 0, anomaly: 0, breach: 0 };
+        if (this.db) {
+            const rows = this.db.prepare('SELECT type, COUNT(*) as c FROM alerts GROUP BY type').all();
+            for (const r of rows) {
+                if (r.type in counts)
+                    counts[r.type] = r.c;
+            }
+        }
+        else {
+            for (const a of this.memoryAlerts) {
+                counts[a.type]++;
+            }
+        }
+        return counts;
+    }
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    // ─── Private ──────────────────────────────────────────────────────
+    isDuplicate(key) {
+        const last = this.dedup.get(key);
+        if (last && (Date.now() - last) < this.config.cooldownMs) {
+            return true;
+        }
+        this.dedup.set(key, Date.now());
+        return false;
+    }
+    createAlert(type, message, severity, data) {
+        const alert = {
+            id: `alert-${++this.alertCounter}-${Date.now()}`,
+            type,
+            message,
+            severity,
+            timestamp: Date.now(),
+            data,
+            delivered: false,
+        };
+        // Store
+        this.storeAlert(alert);
+        // Deliver webhook (non-blocking)
+        this.deliverWebhook(alert);
+        return alert;
+    }
+    storeAlert(alert) {
+        if (this.db) {
+            this.db.prepare('INSERT INTO alerts (id, type, message, severity, timestamp, data, delivered) VALUES (?, ?, ?, ?, ?, ?, ?)').run(alert.id, alert.type, alert.message, alert.severity, alert.timestamp, JSON.stringify(alert.data), alert.delivered ? 1 : 0);
+            // Prune excess
+            const count = this.db.prepare('SELECT COUNT(*) as c FROM alerts').get().c;
+            if (count > this.config.maxHistory) {
+                this.db.prepare('DELETE FROM alerts WHERE id IN (SELECT id FROM alerts ORDER BY timestamp ASC LIMIT ?)').run(count - this.config.maxHistory);
+            }
+        }
+        else {
+            this.memoryAlerts.push(alert);
+            if (this.memoryAlerts.length > this.config.maxHistory) {
+                this.memoryAlerts.shift();
+            }
+        }
+    }
+    deliverWebhook(alert) {
+        if (!this.config.webhookUrl)
+            return;
+        const url = this.config.webhookUrl;
+        // Fire and forget
+        fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                source: 'relayplane',
+                alert: {
+                    id: alert.id,
+                    type: alert.type,
+                    message: alert.message,
+                    severity: alert.severity,
+                    timestamp: new Date(alert.timestamp).toISOString(),
+                    data: alert.data,
+                },
+            }),
+        }).then(() => {
+            alert.delivered = true;
+            try {
+                if (this.db) {
+                    this.db.prepare('UPDATE alerts SET delivered = 1 WHERE id = ?').run(alert.id);
+                }
+            }
+            catch { /* SQLite failure non-fatal */ }
+        }).catch(() => {
+            // Webhook delivery failure — non-fatal
+        });
+    }
+}
+exports.AlertManager = AlertManager;
+// ─── Singleton ──────────────────────────────────────────────────────
+let _instance = null;
+function getAlertManager(config) {
+    if (!_instance) {
+        _instance = new AlertManager(config);
+    }
+    return _instance;
+}
+function resetAlertManager() {
+    if (_instance) {
+        _instance.close();
+        _instance = null;
+    }
+}
+//# sourceMappingURL=alerts.js.map

package/dist/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmSH,0CAKC;AAED,8CAEC;AA1SD,gDAAkC;AAClC,4CAA8B;AAC9B,4CAA8B;AA2B9B,wEAAwE;AAE3D,QAAA,qBAAqB,GAAiB;IACjD,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,GAAG;CAChB,CAAC;AAcF,SAAS,YAAY,CAAC,MAAc;IAClC,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,uEAAuE;AAEvE,MAAa,YAAY;IACf,MAAM,CAAe;IACrB,EAAE,GAAoB,IAAI,CAAC;IAC3B,YAAY,GAAG,KAAK,CAAC;IAE7B,sDAAsD;IAC9C,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC/C,qDAAqD;IAC7C,YAAY,GAAY,EAAE,CAAC;IAC3B,YAAY,GAAG,CAAC,CAAC;IAEzB,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,6BAAqB,EAAE,GAAG,MAAM,EAAE,CAAC;IACxD,CAAC;IAED,gCAAgC;IAChC,IAAI;QACF,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;QACnD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;OAYZ,CAAC,CAAC;YAEH,mBAAmB;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;YAC1C,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,2DAA2D,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;YAClG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,YAAY,CAAC,MAA6B;QACxC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB,EAAE,cAAsB,EAAE,YAAoB,EAAE,KAAa;QAC1F,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACtC,MAAM,QAAQ,GAAG,aAAa,SAAS,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5C,MAAM,QAAQ,GAAG,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,UAAmB,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,MAAe,CAAC;QAChH,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,SAAS,wBAAwB,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,QAAQ,EAAE;YACrK,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK;SAC/C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAsB;QAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACtC,MAAM,QAAQ,GAAG,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5C,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,qBAAqB,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE;YACnI,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI;SAC3C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB,EAAE,YAAoB,EAAE,KAAa;QAChE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACtC,MAAM,QAAQ,GAAG,UAAU,UAAU,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5C,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,kBAAkB,UAAU,qBAAqB,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,UAAU,EAAE;YACrI,UAAU,EAAE,YAAY,EAAE,KAAK;SAChC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB,EAAE;QAC1B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,4GAA4G,CAC7G,CAAC,GAAG,CAAC,KAAK,CAA+H,CAAC;YAC3I,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAiB;gBACzB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAA2C;gBACvD,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxB,SAAS,EAAE,CAAC,CAAC,SAAS,KAAK,CAAC;aAC7B,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,SAAS;QACP,MAAM,MAAM,GAA8B,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAClF,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC,GAAG,EAAwC,CAAC;YACjI,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM;oBAAE,MAAM,CAAC,CAAC,CAAC,IAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QAAC,CAAC;IACnD,CAAC;IAED,qEAAqE;IAE7D,WAAW,CAAC,GAAW;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,WAAW,CAAC,IAAe,EAAE,OAAe,EAAE,QAAyC,EAAE,IAA6B;QAC5H,MAAM,KAAK,GAAU;YACnB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YAChD,IAAI;YACJ,OAAO;YACP,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI;YACJ,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,QAAQ;QACR,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEvB,iCAAiC;QACjC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,UAAU,CAAC,KAAY;QAC7B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,OAAO,CACb,2GAA2G,CAC5G,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEjI,eAAe;YACf,MAAM,KAAK,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;YAC7F,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,EAAE,CAAC,OAAO,CACb,uFAAuF,CACxF,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,KAAY;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAEnC,kBAAkB;QAClB,KAAK,CAAC,GAAG,EAAE;YACT,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM,EAAE,YAAY;gBACpB,KAAK,EAAE;oBACL,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;oBAClD,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB;aACF,CAAC;SACH,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YACX,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;oBACZ,IAAI,CAAC,EAAG,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,8BAA8B,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,uCAAuC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA/ND,oCA+NC;AAED,uEAAuE;AAEvE,IAAI,SAAS,GAAwB,IAAI,CAAC;AAE1C,SAAgB,eAAe,CAAC,MAA8B;IAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,iBAAiB;IAC/B,IAAI,SAAS,EAAE,CAAC;QAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAAC,SAAS,GAAG,IAAI,CAAC;IAAC,CAAC;AACzD,CAAC"}

package/dist/anomaly.d.ts

@@ -0,0 +1,65 @@
+/**
+ * RelayPlane Anomaly Detection
+ *
+ * Sliding window analysis to detect runaway agent loops and cost spikes.
+ * Maintains an in-memory circular buffer of last 100 requests.
+ *
+ * Detection types:
+ * - Velocity spike: >10x normal request rate in 5-minute window
+ * - Cost acceleration: spend rate doubling every minute
+ * - Repetition detection: same model + similar token count >20 times in 5 min
+ * - Token explosion: single request >$5 estimated cost
+ *
+ * @packageDocumentation
+ */
+export interface AnomalyConfig {
+    enabled: boolean;
+    /** Max requests in 5-minute window before velocity spike (default: 50) */
+    velocityThreshold: number;
+    /** Cost threshold for single request token explosion (default: 5.0 USD) */
+    tokenExplosionUsd: number;
+    /** Same model+token pattern count in 5 min before repetition flag (default: 20) */
+    repetitionThreshold: number;
+    /** Window size in ms for analysis (default: 300000 = 5 min) */
+    windowMs: number;
+}
+export type AnomalyType = 'velocity_spike' | 'cost_acceleration' | 'repetition' | 'token_explosion';
+export interface AnomalyResult {
+    detected: boolean;
+    anomalies: AnomalyDetail[];
+}
+export interface AnomalyDetail {
+    type: AnomalyType;
+    message: string;
+    severity: 'warning' | 'critical';
+    data: Record<string, number | string>;
+}
+export declare const DEFAULT_ANOMALY_CONFIG: AnomalyConfig;
+export declare class AnomalyDetector {
+    private config;
+    private buffer;
+    private readonly maxBufferSize;
+    private minuteBuckets;
+    constructor(config?: Partial<AnomalyConfig>);
+    updateConfig(config: Partial<AnomalyConfig>): void;
+    getConfig(): AnomalyConfig;
+    /**
+     * Record a completed request for analysis.
+     * Call this post-response. Returns anomalies detected.
+     */
+    recordAndAnalyze(entry: {
+        model: string;
+        tokensIn: number;
+        tokensOut: number;
+        costUsd: number;
+    }): AnomalyResult;
+    /** Get current buffer size (for testing) */
+    getBufferSize(): number;
+    /** Clear the buffer */
+    clear(): void;
+    private analyze;
+    private getBaselineRpm;
+}
+export declare function getAnomalyDetector(config?: Partial<AnomalyConfig>): AnomalyDetector;
+export declare function resetAnomalyDetector(): void;
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../src/anomaly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAEpG,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvC;AAYD,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAO;IAGrC,OAAO,CAAC,aAAa,CAAkC;gBAE3C,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAI3C,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIlD,SAAS,IAAI,aAAa;IAI1B;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,aAAa;IA4BjB,4CAA4C;IAC5C,aAAa,IAAI,MAAM;IAIvB,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,OAAO;IA+Ff,OAAO,CAAC,cAAc;CAQvB;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,eAAe,CAKnF;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/anomaly.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * RelayPlane Anomaly Detection
+ *
+ * Sliding window analysis to detect runaway agent loops and cost spikes.
+ * Maintains an in-memory circular buffer of last 100 requests.
+ *
+ * Detection types:
+ * - Velocity spike: >10x normal request rate in 5-minute window
+ * - Cost acceleration: spend rate doubling every minute
+ * - Repetition detection: same model + similar token count >20 times in 5 min
+ * - Token explosion: single request >$5 estimated cost
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnomalyDetector = exports.DEFAULT_ANOMALY_CONFIG = void 0;
+exports.getAnomalyDetector = getAnomalyDetector;
+exports.resetAnomalyDetector = resetAnomalyDetector;
+// ─── Defaults ────────────────────────────────────────────────────────
+exports.DEFAULT_ANOMALY_CONFIG = {
+    enabled: false,
+    velocityThreshold: 50,
+    tokenExplosionUsd: 5.0,
+    repetitionThreshold: 20,
+    windowMs: 300_000,
+};
+// ─── AnomalyDetector ────────────────────────────────────────────────
+class AnomalyDetector {
+    config;
+    buffer = [];
+    maxBufferSize = 100;
+    // Baseline: rolling average requests per minute over last hour
+    minuteBuckets = new Map();
+    constructor(config) {
+        this.config = { ...exports.DEFAULT_ANOMALY_CONFIG, ...config };
+    }
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Record a completed request for analysis.
+     * Call this post-response. Returns anomalies detected.
+     */
+    recordAndAnalyze(entry) {
+        if (!this.config.enabled) {
+            return { detected: false, anomalies: [] };
+        }
+        const record = {
+            ...entry,
+            timestamp: Date.now(),
+        };
+        // Add to circular buffer
+        this.buffer.push(record);
+        if (this.buffer.length > this.maxBufferSize) {
+            this.buffer.shift();
+        }
+        // Track minute buckets for baseline
+        const minuteKey = Math.floor(record.timestamp / 60_000);
+        this.minuteBuckets.set(minuteKey, (this.minuteBuckets.get(minuteKey) ?? 0) + 1);
+        // Cleanup old buckets (keep last 60 minutes)
+        const cutoff = minuteKey - 60;
+        for (const [key] of this.minuteBuckets) {
+            if (key < cutoff)
+                this.minuteBuckets.delete(key);
+        }
+        return this.analyze(record);
+    }
+    /** Get current buffer size (for testing) */
+    getBufferSize() {
+        return this.buffer.length;
+    }
+    /** Clear the buffer */
+    clear() {
+        this.buffer = [];
+        this.minuteBuckets.clear();
+    }
+    // ─── Private ──────────────────────────────────────────────────────
+    analyze(current) {
+        const anomalies = [];
+        const now = current.timestamp;
+        const windowStart = now - this.config.windowMs;
+        const recent = this.buffer.filter(r => r.timestamp >= windowStart);
+        // 1. Token explosion — single request cost
+        if (current.costUsd > this.config.tokenExplosionUsd) {
+            anomalies.push({
+                type: 'token_explosion',
+                message: `Single request cost $${current.costUsd.toFixed(4)} exceeds threshold $${this.config.tokenExplosionUsd}`,
+                severity: 'critical',
+                data: { costUsd: current.costUsd, threshold: this.config.tokenExplosionUsd, model: current.model },
+            });
+        }
+        // 2. Velocity spike — too many requests in window
+        if (recent.length >= this.config.velocityThreshold) {
+            // Compare to baseline (avg requests per 5 min over last hour)
+            const baselineRpm = this.getBaselineRpm();
+            const currentRate = recent.length;
+            const expectedIn5Min = baselineRpm * 5;
+            // Only flag if >10x normal OR above absolute threshold
+            if (expectedIn5Min > 0 && currentRate > expectedIn5Min * 10) {
+                anomalies.push({
+                    type: 'velocity_spike',
+                    message: `${currentRate} requests in ${this.config.windowMs / 1000}s (baseline: ~${Math.round(expectedIn5Min)}/5min)`,
+                    severity: 'warning',
+                    data: { currentRate, baseline: expectedIn5Min, windowMs: this.config.windowMs },
+                });
+            }
+            else if (currentRate >= this.config.velocityThreshold) {
+                anomalies.push({
+                    type: 'velocity_spike',
+                    message: `${currentRate} requests in ${this.config.windowMs / 1000}s exceeds threshold ${this.config.velocityThreshold}`,
+                    severity: 'warning',
+                    data: { currentRate, threshold: this.config.velocityThreshold, windowMs: this.config.windowMs },
+                });
+            }
+        }
+        // 3. Repetition detection — same model + similar token count
+        if (recent.length >= this.config.repetitionThreshold) {
+            const patternCounts = new Map();
+            for (const r of recent) {
+                // Bucket token counts by rounding to nearest 100
+                const tokenBucket = Math.round((r.tokensIn + r.tokensOut) / 100) * 100;
+                const key = `${r.model}:${tokenBucket}`;
+                patternCounts.set(key, (patternCounts.get(key) ?? 0) + 1);
+            }
+            for (const [pattern, count] of patternCounts) {
+                if (count >= this.config.repetitionThreshold) {
+                    anomalies.push({
+                        type: 'repetition',
+                        message: `Pattern "${pattern}" repeated ${count} times in ${this.config.windowMs / 1000}s (possible agent loop)`,
+                        severity: 'critical',
+                        data: { pattern, count, threshold: this.config.repetitionThreshold },
+                    });
+                    break; // One repetition alert is enough
+                }
+            }
+        }
+        // 4. Cost acceleration — check if spend rate is doubling
+        if (recent.length >= 10) {
+            const mid = Math.floor(recent.length / 2);
+            const firstHalf = recent.slice(0, mid);
+            const secondHalf = recent.slice(mid);
+            const firstCost = firstHalf.reduce((s, r) => s + r.costUsd, 0);
+            const secondCost = secondHalf.reduce((s, r) => s + r.costUsd, 0);
+            // Time-normalize
+            const firstDuration = (firstHalf[firstHalf.length - 1].timestamp - firstHalf[0].timestamp) || 1;
+            const secondDuration = (secondHalf[secondHalf.length - 1].timestamp - secondHalf[0].timestamp) || 1;
+            const firstRate = firstCost / firstDuration;
+            const secondRate = secondCost / secondDuration;
+            if (firstRate > 0 && secondRate > firstRate * 2 && secondCost > 1) {
+                anomalies.push({
+                    type: 'cost_acceleration',
+                    message: `Cost rate doubled: $${(firstRate * 60000).toFixed(4)}/min → $${(secondRate * 60000).toFixed(4)}/min`,
+                    severity: 'warning',
+                    data: {
+                        firstRatePerMin: firstRate * 60000,
+                        secondRatePerMin: secondRate * 60000,
+                        ratio: secondRate / firstRate,
+                    },
+                });
+            }
+        }
+        return {
+            detected: anomalies.length > 0,
+            anomalies,
+        };
+    }
+    getBaselineRpm() {
+        if (this.minuteBuckets.size <= 1)
+            return 0;
+        let total = 0;
+        for (const [, count] of this.minuteBuckets) {
+            total += count;
+        }
+        return total / this.minuteBuckets.size;
+    }
+}
+exports.AnomalyDetector = AnomalyDetector;
+// ─── Singleton ──────────────────────────────────────────────────────
+let _instance = null;
+function getAnomalyDetector(config) {
+    if (!_instance) {
+        _instance = new AnomalyDetector(config);
+    }
+    return _instance;
+}
+function resetAnomalyDetector() {
+    _instance = null;
+}
+//# sourceMappingURL=anomaly.js.map

package/dist/anomaly.js.map

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

package/dist/budget.d.ts

@@ -0,0 +1,98 @@
+/**
+ * RelayPlane Budget Enforcement
+ *
+ * SQLite-based spend tracking with in-memory cache for <5ms hot-path checks.
+ * Tracks daily/hourly windows and per-request limits.
+ *
+ * @packageDocumentation
+ */
+export interface BudgetConfig {
+    enabled: boolean;
+    /** Daily spend limit in USD (default: 50) */
+    dailyUsd: number;
+    /** Hourly spend limit in USD (default: 10) */
+    hourlyUsd: number;
+    /** Per-request spend limit in USD (default: 2) */
+    perRequestUsd: number;
+    /** Action on breach: block, warn, downgrade, alert */
+    onBreach: 'block' | 'warn' | 'downgrade' | 'alert';
+    /** Model to downgrade to when onBreach=downgrade */
+    downgradeTo: string;
+    /** Webhook URL for alerts */
+    alertWebhook?: string;
+    /** Alert thresholds as percentages of daily limit */
+    alertThresholds: number[];
+}
+export interface BudgetStatus {
+    dailySpend: number;
+    dailyLimit: number;
+    dailyPercent: number;
+    hourlySpend: number;
+    hourlyLimit: number;
+    hourlyPercent: number;
+    dailyWindow: string;
+    hourlyWindow: string;
+    breached: boolean;
+    breachType: 'none' | 'daily' | 'hourly';
+}
+export interface BudgetCheckResult {
+    allowed: boolean;
+    breached: boolean;
+    breachType: 'none' | 'daily' | 'hourly' | 'per-request';
+    action: 'allow' | 'block' | 'warn' | 'downgrade' | 'alert';
+    currentDailySpend: number;
+    currentHourlySpend: number;
+    thresholdsCrossed: number[];
+}
+export declare const DEFAULT_BUDGET_CONFIG: BudgetConfig;
+export declare function getDailyWindow(timestamp?: number): string;
+export declare function getHourlyWindow(timestamp?: number): string;
+export declare class BudgetManager {
+    private config;
+    private db;
+    private _initialized;
+    private dailySpendCache;
+    private hourlySpendCache;
+    private cachedDailyWindow;
+    private cachedHourlyWindow;
+    private firedThresholds;
+    private pendingWrites;
+    private flushTimer;
+    constructor(config?: Partial<BudgetConfig>);
+    /** Initialize SQLite storage. Safe to call multiple times. */
+    init(): void;
+    /** Update config at runtime */
+    updateConfig(config: Partial<BudgetConfig>): void;
+    getConfig(): BudgetConfig;
+    /**
+     * Pre-request budget check. Must be <5ms.
+     * Uses in-memory cache, never touches SQLite.
+     */
+    checkBudget(estimatedCost?: number): BudgetCheckResult;
+    /**
+     * Record spend after a request completes.
+     * Updates in-memory cache immediately, writes to SQLite async.
+     */
+    recordSpend(amount: number, model: string): void;
+    /** Mark a threshold as fired (for deduplication) */
+    markThresholdFired(threshold: number): void;
+    /** Get current budget status */
+    getStatus(): BudgetStatus;
+    /** Reset current window spend */
+    reset(): void;
+    /** Set budget limits */
+    setLimits(limits: {
+        dailyUsd?: number;
+        hourlyUsd?: number;
+        perRequestUsd?: number;
+    }): void;
+    /** Shutdown: flush pending writes */
+    close(): void;
+    private ensureCacheWindows;
+    private refreshCache;
+    private scheduleFlush;
+    private flushPendingWrites;
+}
+export declare function getBudgetManager(config?: Partial<BudgetConfig>): BudgetManager;
+export declare function resetBudgetManager(): void;
+//# sourceMappingURL=budget.d.ts.map