@agentlensai/server 0.6.0 → 0.8.0

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.8.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.8.0",
     "drizzle-orm": "^0.44.2",
     "better-sqlite3": "^11.9.1",
     "hono": "^4.7.10",