@agentlensai/server 0.6.0 → 0.8.0

package/dist/lib/guardrails/conditions.js

@@ -0,0 +1,188 @@
+/**
+ * Guardrail Condition Evaluators (v0.8.0 — Story 1.4)
+ *
+ * Each condition type has an evaluator that queries the store
+ * and returns whether the condition is triggered.
+ */
+import { DEFAULT_HEALTH_WEIGHTS } from '@agentlensai/core';
+import { HealthComputer } from '../health/computer.js';
+export async function evaluateErrorRateThreshold(store, rule, agentId) {
+    const config = rule.conditionConfig;
+    const threshold = config.threshold ?? 30;
+    const windowMinutes = config.windowMinutes ?? 5;
+    const now = new Date();
+    const from = new Date(now.getTime() - windowMinutes * 60 * 1000).toISOString();
+    const totalCount = await store.countEvents({ agentId, from, to: now.toISOString() });
+    if (totalCount === 0) {
+        return { triggered: false, currentValue: 0, threshold, message: 'No events in window' };
+    }
+    // Architecture §3.4: count error, critical severity AND tool_error event types
+    const errorCount = await store.countEvents({ agentId, from, to: now.toISOString(), severity: 'error' });
+    const criticalCount = await store.countEvents({ agentId, from, to: now.toISOString(), severity: 'critical' });
+    const toolErrorCount = await store.countEvents({ agentId, from, to: now.toISOString(), eventType: 'tool_error' });
+    // Deduplicate: tool_error events with error/critical severity are already counted above,
+    // but store.countEvents filters by a single field, so we take the max of the combined count and totalCount
+    const combinedErrors = Math.min(errorCount + criticalCount + toolErrorCount, totalCount);
+    const errorRate = (combinedErrors / totalCount) * 100;
+    return {
+        triggered: errorRate >= threshold,
+        currentValue: Math.round(errorRate * 100) / 100,
+        threshold,
+        message: errorRate >= threshold
+            ? `Error rate ${errorRate.toFixed(1)}% exceeds threshold ${threshold}%`
+            : `Error rate ${errorRate.toFixed(1)}% within threshold ${threshold}%`,
+    };
+}
+export async function evaluateCostLimit(store, rule, agentId, sessionId) {
+    const config = rule.conditionConfig;
+    const maxCostUsd = config.maxCostUsd ?? 10;
+    const scope = config.scope ?? 'daily';
+    if (scope === 'session' && sessionId) {
+        const session = await store.getSession(sessionId);
+        const currentCost = session?.totalCostUsd ?? 0;
+        return {
+            triggered: currentCost >= maxCostUsd,
+            currentValue: Math.round(currentCost * 10000) / 10000,
+            threshold: maxCostUsd,
+            message: currentCost >= maxCostUsd
+                ? `Session cost $${currentCost.toFixed(4)} exceeds limit $${maxCostUsd}`
+                : `Session cost $${currentCost.toFixed(4)} within limit $${maxCostUsd}`,
+        };
+    }
+    const todayStart = new Date();
+    todayStart.setUTCHours(0, 0, 0, 0);
+    const { sessions } = await store.querySessions({ agentId, from: todayStart.toISOString(), limit: 10000 });
+    const dailyCost = sessions.reduce((sum, s) => sum + (s.totalCostUsd || 0), 0);
+    return {
+        triggered: dailyCost >= maxCostUsd,
+        currentValue: Math.round(dailyCost * 10000) / 10000,
+        threshold: maxCostUsd,
+        message: dailyCost >= maxCostUsd
+            ? `Daily cost $${dailyCost.toFixed(4)} exceeds limit $${maxCostUsd}`
+            : `Daily cost $${dailyCost.toFixed(4)} within limit $${maxCostUsd}`,
+    };
+}
+export async function evaluateHealthScoreThreshold(store, rule, agentId) {
+    const config = rule.conditionConfig;
+    const minScore = config.minScore ?? 50;
+    const windowDays = config.windowDays ?? 7;
+    try {
+        const computer = new HealthComputer(DEFAULT_HEALTH_WEIGHTS);
+        const score = await computer.compute(store, agentId, windowDays);
+        if (!score) {
+            return { triggered: false, currentValue: 0, threshold: minScore, message: 'No sessions found for health computation' };
+        }
+        return {
+            triggered: score.overallScore < minScore,
+            currentValue: Math.round(score.overallScore * 100) / 100,
+            threshold: minScore,
+            message: score.overallScore < minScore
+                ? `Health score ${score.overallScore.toFixed(0)} below minimum ${minScore}`
+                : `Health score ${score.overallScore.toFixed(0)} above minimum ${minScore}`,
+        };
+    }
+    catch {
+        return { triggered: false, currentValue: 0, threshold: minScore, message: 'Failed to compute health score' };
+    }
+}
+/**
+ * Extract a value from a nested object using dot-notation key path.
+ * e.g. getByKeyPath({ a: { b: 3 } }, 'a.b') → 3
+ */
+function getByKeyPath(obj, keyPath) {
+    const parts = keyPath.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function compareMetric(currentValue, operator, targetValue) {
+    switch (operator) {
+        case 'gt': return currentValue > targetValue;
+        case 'gte': return currentValue >= targetValue;
+        case 'lt': return currentValue < targetValue;
+        case 'lte': return currentValue <= targetValue;
+        case 'eq': return currentValue === targetValue;
+        default: return false;
+    }
+}
+export async function evaluateCustomMetric(store, rule, agentId) {
+    const config = rule.conditionConfig;
+    const metricKeyPath = config.metricKeyPath;
+    const operator = config.operator ?? 'gt';
+    const targetValue = config.value ?? 0;
+    const windowMinutes = config.windowMinutes ?? 60;
+    const now = new Date();
+    const from = new Date(now.getTime() - windowMinutes * 60 * 1000).toISOString();
+    // Architecture §3.4: Use metricKeyPath to extract values from event metadata
+    if (metricKeyPath) {
+        const eventsResult = await store.queryEvents({ agentId, from, to: now.toISOString(), limit: 10000 });
+        const values = [];
+        for (const event of eventsResult.events) {
+            const md = (event.metadata ?? {});
+            const raw = getByKeyPath(md, metricKeyPath);
+            if (typeof raw === 'number')
+                values.push(raw);
+        }
+        // (events returned newest-first by default query order)
+        if (values.length === 0) {
+            return {
+                triggered: false,
+                currentValue: 0,
+                threshold: targetValue,
+                message: `No events with metadata key "${metricKeyPath}" in window`,
+            };
+        }
+        // Use the latest value for comparison (events are returned newest-first, so first element is latest)
+        const currentValue = values[0];
+        const triggered = compareMetric(currentValue, operator, targetValue);
+        return {
+            triggered,
+            currentValue,
+            threshold: targetValue,
+            message: triggered
+                ? `${metricKeyPath} (${currentValue}) ${operator} ${targetValue} = triggered`
+                : `${metricKeyPath} (${currentValue}) ${operator} ${targetValue} = not triggered`,
+        };
+    }
+    // Legacy fallback: metricName-based evaluation for backward compatibility
+    const metricName = config.metricName ?? 'event_count';
+    let currentValue = 0;
+    switch (metricName) {
+        case 'event_count':
+            currentValue = await store.countEvents({ agentId, from, to: now.toISOString() });
+            break;
+        case 'error_count':
+            currentValue = await store.countEvents({ agentId, from, to: now.toISOString(), severity: 'error' });
+            break;
+        case 'session_count': {
+            const { total } = await store.querySessions({ agentId, from });
+            currentValue = total;
+            break;
+        }
+        default:
+            return { triggered: false, currentValue: 0, threshold: targetValue, message: `Unknown metric: ${metricName}` };
+    }
+    const triggered = compareMetric(currentValue, operator, targetValue);
+    return {
+        triggered,
+        currentValue,
+        threshold: targetValue,
+        message: triggered
+            ? `${metricName} (${currentValue}) ${operator} ${targetValue} = triggered`
+            : `${metricName} (${currentValue}) ${operator} ${targetValue} = not triggered`,
+    };
+}
+export async function evaluateCondition(store, rule, agentId, sessionId) {
+    switch (rule.conditionType) {
+        case 'error_rate_threshold': return evaluateErrorRateThreshold(store, rule, agentId);
+        case 'cost_limit': return evaluateCostLimit(store, rule, agentId, sessionId);
+        case 'health_score_threshold': return evaluateHealthScoreThreshold(store, rule, agentId);
+        case 'custom_metric': return evaluateCustomMetric(store, rule, agentId);
+        default: return { triggered: false, currentValue: 0, threshold: 0, message: `Unknown condition type: ${rule.conditionType}` };
+    }
+}
+//# sourceMappingURL=conditions.js.map

package/dist/lib/guardrails/conditions.js.map

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

package/dist/lib/guardrails/engine.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Guardrail Evaluation Engine (v0.8.0 — Story 1.3)
+ *
+ * Subscribes to EventBus and evaluates guardrail rules asynchronously.
+ * Never blocks the event POST response.
+ */
+import type { AgentLensEvent } from '@agentlensai/core';
+import type { IEventStore } from '@agentlensai/core';
+import type { SqliteDb } from '../../db/index.js';
+import { GuardrailStore } from '../../db/guardrail-store.js';
+export declare class GuardrailEngine {
+    private store;
+    private eventStore;
+    private listener;
+    private started;
+    constructor(eventStore: IEventStore, db: SqliteDb);
+    start(): void;
+    stop(): void;
+    getStore(): GuardrailStore;
+    evaluateEvent(event: AgentLensEvent): Promise<void>;
+    private evaluateRule;
+    private isInCooldown;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/lib/guardrails/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/lib/guardrails/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAiC,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAK7D,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ;IAKjD,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAQZ,QAAQ,IAAI,cAAc;IAIpB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,YAAY;IA+D1B,OAAO,CAAC,YAAY;CAOrB"}

package/dist/lib/guardrails/engine.js

@@ -0,0 +1,122 @@
+/**
+ * Guardrail Evaluation Engine (v0.8.0 — Story 1.3)
+ *
+ * Subscribes to EventBus and evaluates guardrail rules asynchronously.
+ * Never blocks the event POST response.
+ */
+import { ulid } from 'ulid';
+import { GuardrailStore } from '../../db/guardrail-store.js';
+import { evaluateCondition } from './conditions.js';
+import { executeAction } from './actions.js';
+import { eventBus } from '../event-bus.js';
+export class GuardrailEngine {
+    store;
+    eventStore;
+    listener = null;
+    started = false;
+    constructor(eventStore, db) {
+        this.eventStore = eventStore;
+        this.store = new GuardrailStore(db);
+    }
+    start() {
+        if (this.started)
+            return;
+        this.listener = (busEvent) => {
+            if (busEvent.type === 'event_ingested') {
+                this.evaluateEvent(busEvent.event).catch((err) => {
+                    console.error('[guardrail-engine] evaluation error:', err instanceof Error ? err.message : err);
+                });
+            }
+        };
+        eventBus.on('event_ingested', this.listener);
+        this.started = true;
+    }
+    stop() {
+        if (this.listener) {
+            eventBus.off('event_ingested', this.listener);
+            this.listener = null;
+        }
+        this.started = false;
+    }
+    getStore() {
+        return this.store;
+    }
+    async evaluateEvent(event) {
+        const rules = this.store.listEnabledRules(event.tenantId, event.agentId);
+        if (rules.length === 0)
+            return;
+        for (const rule of rules) {
+            try {
+                await this.evaluateRule(rule, event);
+            }
+            catch (err) {
+                console.error(`[guardrail-engine] rule ${rule.id} error:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    async evaluateRule(rule, event) {
+        const now = new Date();
+        // 0. Check enabled (defense-in-depth — listEnabledRules already filters, but verify)
+        if (!rule.enabled)
+            return;
+        // 1. Check cooldown
+        if (this.isInCooldown(rule, now))
+            return;
+        // 2. Evaluate condition
+        const conditionResult = await evaluateCondition(this.eventStore, rule, event.agentId, event.sessionId);
+        // 3. Update state
+        const existingState = this.store.getState(rule.tenantId, rule.id);
+        const newState = {
+            ruleId: rule.id,
+            tenantId: rule.tenantId,
+            lastEvaluatedAt: now.toISOString(),
+            currentValue: conditionResult.currentValue,
+            triggerCount: existingState?.triggerCount ?? 0,
+            lastTriggeredAt: existingState?.lastTriggeredAt,
+        };
+        if (!conditionResult.triggered) {
+            this.store.upsertState(newState);
+            return;
+        }
+        // 4. Execute action (or dry-run)
+        let actionResult = 'dry_run';
+        let actionExecuted = false;
+        if (!rule.dryRun) {
+            const result = await executeAction(rule, conditionResult, event.agentId);
+            actionResult = result.result;
+            actionExecuted = result.success;
+        }
+        // 5. Record trigger history
+        this.store.insertTrigger({
+            id: ulid(),
+            ruleId: rule.id,
+            tenantId: rule.tenantId,
+            triggeredAt: now.toISOString(),
+            conditionValue: conditionResult.currentValue,
+            conditionThreshold: conditionResult.threshold,
+            actionExecuted,
+            actionResult,
+            metadata: {
+                agentId: event.agentId,
+                sessionId: event.sessionId,
+                eventId: event.id,
+                dryRun: rule.dryRun,
+                message: conditionResult.message,
+            },
+        });
+        // 6. Update state
+        newState.triggerCount = (existingState?.triggerCount ?? 0) + 1;
+        newState.lastTriggeredAt = now.toISOString();
+        this.store.upsertState(newState);
+    }
+    isInCooldown(rule, now) {
+        if (rule.cooldownMinutes <= 0)
+            return false;
+        const state = this.store.getState(rule.tenantId, rule.id);
+        if (!state?.lastTriggeredAt)
+            return false;
+        const lastTriggered = new Date(state.lastTriggeredAt);
+        return now.getTime() - lastTriggered.getTime() < rule.cooldownMinutes * 60 * 1000;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/lib/guardrails/engine.js.map

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

package/dist/lib/replay/builder.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ReplayBuilder — Core Replay Logic (Stories 2.1, 2.4)
+ *
+ * Constructs a ReplayState from raw events for a given session.
+ * Handles event pairing, cumulative context tracking, pagination,
+ * filtering, and redaction of sensitive LLM content.
+ */
+import type { IEventStore, EventType, ReplayState } from '@agentlensai/core';
+export interface ReplayBuildOptions {
+    /** Skip N steps (default 0) */
+    offset?: number;
+    /** Max steps to return (default 1000) */
+    limit?: number;
+    /** Only include these event types */
+    eventTypes?: EventType[];
+    /** If false, skip cumulative context computation (default true) */
+    includeContext?: boolean;
+}
+export declare class ReplayBuilder {
+    private readonly store;
+    constructor(store: IEventStore);
+    /**
+     * Build a ReplayState for the given session.
+     * Returns null when the session does not exist.
+     */
+    build(sessionId: string, options?: ReplayBuildOptions): Promise<ReplayState | null>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/lib/replay/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/lib/replay/builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,SAAS,EAGT,WAAW,EAWZ,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAE/C;;;OAGG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;CA2G/B"}