@agentlensai/server 0.6.0 → 0.7.0

package/dist/routes/benchmarks.js

@@ -0,0 +1,312 @@
+/**
+ * Benchmark REST Endpoints (Story 3.5)
+ *
+ * POST   /api/benchmarks            — Create benchmark
+ * GET    /api/benchmarks            — List benchmarks
+ * GET    /api/benchmarks/:id        — Get benchmark detail
+ * PUT    /api/benchmarks/:id/status — Transition status
+ * GET    /api/benchmarks/:id/results — Get comparison results
+ * DELETE /api/benchmarks/:id        — Delete draft/cancelled
+ */
+import { Hono } from 'hono';
+import { BENCHMARK_METRICS } from '@agentlensai/core';
+import { getTenantStore } from './tenant-helper.js';
+import { BenchmarkStore, } from '../db/benchmark-store.js';
+import { BenchmarkEngine } from '../lib/benchmark/engine.js';
+// ─── Validation Helpers ────────────────────────────────────
+const VALID_METRICS = new Set(BENCHMARK_METRICS);
+const VALID_STATUSES = new Set(['draft', 'running', 'completed', 'cancelled']);
+function validateCreateInput(body) {
+    if (!body || typeof body !== 'object') {
+        return { error: 'Request body is required' };
+    }
+    // Name required
+    if (!body.name || typeof body.name !== 'string' || body.name.trim() === '') {
+        return { error: 'name is required and must be a non-empty string' };
+    }
+    // Variants: 2-10 with name+tag
+    if (!Array.isArray(body.variants)) {
+        return { error: 'variants must be an array' };
+    }
+    if (body.variants.length < 2 || body.variants.length > 10) {
+        return { error: 'Must have between 2 and 10 variants' };
+    }
+    for (let i = 0; i < body.variants.length; i++) {
+        const v = body.variants[i];
+        if (!v || typeof v !== 'object') {
+            return { error: `variants[${i}] must be an object` };
+        }
+        if (!v.name || typeof v.name !== 'string' || v.name.trim() === '') {
+            return { error: `variants[${i}].name is required` };
+        }
+        if (!v.tag || typeof v.tag !== 'string' || v.tag.trim() === '') {
+            return { error: `variants[${i}].tag is required` };
+        }
+    }
+    // Metrics: optional array, but if provided must be valid
+    let metrics = BENCHMARK_METRICS.filter(m => m !== 'health_score'); // default: all supported
+    if (body.metrics !== undefined) {
+        if (!Array.isArray(body.metrics) || body.metrics.length === 0) {
+            return { error: 'metrics must be a non-empty array' };
+        }
+        for (const m of body.metrics) {
+            if (!VALID_METRICS.has(m)) {
+                return { error: `Invalid metric: ${m}` };
+            }
+            if (m === 'health_score') {
+                return { error: `Metric "health_score" is not yet supported for benchmarks. It requires pre-computed health snapshots.` };
+            }
+        }
+        metrics = body.metrics;
+    }
+    // minSessionsPerVariant: optional, must be ≥ 1
+    let minSessions;
+    if (body.minSessionsPerVariant !== undefined) {
+        const val = Number(body.minSessionsPerVariant);
+        if (!Number.isInteger(val) || val < 1) {
+            return { error: 'minSessionsPerVariant must be an integer ≥ 1' };
+        }
+        minSessions = val;
+    }
+    const input = {
+        name: body.name.trim(),
+        description: body.description ?? undefined,
+        agentId: body.agentId ?? undefined,
+        metrics,
+        minSessionsPerVariant: minSessions,
+        timeRange: body.timeRange,
+        variants: body.variants.map((v) => ({
+            name: v.name.trim(),
+            description: v.description ?? undefined,
+            tag: v.tag.trim(),
+            agentId: v.agentId ?? undefined,
+        })),
+    };
+    return { input };
+}
+// ─── Route Factory ─────────────────────────────────────────
+export function benchmarkRoutes(store, db) {
+    const app = new Hono();
+    const engine = new BenchmarkEngine();
+    function getBenchmarkStore(c) {
+        if (!db)
+            return null;
+        return new BenchmarkStore(db);
+    }
+    function getTenantId(c) {
+        const apiKey = c.get('apiKey');
+        return apiKey?.tenantId ?? 'default';
+    }
+    // ─── POST / — Create benchmark ─────────────────────────
+    app.post('/', async (c) => {
+        const benchmarkStore = getBenchmarkStore(c);
+        if (!benchmarkStore) {
+            return c.json({ error: 'Database not available', status: 500 }, 500);
+        }
+        const tenantId = getTenantId(c);
+        const body = await c.req.json().catch(() => null);
+        const { error, input } = validateCreateInput(body);
+        if (error || !input) {
+            return c.json({ error, status: 400 }, 400);
+        }
+        try {
+            const benchmark = benchmarkStore.create(tenantId, input);
+            return c.json(benchmark, 201);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to create benchmark';
+            return c.json({ error: message, status: 400 }, 400);
+        }
+    });
+    // ─── GET / — List benchmarks ────────────────────────────
+    app.get('/', async (c) => {
+        const benchmarkStore = getBenchmarkStore(c);
+        if (!benchmarkStore) {
+            return c.json({ error: 'Database not available', status: 500 }, 500);
+        }
+        const tenantId = getTenantId(c);
+        // Parse query params
+        const statusRaw = c.req.query('status');
+        const agentId = c.req.query('agentId') || undefined;
+        const limitStr = c.req.query('limit');
+        const offsetStr = c.req.query('offset');
+        // Validate status
+        let status;
+        if (statusRaw) {
+            if (!VALID_STATUSES.has(statusRaw)) {
+                return c.json({ error: `Invalid status: ${statusRaw}`, status: 400 }, 400);
+            }
+            status = statusRaw;
+        }
+        // Validate limit (1-100, default 20)
+        let limit = 20;
+        if (limitStr !== undefined && limitStr !== '') {
+            const val = parseInt(limitStr, 10);
+            if (isNaN(val) || val < 1 || val > 100) {
+                return c.json({ error: 'limit must be an integer between 1 and 100', status: 400 }, 400);
+            }
+            limit = val;
+        }
+        // Validate offset
+        let offset = 0;
+        if (offsetStr !== undefined && offsetStr !== '') {
+            const val = parseInt(offsetStr, 10);
+            if (isNaN(val) || val < 0) {
+                return c.json({ error: 'offset must be a non-negative integer', status: 400 }, 400);
+            }
+            offset = val;
+        }
+        const filters = { status, agentId, limit, offset };
+        const { benchmarks, total } = benchmarkStore.list(tenantId, filters);
+        return c.json({
+            benchmarks,
+            total,
+            hasMore: offset + benchmarks.length < total,
+        });
+    });
+    // ─── GET /:id — Get benchmark detail ────────────────────
+    app.get('/:id', async (c) => {
+        const benchmarkStore = getBenchmarkStore(c);
+        if (!benchmarkStore) {
+            return c.json({ error: 'Database not available', status: 500 }, 500);
+        }
+        const tenantId = getTenantId(c);
+        const id = c.req.param('id');
+        const benchmark = benchmarkStore.getById(tenantId, id);
+        if (!benchmark) {
+            return c.json({ error: 'Benchmark not found', status: 404 }, 404);
+        }
+        // Enrich variants with session counts
+        const tenantStore = getTenantStore(store, c);
+        const variantsWithCounts = await Promise.all(benchmark.variants.map(async (v) => {
+            try {
+                const { total } = await tenantStore.querySessions({
+                    tenantId: v.tenantId,
+                    agentId: v.agentId,
+                    tags: [v.tag],
+                    from: benchmark.timeRange?.from,
+                    to: benchmark.timeRange?.to,
+                    limit: 1, // Minimal fetch — we only need the count
+                });
+                return { ...v, sessionCount: total };
+            }
+            catch {
+                return { ...v, sessionCount: 0 };
+            }
+        }));
+        return c.json({
+            ...benchmark,
+            variants: variantsWithCounts,
+        });
+    });
+    // ─── PUT /:id/status — Transition status ────────────────
+    app.put('/:id/status', async (c) => {
+        const benchmarkStore = getBenchmarkStore(c);
+        if (!benchmarkStore) {
+            return c.json({ error: 'Database not available', status: 500 }, 500);
+        }
+        const tenantId = getTenantId(c);
+        const id = c.req.param('id');
+        const body = await c.req.json().catch(() => null);
+        if (!body || !body.status) {
+            return c.json({ error: 'status is required', status: 400 }, 400);
+        }
+        if (!VALID_STATUSES.has(body.status)) {
+            return c.json({ error: `Invalid status: ${body.status}`, status: 400 }, 400);
+        }
+        const newStatus = body.status;
+        // Get current benchmark
+        const current = benchmarkStore.getById(tenantId, id);
+        if (!current) {
+            return c.json({ error: 'Benchmark not found', status: 404 }, 404);
+        }
+        // When transitioning to "running": validate ≥1 session per variant
+        if (newStatus === 'running') {
+            const tenantStore = getTenantStore(store, c);
+            for (const v of current.variants) {
+                const { sessions } = await tenantStore.querySessions({
+                    tenantId: v.tenantId,
+                    agentId: v.agentId,
+                    tags: [v.tag],
+                    from: current.timeRange?.from,
+                    to: current.timeRange?.to,
+                    limit: 1,
+                });
+                if (sessions.length === 0) {
+                    return c.json({
+                        error: `Variant "${v.name}" has no sessions. Each variant must have at least 1 session to start.`,
+                        status: 409,
+                    }, 409);
+                }
+            }
+        }
+        try {
+            const updated = benchmarkStore.updateStatus(tenantId, id, newStatus);
+            // When transitioning to "completed": compute and cache results
+            if (newStatus === 'completed') {
+                const tenantStore = getTenantStore(store, c);
+                await engine.computeResults(updated, tenantStore, benchmarkStore);
+            }
+            return c.json(updated);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to update status';
+            if (message.includes('Invalid status transition')) {
+                return c.json({ error: message, status: 409 }, 409);
+            }
+            return c.json({ error: message, status: 400 }, 400);
+        }
+    });
+    // ─── GET /:id/results — Get comparison results ──────────
+    app.get('/:id/results', async (c) => {
+        const benchmarkStore = getBenchmarkStore(c);
+        if (!benchmarkStore) {
+            return c.json({ error: 'Database not available', status: 500 }, 500);
+        }
+        const tenantId = getTenantId(c);
+        const id = c.req.param('id');
+        const benchmark = benchmarkStore.getById(tenantId, id);
+        if (!benchmark) {
+            return c.json({ error: 'Benchmark not found', status: 404 }, 404);
+        }
+        // Draft benchmarks can't have results
+        if (benchmark.status === 'draft') {
+            return c.json({ error: 'Cannot get results for a draft benchmark. Start it first.', status: 400 }, 400);
+        }
+        const tenantStore = getTenantStore(store, c);
+        const results = await engine.computeResults(benchmark, tenantStore, benchmarkStore);
+        // Strip distributions unless requested
+        const includeDistributions = c.req.query('includeDistributions') === 'true';
+        if (!includeDistributions) {
+            for (const v of results.variants) {
+                for (const key of Object.keys(v.metrics)) {
+                    const stats = v.metrics[key];
+                    if (stats) {
+                        delete stats.values;
+                    }
+                }
+            }
+        }
+        return c.json(results);
+    });
+    // ─── DELETE /:id — Delete benchmark ─────────────────────
+    app.delete('/:id', async (c) => {
+        const benchmarkStore = getBenchmarkStore(c);
+        if (!benchmarkStore) {
+            return c.json({ error: 'Database not available', status: 500 }, 500);
+        }
+        const tenantId = getTenantId(c);
+        const id = c.req.param('id');
+        const benchmark = benchmarkStore.getById(tenantId, id);
+        if (!benchmark) {
+            return c.json({ error: 'Benchmark not found', status: 404 }, 404);
+        }
+        if (benchmark.status === 'running' || benchmark.status === 'completed') {
+            return c.json({ error: `Cannot delete a ${benchmark.status} benchmark`, status: 409 }, 409);
+        }
+        benchmarkStore.delete(tenantId, id);
+        return c.body(null, 204);
+    });
+    return app;
+}
+//# sourceMappingURL=benchmarks.js.map

package/dist/routes/benchmarks.js.map

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

package/dist/routes/replay.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Replay REST Endpoint (Stories 2.2, 2.3)
+ *
+ * GET /api/sessions/:id/replay — Returns ReplayState for session replay UI.
+ *
+ * Supports pagination, event type filtering, and server-side LRU caching.
+ */
+import { Hono } from 'hono';
+import type { IEventStore, ReplayState } from '@agentlensai/core';
+import type { AuthVariables } from '../middleware/auth.js';
+interface CacheEntry {
+    state: ReplayState;
+    createdAt: number;
+}
+/** Simple Map-based LRU cache with TTL. Exported for testing. */
+export declare const replayCache: Map<string, CacheEntry>;
+/**
+ * Register the replay route directly on the provided Hono app.
+ * Path: GET /api/sessions/:id/replay
+ *
+ * Uses `registerReplayRoutes(app, store)` pattern (like health routes)
+ * since the path nests under /api/sessions which already has auth middleware.
+ */
+export declare function registerReplayRoutes(app: Hono<{
+    Variables: AuthVariables;
+}>, store: IEventStore): void;
+export {};
+//# sourceMappingURL=replay.d.ts.map

package/dist/routes/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/routes/replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAU3D,UAAU,UAAU;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iEAAiE;AACjE,eAAO,MAAM,WAAW,yBAAgC,CAAC;AAmDzD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CAAC;IAAE,SAAS,EAAE,aAAa,CAAA;CAAE,CAAC,EACvC,KAAK,EAAE,WAAW,GACjB,IAAI,CAgGN"}

package/dist/routes/replay.js

@@ -0,0 +1,140 @@
+/**
+ * Replay REST Endpoint (Stories 2.2, 2.3)
+ *
+ * GET /api/sessions/:id/replay — Returns ReplayState for session replay UI.
+ *
+ * Supports pagination, event type filtering, and server-side LRU caching.
+ */
+import { Hono } from 'hono';
+import { EVENT_TYPES } from '@agentlensai/core';
+import { getTenantStore } from './tenant-helper.js';
+import { ReplayBuilder } from '../lib/replay/builder.js';
+// ─── LRU Cache (Story 2.3) ────────────────────────────────
+const MAX_CACHE_SIZE = 100;
+const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
+const LLM_HISTORY_CAP = 50;
+/** Simple Map-based LRU cache with TTL. Exported for testing. */
+export const replayCache = new Map();
+function cacheKey(tenantId, sessionId) {
+    return `${tenantId}:${sessionId}`;
+}
+function getCached(tenantId, sessionId) {
+    const key = cacheKey(tenantId, sessionId);
+    const entry = replayCache.get(key);
+    if (!entry)
+        return null;
+    // TTL check
+    if (Date.now() - entry.createdAt > CACHE_TTL_MS) {
+        replayCache.delete(key);
+        return null;
+    }
+    // Move to end (most-recently-used)
+    replayCache.delete(key);
+    replayCache.set(key, entry);
+    return entry.state;
+}
+function putCache(tenantId, sessionId, state) {
+    const key = cacheKey(tenantId, sessionId);
+    // Evict if at capacity (remove oldest = first entry)
+    if (replayCache.size >= MAX_CACHE_SIZE && !replayCache.has(key)) {
+        const firstKey = replayCache.keys().next().value;
+        if (firstKey !== undefined) {
+            replayCache.delete(firstKey);
+        }
+    }
+    replayCache.set(key, { state, createdAt: Date.now() });
+}
+/**
+ * Cap LLM history in context to the last N entries (memory guard).
+ */
+function capLlmHistory(state) {
+    for (const step of state.steps) {
+        if (step.context.llmHistory.length > LLM_HISTORY_CAP) {
+            step.context.llmHistory = step.context.llmHistory.slice(-LLM_HISTORY_CAP);
+        }
+    }
+    return state;
+}
+// ─── Route Registration ────────────────────────────────────
+/**
+ * Register the replay route directly on the provided Hono app.
+ * Path: GET /api/sessions/:id/replay
+ *
+ * Uses `registerReplayRoutes(app, store)` pattern (like health routes)
+ * since the path nests under /api/sessions which already has auth middleware.
+ */
+export function registerReplayRoutes(app, store) {
+    app.get('/api/sessions/:id/replay', async (c) => {
+        const tenantStore = getTenantStore(store, c);
+        const sessionId = c.req.param('id');
+        // ── Parse & validate query params ──
+        // offset
+        const offsetStr = c.req.query('offset');
+        let offset = 0;
+        if (offsetStr !== undefined && offsetStr !== '') {
+            const parsed = parseInt(offsetStr, 10);
+            if (isNaN(parsed) || parsed < 0) {
+                return c.json({ error: 'Invalid offset: must be a non-negative integer', status: 400 }, 400);
+            }
+            offset = parsed;
+        }
+        // limit
+        const limitStr = c.req.query('limit');
+        let limit = 1000;
+        if (limitStr !== undefined && limitStr !== '') {
+            const parsed = parseInt(limitStr, 10);
+            if (isNaN(parsed) || parsed < 1 || parsed > 5000) {
+                return c.json({ error: 'Invalid limit: must be an integer between 1 and 5000', status: 400 }, 400);
+            }
+            limit = parsed;
+        }
+        // eventTypes
+        const eventTypesStr = c.req.query('eventTypes');
+        let eventTypes;
+        if (eventTypesStr !== undefined && eventTypesStr !== '') {
+            const types = eventTypesStr.split(',').map((s) => s.trim());
+            const validTypes = new Set(EVENT_TYPES);
+            for (const t of types) {
+                if (!validTypes.has(t)) {
+                    return c.json({ error: `Invalid event type: ${t}`, status: 400 }, 400);
+                }
+            }
+            eventTypes = types;
+        }
+        // includeContext
+        const includeContextStr = c.req.query('includeContext');
+        let includeContext = true;
+        if (includeContextStr !== undefined && includeContextStr !== '') {
+            if (includeContextStr === 'false' || includeContextStr === '0') {
+                includeContext = false;
+            }
+            else if (includeContextStr !== 'true' && includeContextStr !== '1') {
+                return c.json({ error: 'Invalid includeContext: must be true or false', status: 400 }, 400);
+            }
+        }
+        try {
+            const builder = new ReplayBuilder(tenantStore);
+            const state = await builder.build(sessionId, {
+                offset,
+                limit,
+                eventTypes,
+                includeContext,
+            });
+            if (!state) {
+                return c.json({ error: 'Session not found', status: 404 }, 404);
+            }
+            // Apply memory guard: cap LLM history
+            capLlmHistory(state);
+            // Cache the state (LLM history has been capped for memory efficiency)
+            const apiKeyInfo = c.get('apiKey');
+            const tenantId = apiKeyInfo?.tenantId ?? 'default';
+            putCache(tenantId, sessionId, state);
+            return c.json(state);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Internal error';
+            return c.json({ error: message, status: 500 }, 500);
+        }
+    });
+}
+//# sourceMappingURL=replay.js.map

package/dist/routes/replay.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlensai/server",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "AgentLens API server — event ingestion, querying, dashboard, and alerting for AI agents",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
     "dev": "tsx watch src/index.ts"
   },
   "dependencies": {
-    "@agentlensai/core": "workspace:*",
+    "@agentlensai/core": "^0.7.0",
     "drizzle-orm": "^0.44.2",
     "better-sqlite3": "^11.9.1",
     "hono": "^4.7.10",