@agentlensai/server 0.2.0 → 0.5.0

package/dist/lib/alert-engine.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Alert Evaluation Engine (Story 12.2 + 12.3)
+ *
+ * Periodically evaluates alert rules against recent analytics data.
+ * When conditions are met, triggers alerts:
+ *   1. Stores in alertHistory table
+ *   2. Delivers via webhook (Story 12.3)
+ *   3. Emits on EventBus (Story 12.5)
+ *   4. Logs to console
+ */
+import type { IEventStore } from '@agentlensai/core';
+import type { AlertHistory } from '@agentlensai/core';
+/**
+ * Validate that a webhook URL is safe to deliver to.
+ * Blocks private/reserved IPs and non-HTTP(S) schemes to prevent SSRF.
+ */
+export declare function isWebhookUrlAllowed(url: string): boolean;
+export interface AlertEngineOptions {
+    /** Evaluation interval in milliseconds */
+    checkIntervalMs?: number;
+}
+export declare class AlertEngine {
+    private store;
+    private timer;
+    private running;
+    private readonly checkIntervalMs;
+    constructor(store: IEventStore, options?: AlertEngineOptions);
+    /**
+     * Start the periodic evaluation loop.
+     */
+    start(): void;
+    /**
+     * Stop the evaluation loop.
+     */
+    stop(): void;
+    /**
+     * Get a tenant-scoped store for a given rule.
+     * If the underlying store is SqliteEventStore and the rule has a tenantId,
+     * returns a TenantScopedStore. Otherwise returns the original store.
+     */
+    private getTenantStore;
+    /**
+     * Run a single evaluation cycle (can also be called manually / from tests).
+     *
+     * Rules are grouped by tenantId so every operation — listing rules,
+     * querying analytics, deduplication, and history insertion — goes
+     * through a tenant-scoped store.  This prevents any cross-tenant
+     * data leakage during alert evaluation.
+     */
+    evaluate(): Promise<AlertHistory[]>;
+    /**
+     * Compute the current metric value for a rule by querying analytics.
+     */
+    private computeCurrentValue;
+    /**
+     * Check whether the condition is met.
+     */
+    private checkCondition;
+    /**
+     * Trigger an alert: persist history, deliver webhooks, emit on EventBus.
+     */
+    private triggerAlert;
+    /**
+     * Deliver alert to configured webhook URLs (Story 12.3).
+     */
+    private deliverWebhooks;
+    /**
+     * Build a human-readable alert message.
+     */
+    private buildMessage;
+}
+//# sourceMappingURL=alert-engine.d.ts.map

package/dist/lib/alert-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-engine.d.ts","sourceRoot":"","sources":["../../src/lib/alert-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAa,YAAY,EAAkB,MAAM,mBAAmB,CAAC;AAUjF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA+CxD;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,WAAW;IAMpB,OAAO,CAAC,KAAK;IALf,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAG/B,KAAK,EAAE,WAAW,EAC1B,OAAO,CAAC,EAAE,kBAAkB;IAQ9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;;OAOG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA6DzC;;OAEG;YACW,mBAAmB;IAwCjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,eAAe;IA4C7B;;OAEG;IACH,OAAO,CAAC,YAAY;CAmBrB"}

package/dist/lib/alert-engine.js

@@ -0,0 +1,318 @@
+/**
+ * Alert Evaluation Engine (Story 12.2 + 12.3)
+ *
+ * Periodically evaluates alert rules against recent analytics data.
+ * When conditions are met, triggers alerts:
+ *   1. Stores in alertHistory table
+ *   2. Delivers via webhook (Story 12.3)
+ *   3. Emits on EventBus (Story 12.5)
+ *   4. Logs to console
+ */
+import { ulid } from 'ulid';
+import { SqliteEventStore } from '../db/sqlite-store.js';
+import { TenantScopedStore } from '../db/tenant-scoped-store.js';
+import { eventBus } from './event-bus.js';
+/** Default evaluation interval: 60 seconds */
+const DEFAULT_CHECK_INTERVAL_MS = 60_000;
+// ─── SSRF Protection ────────────────────────────────────────────────
+/**
+ * Validate that a webhook URL is safe to deliver to.
+ * Blocks private/reserved IPs and non-HTTP(S) schemes to prevent SSRF.
+ */
+export function isWebhookUrlAllowed(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    // Only allow http and https schemes
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        return false;
+    }
+    const hostname = parsed.hostname.replace(/^\[|\]$/g, ''); // strip IPv6 brackets
+    // Allow http://localhost only for dev
+    if (parsed.protocol === 'http:' && hostname !== 'localhost' && hostname !== '127.0.0.1') {
+        // In production, require https for non-localhost
+        // For now, allow http in dev but still block private IPs below
+    }
+    // Block IPv6 loopback
+    if (hostname === '::1' || hostname === '0:0:0:0:0:0:0:1') {
+        return false;
+    }
+    // Block private/reserved IPv4 ranges
+    const PRIVATE_IP_PATTERNS = [
+        /^127\./, // loopback
+        /^10\./, // 10.0.0.0/8
+        /^172\.(1[6-9]|2\d|3[01])\./, // 172.16.0.0/12
+        /^192\.168\./, // 192.168.0.0/16
+        /^169\.254\./, // link-local
+        /^0\./, // 0.0.0.0/8
+    ];
+    if (PRIVATE_IP_PATTERNS.some((p) => p.test(hostname))) {
+        return false;
+    }
+    // Block if hostname resolves to a known-private DNS name
+    if (hostname === 'localhost' && parsed.protocol === 'https:') {
+        // https://localhost is suspicious but technically okay for dev
+        return true;
+    }
+    return true;
+}
+export class AlertEngine {
+    store;
+    timer = null;
+    running = false;
+    checkIntervalMs;
+    constructor(store, options) {
+        this.store = store;
+        this.checkIntervalMs =
+            options?.checkIntervalMs ??
+                (parseInt(process.env['ALERT_CHECK_INTERVAL_MS'] ?? '', 10) ||
+                    DEFAULT_CHECK_INTERVAL_MS);
+    }
+    /**
+     * Start the periodic evaluation loop.
+     */
+    start() {
+        if (this.timer)
+            return;
+        console.log(`[AlertEngine] Starting evaluation loop (interval: ${this.checkIntervalMs}ms)`);
+        this.timer = setInterval(() => {
+            this.evaluate().catch((err) => {
+                console.error('[AlertEngine] Evaluation error:', err);
+            });
+        }, this.checkIntervalMs);
+    }
+    /**
+     * Stop the evaluation loop.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            console.log('[AlertEngine] Stopped');
+        }
+    }
+    /**
+     * Get a tenant-scoped store for a given rule.
+     * If the underlying store is SqliteEventStore and the rule has a tenantId,
+     * returns a TenantScopedStore. Otherwise returns the original store.
+     */
+    getTenantStore(rule) {
+        const tenantId = rule.tenantId ?? 'default';
+        if (this.store instanceof SqliteEventStore) {
+            return new TenantScopedStore(this.store, tenantId);
+        }
+        return this.store;
+    }
+    /**
+     * Run a single evaluation cycle (can also be called manually / from tests).
+     *
+     * Rules are grouped by tenantId so every operation — listing rules,
+     * querying analytics, deduplication, and history insertion — goes
+     * through a tenant-scoped store.  This prevents any cross-tenant
+     * data leakage during alert evaluation.
+     */
+    async evaluate() {
+        if (this.running)
+            return [];
+        this.running = true;
+        try {
+            // Fetch all rules then group by tenant so every subsequent
+            // operation uses the correct tenant-scoped store.
+            const allRules = await this.store.listAlertRules();
+            const rulesByTenant = new Map();
+            for (const rule of allRules) {
+                const tid = rule.tenantId ?? 'default';
+                let bucket = rulesByTenant.get(tid);
+                if (!bucket) {
+                    bucket = [];
+                    rulesByTenant.set(tid, bucket);
+                }
+                bucket.push(rule);
+            }
+            const triggered = [];
+            for (const [tenantId, tenantRules] of rulesByTenant) {
+                // Build a single tenant-scoped store per tenant
+                const tenantStore = this.store instanceof SqliteEventStore
+                    ? new TenantScopedStore(this.store, tenantId)
+                    : this.store;
+                const enabledRules = tenantRules.filter((r) => r.enabled);
+                for (const rule of enabledRules) {
+                    try {
+                        const currentValue = await this.computeCurrentValue(rule, tenantStore);
+                        const shouldTrigger = this.checkCondition(rule.condition, currentValue, rule.threshold);
+                        if (shouldTrigger) {
+                            // M1 fix: Deduplication — skip if the rule already triggered within its window
+                            const recentHistory = await tenantStore.listAlertHistory({ ruleId: rule.id, limit: 1 });
+                            if (recentHistory.entries.length > 0) {
+                                const lastTrigger = new Date(recentHistory.entries[0].triggeredAt).getTime();
+                                const cooldownMs = rule.windowMinutes * 60_000;
+                                if (Date.now() - lastTrigger < cooldownMs) {
+                                    continue; // Still within cooldown period
+                                }
+                            }
+                            const entry = await this.triggerAlert(rule, currentValue, tenantStore);
+                            triggered.push(entry);
+                        }
+                    }
+                    catch (err) {
+                        console.error(`[AlertEngine] Error evaluating rule "${rule.name}" (${rule.id}):`, err);
+                    }
+                }
+            }
+            return triggered;
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /**
+     * Compute the current metric value for a rule by querying analytics.
+     */
+    async computeCurrentValue(rule, tenantStore) {
+        const now = new Date();
+        const windowStart = new Date(now.getTime() - rule.windowMinutes * 60_000);
+        const from = windowStart.toISOString();
+        const to = now.toISOString();
+        const analytics = await tenantStore.getAnalytics({
+            from,
+            to,
+            agentId: rule.scope.agentId,
+            granularity: 'hour',
+        });
+        const totals = analytics.totals;
+        switch (rule.condition) {
+            case 'error_rate_exceeds': {
+                if (totals.eventCount === 0)
+                    return 0;
+                return totals.errorCount / totals.eventCount;
+            }
+            case 'cost_exceeds': {
+                return totals.totalCostUsd;
+            }
+            case 'latency_exceeds': {
+                return totals.avgLatencyMs;
+            }
+            case 'event_count_exceeds': {
+                return totals.eventCount;
+            }
+            case 'no_events_for': {
+                // For no_events_for, the "value" is the number of events.
+                // Trigger if event count is 0 (or below threshold — threshold is ignored,
+                // the rule triggers when there are zero events in the window).
+                return totals.eventCount;
+            }
+            default:
+                return 0;
+        }
+    }
+    /**
+     * Check whether the condition is met.
+     */
+    checkCondition(condition, currentValue, threshold) {
+        switch (condition) {
+            case 'error_rate_exceeds':
+            case 'cost_exceeds':
+            case 'latency_exceeds':
+            case 'event_count_exceeds':
+                return currentValue > threshold;
+            case 'no_events_for':
+                // Triggers when event count is 0 (no events in window)
+                return currentValue === 0;
+            default:
+                return false;
+        }
+    }
+    /**
+     * Trigger an alert: persist history, deliver webhooks, emit on EventBus.
+     */
+    async triggerAlert(rule, currentValue, tenantStore) {
+        const now = new Date().toISOString();
+        const message = this.buildMessage(rule, currentValue);
+        const entry = {
+            id: ulid(),
+            ruleId: rule.id,
+            triggeredAt: now,
+            currentValue,
+            threshold: rule.threshold,
+            message,
+            tenantId: rule.tenantId,
+        };
+        // 1. Persist to alert history (via tenant-scoped store)
+        await tenantStore.insertAlertHistory(entry);
+        // 2. Console log
+        console.log(`[AlertEngine] 🔔 Alert triggered: "${rule.name}" — ${message}`);
+        // 3. Emit on EventBus (Story 12.5)
+        eventBus.emit({
+            type: 'alert_triggered',
+            rule,
+            history: entry,
+            timestamp: now,
+        });
+        // 4. Webhook delivery (Story 12.3) — fire and forget
+        await this.deliverWebhooks(rule, entry);
+        return entry;
+    }
+    /**
+     * Deliver alert to configured webhook URLs (Story 12.3).
+     */
+    async deliverWebhooks(rule, entry) {
+        const webhookUrls = rule.notifyChannels.filter((ch) => (ch.startsWith('http://') || ch.startsWith('https://')) && isWebhookUrlAllowed(ch));
+        if (webhookUrls.length === 0)
+            return;
+        const payload = {
+            alertRuleId: rule.id,
+            alertName: rule.name,
+            condition: rule.condition,
+            currentValue: entry.currentValue,
+            threshold: entry.threshold,
+            message: entry.message,
+            triggeredAt: entry.triggeredAt,
+            windowMinutes: rule.windowMinutes,
+            scope: rule.scope,
+        };
+        for (const url of webhookUrls) {
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(payload),
+                    signal: AbortSignal.timeout(10_000), // 10s timeout
+                });
+                if (!res.ok) {
+                    console.warn(`[AlertEngine] Webhook delivery to ${url} failed: HTTP ${res.status}`);
+                }
+                else {
+                    console.log(`[AlertEngine] Webhook delivered to ${url}`);
+                }
+            }
+            catch (err) {
+                console.warn(`[AlertEngine] Webhook delivery to ${url} error:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    /**
+     * Build a human-readable alert message.
+     */
+    buildMessage(rule, currentValue) {
+        const formatted = (v) => Number.isInteger(v) ? v.toString() : v.toFixed(4);
+        switch (rule.condition) {
+            case 'error_rate_exceeds':
+                return `Error rate ${(currentValue * 100).toFixed(1)}% exceeds threshold ${(rule.threshold * 100).toFixed(1)}% in the last ${rule.windowMinutes}m`;
+            case 'cost_exceeds':
+                return `Cost $${formatted(currentValue)} exceeds threshold $${formatted(rule.threshold)} in the last ${rule.windowMinutes}m`;
+            case 'latency_exceeds':
+                return `Average latency ${formatted(currentValue)}ms exceeds threshold ${formatted(rule.threshold)}ms in the last ${rule.windowMinutes}m`;
+            case 'event_count_exceeds':
+                return `Event count ${formatted(currentValue)} exceeds threshold ${formatted(rule.threshold)} in the last ${rule.windowMinutes}m`;
+            case 'no_events_for':
+                return `No events received in the last ${rule.windowMinutes}m`;
+            default:
+                return `Alert condition met: ${rule.condition}`;
+        }
+    }
+}
+//# sourceMappingURL=alert-engine.js.map

package/dist/lib/alert-engine.js.map

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

package/dist/lib/analysis/cost-analysis.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Cost Analysis (Story 4.3)
+ *
+ * Analyzes cost data from sessions and llm_response events to provide
+ * cost breakdowns by model, agent, and time trends.
+ */
+import type { IEventStore } from '@agentlensai/core';
+import type { CostAnalysisResult } from '@agentlensai/core';
+export interface CostAnalysisOpts {
+    agentId?: string;
+    from?: string;
+    to?: string;
+    model?: string;
+    limit?: number;
+}
+/**
+ * Analyze costs across sessions and LLM calls.
+ */
+export declare function analyzeCosts(store: IEventStore, opts?: CostAnalysisOpts): Promise<CostAnalysisResult>;
+//# sourceMappingURL=cost-analysis.d.ts.map

package/dist/lib/analysis/cost-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-analysis.d.ts","sourceRoot":"","sources":["../../../src/lib/analysis/cost-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA+I7B"}

package/dist/lib/analysis/cost-analysis.js

@@ -0,0 +1,158 @@
+/**
+ * Cost Analysis (Story 4.3)
+ *
+ * Analyzes cost data from sessions and llm_response events to provide
+ * cost breakdowns by model, agent, and time trends.
+ */
+/**
+ * Analyze costs across sessions and LLM calls.
+ */
+export async function analyzeCosts(store, opts = {}) {
+    const limit = opts.limit ?? 20;
+    // Query sessions with cost data
+    const sessionResult = await store.querySessions({
+        agentId: opts.agentId,
+        from: opts.from,
+        to: opts.to,
+        limit: 500,
+    });
+    // Query llm_response events for model breakdown
+    const llmResult = await store.queryEvents({
+        agentId: opts.agentId,
+        from: opts.from,
+        to: opts.to,
+        eventType: 'llm_response',
+        limit: 500,
+        order: 'asc',
+    });
+    const sessions = sessionResult.sessions;
+    const llmEvents = llmResult.events;
+    // Filter llm events by model if specified
+    const filteredLlmEvents = opts.model
+        ? llmEvents.filter((e) => {
+            const p = e.payload;
+            return p.model === opts.model;
+        })
+        : llmEvents;
+    const eventsAnalyzed = filteredLlmEvents.length;
+    const timeRange = {
+        from: sessions.length > 0
+            ? sessions.reduce((min, s) => (s.startedAt < min ? s.startedAt : min), sessions[0].startedAt)
+            : (opts.from ?? ''),
+        to: sessions.length > 0
+            ? sessions.reduce((max, s) => (s.startedAt > max ? s.startedAt : max), sessions[0].startedAt)
+            : (opts.to ?? ''),
+    };
+    // Summary from sessions
+    const totalCost = sessions.reduce((sum, s) => sum + s.totalCostUsd, 0);
+    const totalSessions = sessions.length;
+    const avgPerSession = totalSessions > 0 ? totalCost / totalSessions : 0;
+    // Cost by model from llm_response events
+    const modelMap = new Map();
+    for (const event of filteredLlmEvents) {
+        const p = event.payload;
+        const model = p.model ?? 'unknown';
+        const cost = p.costUsd ?? 0;
+        const entry = modelMap.get(model) ?? { totalCost: 0, callCount: 0 };
+        entry.totalCost += cost;
+        entry.callCount++;
+        modelMap.set(model, entry);
+    }
+    const byModel = Array.from(modelMap.entries())
+        .map(([model, data]) => ({
+        model,
+        totalCost: Math.round(data.totalCost * 1_000_000) / 1_000_000,
+        callCount: data.callCount,
+        avgCostPerCall: data.callCount > 0
+            ? Math.round((data.totalCost / data.callCount) * 1_000_000) / 1_000_000
+            : 0,
+    }))
+        .sort((a, b) => b.totalCost - a.totalCost);
+    // Cost by agent from sessions
+    const agentMap = new Map();
+    for (const session of sessions) {
+        const entry = agentMap.get(session.agentId) ?? { totalCost: 0, sessionCount: 0 };
+        entry.totalCost += session.totalCostUsd;
+        entry.sessionCount++;
+        agentMap.set(session.agentId, entry);
+    }
+    const byAgent = Array.from(agentMap.entries())
+        .map(([agentId, data]) => ({
+        agentId,
+        totalCost: Math.round(data.totalCost * 1_000_000) / 1_000_000,
+        sessionCount: data.sessionCount,
+        avgCostPerSession: data.sessionCount > 0
+            ? Math.round((data.totalCost / data.sessionCount) * 1_000_000) / 1_000_000
+            : 0,
+    }))
+        .sort((a, b) => b.totalCost - a.totalCost);
+    // Cost trend over time (daily buckets)
+    const dailyMap = new Map();
+    for (const session of sessions) {
+        const date = session.startedAt.slice(0, 10); // YYYY-MM-DD
+        const entry = dailyMap.get(date) ?? { totalCost: 0, sessionCount: 0 };
+        entry.totalCost += session.totalCostUsd;
+        entry.sessionCount++;
+        dailyMap.set(date, entry);
+    }
+    const buckets = Array.from(dailyMap.entries())
+        .map(([date, data]) => ({
+        date,
+        totalCost: Math.round(data.totalCost * 1_000_000) / 1_000_000,
+        sessionCount: data.sessionCount,
+    }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+    // Trend detection: compare last 7 days vs previous 7 days
+    const direction = detectCostTrend(buckets);
+    // Top sessions by cost
+    const topSessions = [...sessions]
+        .sort((a, b) => b.totalCostUsd - a.totalCostUsd)
+        .slice(0, limit)
+        .map((s) => ({
+        sessionId: s.id,
+        agentId: s.agentId,
+        totalCost: Math.round(s.totalCostUsd * 1_000_000) / 1_000_000,
+        startedAt: s.startedAt,
+    }));
+    return {
+        summary: {
+            totalCost: Math.round(totalCost * 1_000_000) / 1_000_000,
+            avgPerSession: Math.round(avgPerSession * 1_000_000) / 1_000_000,
+            totalSessions,
+        },
+        byModel,
+        byAgent,
+        trend: {
+            direction,
+            buckets,
+        },
+        topSessions,
+        metadata: {
+            eventsAnalyzed,
+            timeRange,
+        },
+    };
+}
+/**
+ * Detect cost trend by comparing the most recent 7 day-buckets vs the previous 7.
+ */
+function detectCostTrend(buckets) {
+    if (buckets.length < 2)
+        return 'stable';
+    const recent = buckets.slice(-7);
+    const previous = buckets.slice(-14, -7);
+    if (previous.length === 0)
+        return 'stable';
+    const recentTotal = recent.reduce((s, b) => s + b.totalCost, 0);
+    const previousTotal = previous.reduce((s, b) => s + b.totalCost, 0);
+    if (previousTotal === 0) {
+        return recentTotal > 0 ? 'increasing' : 'stable';
+    }
+    const changeRatio = (recentTotal - previousTotal) / previousTotal;
+    if (changeRatio > 0.1)
+        return 'increasing';
+    if (changeRatio < -0.1)
+        return 'decreasing';
+    return 'stable';
+}
+//# sourceMappingURL=cost-analysis.js.map

package/dist/lib/analysis/cost-analysis.js.map

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

package/dist/lib/analysis/error-patterns.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Error Pattern Analysis (Story 4.1)
+ *
+ * Analyzes tool_error events and error/critical severity events to find
+ * recurring error patterns, grouping by normalized message.
+ */
+import type { IEventStore } from '@agentlensai/core';
+import type { ErrorPatternResult } from '@agentlensai/core';
+export interface ErrorPatternOpts {
+    agentId?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+/**
+ * Normalize an error message for grouping:
+ * - Replace UUIDs with <UUID>
+ * - Replace file paths with <PATH>
+ * - Replace numbers with <N>
+ */
+export declare function normalizeErrorMessage(msg: string): string;
+/**
+ * Analyze error patterns from the event store.
+ */
+export declare function analyzeErrorPatterns(store: IEventStore, opts?: ErrorPatternOpts): Promise<ErrorPatternResult>;
+//# sourceMappingURL=error-patterns.d.ts.map

package/dist/lib/analysis/error-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-patterns.d.ts","sourceRoot":"","sources":["../../../src/lib/analysis/error-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQzD;AAgBD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA4H7B"}