@agentlensai/server 0.3.0 → 0.6.0

package/dist/lib/analysis/index.js

@@ -0,0 +1,144 @@
+/**
+ * Analysis Dispatcher (Story 4.6)
+ *
+ * Maps analysis type strings to handler functions and converts
+ * their results into the unified ReflectResult format.
+ */
+import { analyzeErrorPatterns } from './error-patterns.js';
+import { analyzeToolSequences } from './tool-sequences.js';
+import { analyzeCosts } from './cost-analysis.js';
+import { analyzePerformance } from './performance-trends.js';
+/**
+ * Run an analysis by type string and return a unified ReflectResult.
+ */
+export async function runAnalysis(analysis, store, opts = {}) {
+    switch (analysis) {
+        case 'error_patterns':
+            return runErrorPatterns(store, opts);
+        case 'tool_sequences':
+            return runToolSequences(store, opts);
+        case 'cost_analysis':
+            return runCostAnalysis(store, opts);
+        case 'performance_trends':
+            return runPerformanceTrends(store, opts);
+        default:
+            throw new Error(`Unknown analysis type: ${analysis}`);
+    }
+}
+async function runErrorPatterns(store, opts) {
+    const result = await analyzeErrorPatterns(store, opts);
+    const insights = result.patterns.map((p) => ({
+        type: 'error_pattern',
+        summary: `Error pattern "${p.pattern}" occurred ${p.count} time(s) across ${p.affectedSessions.length} session(s)`,
+        data: {
+            pattern: p.pattern,
+            count: p.count,
+            firstSeen: p.firstSeen,
+            lastSeen: p.lastSeen,
+            affectedSessions: p.affectedSessions,
+            precedingTools: p.precedingTools,
+        },
+        confidence: Math.min(0.5 + p.count * 0.1, 1.0),
+    }));
+    return {
+        analysis: 'error_patterns',
+        insights,
+        metadata: {
+            sessionsAnalyzed: new Set(result.patterns.flatMap((p) => p.affectedSessions)).size,
+            eventsAnalyzed: result.metadata.eventsAnalyzed,
+            timeRange: result.metadata.timeRange,
+        },
+    };
+}
+async function runToolSequences(store, opts) {
+    const result = await analyzeToolSequences(store, opts);
+    const insights = result.sequences.map((s) => ({
+        type: s.errorRate > 0 ? 'error_prone_sequence' : 'tool_sequence',
+        summary: `Sequence [${s.tools.join(' → ')}] used ${s.frequency} time(s) across ${s.sessions} session(s)${s.errorRate > 0 ? ` (${Math.round(s.errorRate * 100)}% error rate)` : ''}`,
+        data: {
+            tools: s.tools,
+            frequency: s.frequency,
+            sessions: s.sessions,
+            errorRate: s.errorRate,
+        },
+        confidence: Math.min(0.4 + s.frequency * 0.1, 1.0),
+    }));
+    return {
+        analysis: 'tool_sequences',
+        insights,
+        metadata: {
+            sessionsAnalyzed: result.stats.totalCalls > 0 ? result.sequences.reduce((max, s) => Math.max(max, s.sessions), 0) : 0,
+            eventsAnalyzed: result.metadata.eventsAnalyzed,
+            timeRange: result.metadata.timeRange,
+        },
+    };
+}
+async function runCostAnalysis(store, opts) {
+    const model = opts.params?.model;
+    const result = await analyzeCosts(store, { ...opts, model });
+    const insights = [];
+    // Summary insight
+    insights.push({
+        type: 'cost_summary',
+        summary: `Total cost: $${result.summary.totalCost.toFixed(4)} across ${result.summary.totalSessions} session(s) (avg $${result.summary.avgPerSession.toFixed(4)}/session)`,
+        data: result.summary,
+        confidence: 1.0,
+    });
+    // Trend insight
+    insights.push({
+        type: 'cost_trend',
+        summary: `Cost trend is ${result.trend.direction}`,
+        data: {
+            direction: result.trend.direction,
+            bucketCount: result.trend.buckets.length,
+        },
+        confidence: result.trend.buckets.length >= 7 ? 0.8 : 0.5,
+    });
+    // Top model insights
+    for (const m of result.byModel.slice(0, 3)) {
+        insights.push({
+            type: 'cost_by_model',
+            summary: `Model "${m.model}": $${m.totalCost.toFixed(4)} (${m.callCount} calls, avg $${m.avgCostPerCall.toFixed(4)}/call)`,
+            data: m,
+            confidence: 0.9,
+        });
+    }
+    return {
+        analysis: 'cost_analysis',
+        insights,
+        metadata: {
+            sessionsAnalyzed: result.summary.totalSessions,
+            eventsAnalyzed: result.metadata.eventsAnalyzed,
+            timeRange: result.metadata.timeRange,
+        },
+    };
+}
+async function runPerformanceTrends(store, opts) {
+    const result = await analyzePerformance(store, opts);
+    const insights = [];
+    // Current performance insight
+    insights.push({
+        type: 'performance_current',
+        summary: `Current: ${Math.round(result.current.successRate * 100)}% success rate, avg ${result.current.avgDuration}ms duration, ${result.current.avgToolCalls} tool calls/session, ${result.current.avgErrors} errors/session`,
+        data: result.current,
+        confidence: result.metadata.sessionsAnalyzed >= 10 ? 0.9 : 0.6,
+    });
+    // Assessment insight
+    insights.push({
+        type: 'performance_assessment',
+        summary: `Performance trend: ${result.assessment}`,
+        data: { assessment: result.assessment },
+        confidence: result.trends.length >= 4 ? 0.8 : 0.5,
+    });
+    return {
+        analysis: 'performance_trends',
+        insights,
+        metadata: result.metadata,
+    };
+}
+// Re-export individual analysis functions
+export { analyzeErrorPatterns } from './error-patterns.js';
+export { analyzeToolSequences } from './tool-sequences.js';
+export { analyzeCosts } from './cost-analysis.js';
+export { analyzePerformance } from './performance-trends.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/analysis/index.js.map

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

package/dist/lib/analysis/performance-trends.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Performance Trends Analysis (Story 4.4)
+ *
+ * Analyzes sessions over time to calculate success rates, durations,
+ * tool call averages, and error averages, with trend detection.
+ */
+import type { IEventStore } from '@agentlensai/core';
+import type { PerformanceTrendsResult } from '@agentlensai/core';
+export interface PerformanceTrendsOpts {
+    agentId?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+/**
+ * Analyze performance trends across sessions.
+ */
+export declare function analyzePerformance(store: IEventStore, opts?: PerformanceTrendsOpts): Promise<PerformanceTrendsResult>;
+//# sourceMappingURL=performance-trends.d.ts.map

package/dist/lib/analysis/performance-trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-trends.d.ts","sourceRoot":"","sources":["../../../src/lib/analysis/performance-trends.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACpC,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;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAiHlC"}

package/dist/lib/analysis/performance-trends.js

@@ -0,0 +1,121 @@
+/**
+ * Performance Trends Analysis (Story 4.4)
+ *
+ * Analyzes sessions over time to calculate success rates, durations,
+ * tool call averages, and error averages, with trend detection.
+ */
+/**
+ * Analyze performance trends across sessions.
+ */
+export async function analyzePerformance(store, opts = {}) {
+    // Query sessions
+    const sessionResult = await store.querySessions({
+        agentId: opts.agentId,
+        from: opts.from,
+        to: opts.to,
+        limit: 1000,
+    });
+    // Track whether the query hit its limit (results may be truncated)
+    const possiblyTruncated = sessionResult.sessions.length === 1000;
+    const sessions = sessionResult.sessions;
+    const sessionsAnalyzed = sessions.length;
+    // Count events for metadata
+    const eventCount = await store.countEvents({
+        agentId: opts.agentId,
+        from: opts.from,
+        to: opts.to,
+    });
+    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 ?? ''),
+    };
+    // Current aggregate metrics
+    const successCount = sessions.filter((s) => s.errorCount === 0).length;
+    const successRate = sessionsAnalyzed > 0 ? successCount / sessionsAnalyzed : 0;
+    const durations = sessions
+        .filter((s) => s.endedAt && s.startedAt)
+        .map((s) => new Date(s.endedAt).getTime() - new Date(s.startedAt).getTime());
+    const avgDuration = durations.length > 0 ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
+    const avgToolCalls = sessionsAnalyzed > 0
+        ? sessions.reduce((sum, s) => sum + s.toolCallCount, 0) / sessionsAnalyzed
+        : 0;
+    const avgErrors = sessionsAnalyzed > 0
+        ? sessions.reduce((sum, s) => sum + s.errorCount, 0) / sessionsAnalyzed
+        : 0;
+    // Bucket by day for trend lines
+    const dailyMap = new Map();
+    for (const session of sessions) {
+        const date = session.startedAt.slice(0, 10); // YYYY-MM-DD
+        const entry = dailyMap.get(date) ?? { sessions: [] };
+        entry.sessions.push(session);
+        dailyMap.set(date, entry);
+    }
+    const limit = opts.limit ?? 20;
+    const allBuckets = Array.from(dailyMap.entries())
+        .map(([date, data]) => {
+        const daySessions = data.sessions;
+        const daySuccess = daySessions.filter((s) => s.errorCount === 0).length;
+        const dayDurations = daySessions
+            .filter((s) => s.endedAt && s.startedAt)
+            .map((s) => new Date(s.endedAt).getTime() - new Date(s.startedAt).getTime());
+        return {
+            date,
+            successRate: daySessions.length > 0 ? daySuccess / daySessions.length : 0,
+            duration: dayDurations.length > 0
+                ? dayDurations.reduce((a, b) => a + b, 0) / dayDurations.length
+                : 0,
+            toolCalls: daySessions.length > 0
+                ? daySessions.reduce((sum, s) => sum + s.toolCallCount, 0) / daySessions.length
+                : 0,
+            errors: daySessions.length > 0
+                ? daySessions.reduce((sum, s) => sum + s.errorCount, 0) / daySessions.length
+                : 0,
+        };
+    })
+        .sort((a, b) => a.date.localeCompare(b.date));
+    // Respect limit on trend buckets
+    const trends = allBuckets.slice(-limit);
+    // Trend assessment: compare recent half vs historical half
+    const assessment = detectPerformanceTrend(allBuckets);
+    return {
+        current: {
+            successRate: Math.round(successRate * 10000) / 10000,
+            avgDuration: Math.round(avgDuration),
+            avgToolCalls: Math.round(avgToolCalls * 100) / 100,
+            avgErrors: Math.round(avgErrors * 100) / 100,
+        },
+        trends,
+        assessment,
+        metadata: {
+            sessionsAnalyzed,
+            eventsAnalyzed: eventCount,
+            timeRange,
+            ...(possiblyTruncated ? { truncated: true, note: 'Results may be incomplete — query limit reached' } : {}),
+        },
+    };
+}
+/**
+ * Detect performance trend by comparing recent vs historical success rates.
+ */
+function detectPerformanceTrend(buckets) {
+    if (buckets.length < 2)
+        return 'stable';
+    const midpoint = Math.floor(buckets.length / 2);
+    const recent = buckets.slice(midpoint);
+    const historical = buckets.slice(0, midpoint);
+    if (historical.length === 0 || recent.length === 0)
+        return 'stable';
+    const recentAvgSuccess = recent.reduce((s, b) => s + b.successRate, 0) / recent.length;
+    const historicalAvgSuccess = historical.reduce((s, b) => s + b.successRate, 0) / historical.length;
+    const diff = recentAvgSuccess - historicalAvgSuccess;
+    if (diff > 0.05)
+        return 'improving';
+    if (diff < -0.05)
+        return 'degrading';
+    return 'stable';
+}
+//# sourceMappingURL=performance-trends.js.map

package/dist/lib/analysis/performance-trends.js.map

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

package/dist/lib/analysis/tool-sequences.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool Sequence Analysis (Story 4.2)
+ *
+ * Analyzes tool_call events to extract N-grams (2-grams and 3-grams)
+ * of tool sequences per session, and identifies error-prone sequences.
+ */
+import type { IEventStore } from '@agentlensai/core';
+import type { ToolSequenceResult } from '@agentlensai/core';
+export interface ToolSequenceOpts {
+    agentId?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+/**
+ * Analyze tool usage sequences across sessions.
+ */
+export declare function analyzeToolSequences(store: IEventStore, opts?: ToolSequenceOpts): Promise<ToolSequenceResult>;
+//# sourceMappingURL=tool-sequences.d.ts.map

package/dist/lib/analysis/tool-sequences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-sequences.d.ts","sourceRoot":"","sources":["../../../src/lib/analysis/tool-sequences.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;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAmK7B"}

package/dist/lib/analysis/tool-sequences.js

@@ -0,0 +1,148 @@
+/**
+ * Tool Sequence Analysis (Story 4.2)
+ *
+ * Analyzes tool_call events to extract N-grams (2-grams and 3-grams)
+ * of tool sequences per session, and identifies error-prone sequences.
+ */
+/**
+ * Analyze tool usage sequences across sessions.
+ */
+export async function analyzeToolSequences(store, opts = {}) {
+    const limit = opts.limit ?? 20;
+    // Query tool_call events
+    const toolCallResult = await store.queryEvents({
+        agentId: opts.agentId,
+        from: opts.from,
+        to: opts.to,
+        eventType: 'tool_call',
+        limit: 1000,
+        order: 'asc',
+    });
+    // Also query tool_error events to identify error-prone sequences
+    const toolErrorResult = await store.queryEvents({
+        agentId: opts.agentId,
+        from: opts.from,
+        to: opts.to,
+        eventType: 'tool_error',
+        limit: 1000,
+        order: 'asc',
+    });
+    // Track whether either query hit its limit (results may be truncated)
+    const possiblyTruncated = toolCallResult.events.length === 1000 || toolErrorResult.events.length === 1000;
+    const allToolCalls = toolCallResult.events;
+    const allToolErrors = toolErrorResult.events;
+    const eventsAnalyzed = allToolCalls.length + allToolErrors.length;
+    const timeRange = {
+        from: allToolCalls.length > 0 ? allToolCalls[0].timestamp : (opts.from ?? ''),
+        to: allToolCalls.length > 0 ? allToolCalls[allToolCalls.length - 1].timestamp : (opts.to ?? ''),
+    };
+    // Group tool_call events by session
+    const sessionToolCalls = new Map();
+    for (const event of allToolCalls) {
+        const list = sessionToolCalls.get(event.sessionId) ?? [];
+        list.push(event);
+        sessionToolCalls.set(event.sessionId, list);
+    }
+    // Group tool_error events by session for error-prone detection
+    const sessionErrors = new Map();
+    for (const event of allToolErrors) {
+        const list = sessionErrors.get(event.sessionId) ?? [];
+        list.push(event);
+        sessionErrors.set(event.sessionId, list);
+    }
+    // Extract tool names per session (ordered by timestamp)
+    const uniqueToolsSet = new Set();
+    let totalCalls = 0;
+    const sessionToolNames = new Map();
+    for (const [sessionId, calls] of sessionToolCalls) {
+        const names = calls.map((e) => {
+            const p = e.payload;
+            const name = String(p.toolName ?? 'unknown');
+            uniqueToolsSet.add(name);
+            return name;
+        });
+        sessionToolNames.set(sessionId, names);
+        totalCalls += names.length;
+    }
+    // Extract N-grams and count frequencies
+    // key = tools joined by "→", value = { frequency across sessions, set of sessions, errorFollowed count }
+    const ngramMap = new Map();
+    for (const [sessionId, toolNames] of sessionToolNames) {
+        const sessionErrorEvents = sessionErrors.get(sessionId) ?? [];
+        // Get the full session timeline for error-proximity checks
+        const sessionCalls = sessionToolCalls.get(sessionId) ?? [];
+        // Extract 2-grams and 3-grams
+        const seenInSession = new Set(); // Avoid counting same ngram twice per session
+        for (const n of [2, 3]) {
+            for (let i = 0; i <= toolNames.length - n; i++) {
+                const ngram = toolNames.slice(i, i + n);
+                const key = ngram.join('→');
+                if (!seenInSession.has(key)) {
+                    seenInSession.add(key);
+                    let entry = ngramMap.get(key);
+                    if (!entry) {
+                        entry = { tools: ngram, frequency: 0, sessions: new Set(), errorFollowed: 0 };
+                        ngramMap.set(key, entry);
+                    }
+                    entry.frequency++;
+                    entry.sessions.add(sessionId);
+                }
+                // Check if this ngram is followed by an error within 2 events
+                // The last event of the ngram is at index i + n - 1 in sessionCalls
+                const lastCallInNgram = sessionCalls[i + n - 1];
+                if (lastCallInNgram) {
+                    const isErrorFollowed = sessionErrorEvents.some((errEvt) => {
+                        // Error must be after the last tool call in ngram
+                        // and within 2 "event positions" (by timestamp)
+                        if (errEvt.timestamp < lastCallInNgram.timestamp)
+                            return false;
+                        // Count how many tool_call events are between the last ngram call and the error
+                        const callsAfter = sessionCalls.filter((c) => c.timestamp > lastCallInNgram.timestamp && c.timestamp <= errEvt.timestamp);
+                        return callsAfter.length <= 2;
+                    });
+                    if (isErrorFollowed) {
+                        // We only count this once per session per ngram for error rate calculation
+                        // But we need to track total occurrences vs error-followed
+                        let entry = ngramMap.get(key);
+                        // Track on first occurrence in session
+                        if (seenInSession.has(`${key}:error-checked`))
+                            continue;
+                        seenInSession.add(`${key}:error-checked`);
+                        entry.errorFollowed++;
+                    }
+                }
+            }
+        }
+    }
+    // Calculate stats
+    const sessionLengths = Array.from(sessionToolNames.values()).map((n) => n.length);
+    const avgSequenceLength = sessionLengths.length > 0
+        ? sessionLengths.reduce((a, b) => a + b, 0) / sessionLengths.length
+        : 0;
+    // Build sorted results
+    const sequences = Array.from(ngramMap.values())
+        .map((entry) => ({
+        tools: entry.tools,
+        frequency: entry.frequency,
+        sessions: entry.sessions.size,
+        errorRate: entry.sessions.size > 0
+            ? entry.errorFollowed / entry.sessions.size
+            : 0,
+    }))
+        .sort((a, b) => b.frequency - a.frequency)
+        .slice(0, limit);
+    return {
+        sequences,
+        stats: {
+            avgSequenceLength: Math.round(avgSequenceLength * 100) / 100,
+            uniqueTools: uniqueToolsSet.size,
+            totalCalls,
+        },
+        metadata: {
+            eventsAnalyzed,
+            timeRange,
+            ...(possiblyTruncated ? { truncated: true, note: 'Results may be incomplete — query limit reached' } : {}),
+        },
+    };
+}
+//# sourceMappingURL=tool-sequences.js.map

package/dist/lib/analysis/tool-sequences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-sequences.js","sourceRoot":"","sources":["../../../src/lib/analysis/tool-sequences.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAkB,EAClB,OAAyB,EAAE;IAE3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/B,yBAAyB;IACzB,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;QAC7C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,SAAS,EAAE,WAAW;QACtB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,iEAAiE;IACjE,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;QAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,sEAAsE;IACtE,MAAM,iBAAiB,GACrB,cAAc,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;IAElF,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC;IAC3C,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC;IAE7C,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAClE,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9E,EAAE,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;KACjG,CAAC;IAEF,oCAAoC;IACpC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,+DAA+D;IAC/D,MAAM,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,wDAAwD;IACxD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;YAC7C,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,wCAAwC;IACxC,yGAAyG;IACzG,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAC;IAEJ,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACtD,MAAM,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAE9D,2DAA2D;QAC3D,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAE3D,8BAA8B;QAC9B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC,CAAC,8CAA8C;QACvF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAE5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACvB,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,KAAK,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;wBAC9E,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBAC3B,CAAC;oBACD,KAAK,CAAC,SAAS,EAAE,CAAC;oBAClB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAChC,CAAC;gBAED,8DAA8D;gBAC9D,oEAAoE;gBACpE,MAAM,eAAe,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChD,IAAI,eAAe,EAAE,CAAC;oBACpB,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;wBACzD,kDAAkD;wBAClD,gDAAgD;wBAChD,IAAI,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS;4BAAE,OAAO,KAAK,CAAC;wBAE/D,gFAAgF;wBAChF,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAClF,CAAC;wBACF,OAAO,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;oBAChC,CAAC,CAAC,CAAC;oBAEH,IAAI,eAAe,EAAE,CAAC;wBACpB,2EAA2E;wBAC3E,2DAA2D;wBAC3D,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;wBAC/B,uCAAuC;wBACvC,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,GAAG,gBAAgB,CAAC;4BAAE,SAAS;wBACxD,aAAa,CAAC,GAAG,CAAC,GAAG,GAAG,gBAAgB,CAAC,CAAC;wBAC1C,KAAK,CAAC,aAAa,EAAE,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClF,MAAM,iBAAiB,GACrB,cAAc,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM;QACnE,CAAC,CAAC,CAAC,CAAC;IAER,uBAAuB;IACvB,MAAM,SAAS,GAAmB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;SAC5D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;QAC7B,SAAS,EACP,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;YACrB,CAAC,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI;YAC3C,CAAC,CAAC,CAAC;KACR,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;SACzC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEnB,OAAO;QACL,SAAS;QACT,KAAK,EAAE;YACL,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,GAAG,CAAC,GAAG,GAAG;YAC5D,WAAW,EAAE,cAAc,CAAC,IAAI;YAChC,UAAU;SACX;QACD,QAAQ,EAAE;YACR,cAAc;YACd,SAAS;YACT,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,iDAAiD,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3G;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/context/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Context Retrieval — exports (Epic 5)
+ */
+export { ContextRetriever } from './retrieval.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/context/index.js

@@ -0,0 +1,5 @@
+/**
+ * Context Retrieval — exports (Epic 5)
+ */
+export { ContextRetriever } from './retrieval.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/context/retrieval.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Context Retriever (Story 5.2)
+ *
+ * Combines semantic search over session summaries, lesson search,
+ * and key event retrieval to build cross-session context.
+ *
+ * Falls back to text search when embeddings are unavailable.
+ */
+import type { ContextQuery, ContextResult } from '@agentlensai/core';
+import type { EmbeddingStore } from '../../db/embedding-store.js';
+import type { EmbeddingService } from '../embeddings/index.js';
+import type { SessionSummaryStore } from '../../db/session-summary-store.js';
+import type { LessonStore } from '../../db/lesson-store.js';
+import type { IEventStore } from '@agentlensai/core';
+export declare class ContextRetriever {
+    private readonly embeddingStore;
+    private readonly embeddingService;
+    private readonly sessionSummaryStore;
+    private readonly lessonStore;
+    private readonly eventStore;
+    constructor(embeddingStore: EmbeddingStore | null, embeddingService: EmbeddingService | null, sessionSummaryStore: SessionSummaryStore, lessonStore: LessonStore, eventStore: IEventStore);
+    /**
+     * Retrieve cross-session context by combining:
+     * 1. Semantic search over session summary embeddings
+     * 2. Lesson search (semantic or text-based)
+     * 3. Key events for matching sessions
+     * 4. Ranking by relevance + recency
+     *
+     * TODO: userId filtering is accepted in the ContextQuery type but not yet
+     * implemented. Requires schema changes to associate sessions/events with
+     * a userId before we can filter here. Deferred to a future release.
+     */
+    retrieve(tenantId: string, query: ContextQuery): Promise<ContextResult>;
+    /**
+     * Find relevant sessions using semantic search (with text search fallback).
+     */
+    private findRelevantSessions;
+    /**
+     * Filter semantic search results by agentId/userId and rank by relevance + recency.
+     */
+    private filterAndRankSessions;
+    /**
+     * Text search fallback when embeddings are unavailable.
+     */
+    private textSearchSessions;
+    /**
+     * Find relevant lessons using semantic search (with text search fallback).
+     */
+    private findRelevantLessons;
+    /**
+     * Enrich a session result with key events from the timeline.
+     */
+    private enrichSessionWithEvents;
+    /**
+     * Compute a recency boost (0-1) based on how recent the content is.
+     * Items from the last 24h get ~1.0, items from 30+ days ago get ~0.0.
+     */
+    private computeRecencyBoost;
+}
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/lib/context/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../../src/lib/context/retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAkD,MAAM,mBAAmB,CAAC;AACrH,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,6BAA6B,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAwB,MAAM,mCAAmC,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,EACzC,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,WAAW;IAG1C;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB7E;;OAEG;YACW,oBAAoB;IA6BlC;;OAEG;YACW,qBAAqB;IAwCnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;YACW,mBAAmB;IAwDjC;;OAEG;YACW,uBAAuB;IA+CrC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAU5B"}