@agentlensai/server 0.3.0 → 0.6.0

package/dist/lib/context/retrieval.js

@@ -0,0 +1,233 @@
+/**
+ * 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 { summarizeEvent } from '../embeddings/summarizer.js';
+/** Default maximum results */
+const DEFAULT_LIMIT = 10;
+/** Maximum key events per session in results */
+const MAX_KEY_EVENTS = 5;
+export class ContextRetriever {
+    embeddingStore;
+    embeddingService;
+    sessionSummaryStore;
+    lessonStore;
+    eventStore;
+    constructor(embeddingStore, embeddingService, sessionSummaryStore, lessonStore, eventStore) {
+        this.embeddingStore = embeddingStore;
+        this.embeddingService = embeddingService;
+        this.sessionSummaryStore = sessionSummaryStore;
+        this.lessonStore = lessonStore;
+        this.eventStore = eventStore;
+    }
+    /**
+     * 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.
+     */
+    async retrieve(tenantId, query) {
+        const limit = query.limit ?? DEFAULT_LIMIT;
+        // Step 1: Find relevant sessions
+        const sessionResults = await this.findRelevantSessions(tenantId, query, limit);
+        // Step 2: Find relevant lessons
+        const lessonResults = await this.findRelevantLessons(tenantId, query, limit);
+        // Step 3: For each matching session, get key events
+        const sessionsWithEvents = await Promise.all(sessionResults.map((s) => this.enrichSessionWithEvents(tenantId, s)));
+        return {
+            topic: query.topic,
+            sessions: sessionsWithEvents,
+            lessons: lessonResults,
+            totalSessions: sessionsWithEvents.length,
+        };
+    }
+    /**
+     * Find relevant sessions using semantic search (with text search fallback).
+     */
+    async findRelevantSessions(tenantId, query, limit) {
+        // Try semantic search first
+        if (this.embeddingService && this.embeddingStore) {
+            try {
+                const queryVector = await this.embeddingService.embed(query.topic);
+                const results = this.embeddingStore.similaritySearch(tenantId, queryVector, {
+                    sourceType: 'session',
+                    from: query.from,
+                    to: query.to,
+                    limit: limit * 2, // over-fetch for post-filtering
+                    minScore: 0.3,
+                });
+                if (results.length > 0) {
+                    return this.filterAndRankSessions(tenantId, results, query, limit);
+                }
+            }
+            catch {
+                // Fall through to text search
+            }
+        }
+        // Fallback: text search on session summaries
+        return this.textSearchSessions(tenantId, query, limit);
+    }
+    /**
+     * Filter semantic search results by agentId/userId and rank by relevance + recency.
+     */
+    async filterAndRankSessions(tenantId, results, query, limit) {
+        const sessions = [];
+        for (const result of results) {
+            // sourceId is the sessionId for session-scope embeddings
+            const sessionId = result.sourceId;
+            // Filter by agentId if provided
+            if (query.agentId) {
+                const session = await this.eventStore.getSession(sessionId);
+                if (!session || session.agentId !== query.agentId)
+                    continue;
+            }
+            // Get the summary text from the store (richer than embedding text)
+            const summaryRecord = this.sessionSummaryStore.get(tenantId, sessionId);
+            const summary = summaryRecord?.summary ?? result.text;
+            // Recency boost: more recent sessions score slightly higher
+            const recencyBoost = this.computeRecencyBoost(result.createdAt);
+            const adjustedScore = result.score * 0.85 + recencyBoost * 0.15;
+            sessions.push({
+                sessionId,
+                summary,
+                relevanceScore: Math.round(adjustedScore * 10000) / 10000,
+            });
+            if (sessions.length >= limit)
+                break;
+        }
+        // Sort by adjusted score descending
+        sessions.sort((a, b) => b.relevanceScore - a.relevanceScore);
+        return sessions.slice(0, limit);
+    }
+    /**
+     * Text search fallback when embeddings are unavailable.
+     */
+    textSearchSessions(tenantId, query, limit) {
+        const results = this.sessionSummaryStore.search(tenantId, query.topic, limit * 2);
+        let filtered = results;
+        // If agentId filter is needed, we need to cross-reference sessions
+        // For text search, we can't easily filter by agentId synchronously here,
+        // so we'll skip that filter for the text fallback (best effort)
+        return filtered.slice(0, limit).map((r, index) => ({
+            sessionId: r.sessionId,
+            summary: r.summary,
+            // Assign a decreasing relevance score for text search results (1.0 → 0.5)
+            relevanceScore: Math.round((1.0 - index * (0.5 / Math.max(limit, 1))) * 10000) / 10000,
+        }));
+    }
+    /**
+     * Find relevant lessons using semantic search (with text search fallback).
+     */
+    async findRelevantLessons(tenantId, query, limit) {
+        // Try semantic search first
+        if (this.embeddingService && this.embeddingStore) {
+            try {
+                const queryVector = await this.embeddingService.embed(query.topic);
+                const results = this.embeddingStore.similaritySearch(tenantId, queryVector, {
+                    sourceType: 'lesson',
+                    limit,
+                    minScore: 0.3,
+                });
+                if (results.length > 0) {
+                    const lessons = [];
+                    for (const result of results) {
+                        const lesson = this.lessonStore.get(tenantId, result.sourceId);
+                        if (lesson) {
+                            lessons.push({
+                                id: lesson.id,
+                                title: lesson.title,
+                                content: lesson.content,
+                                category: lesson.category,
+                                importance: lesson.importance,
+                                relevanceScore: Math.round(result.score * 10000) / 10000,
+                            });
+                        }
+                    }
+                    return lessons;
+                }
+            }
+            catch {
+                // Fall through to text search
+            }
+        }
+        // Fallback: text search on lessons
+        const textResults = this.lessonStore.list(tenantId, {
+            search: query.topic,
+            limit,
+        });
+        return textResults.map((lesson, index) => ({
+            id: lesson.id,
+            title: lesson.title,
+            content: lesson.content,
+            category: lesson.category,
+            importance: lesson.importance,
+            // Assign decreasing scores for text search results
+            relevanceScore: Math.round((1.0 - index * (0.5 / Math.max(limit, 1))) * 10000) / 10000,
+        }));
+    }
+    /**
+     * Enrich a session result with key events from the timeline.
+     */
+    async enrichSessionWithEvents(tenantId, session) {
+        // Get session metadata for startedAt/endedAt/agentId
+        const sessionRecord = await this.eventStore.getSession(session.sessionId);
+        // Get timeline events for key event extraction
+        let keyEvents = [];
+        try {
+            const timeline = await this.eventStore.getSessionTimeline(session.sessionId);
+            // Extract key events: errors, tool calls, session boundaries
+            const significant = timeline.filter((e) => e.eventType === 'tool_error' ||
+                e.eventType === 'tool_call' ||
+                e.eventType === 'session_started' ||
+                e.eventType === 'session_ended' ||
+                e.severity === 'error' ||
+                e.severity === 'critical');
+            keyEvents = significant.slice(0, MAX_KEY_EVENTS).map((e) => {
+                const eventSummary = summarizeEvent(e) ?? `${e.eventType}`;
+                return {
+                    id: e.id,
+                    eventType: e.eventType,
+                    summary: eventSummary,
+                    timestamp: e.timestamp,
+                };
+            });
+        }
+        catch {
+            // Non-critical — return session without events
+        }
+        return {
+            sessionId: session.sessionId,
+            agentId: sessionRecord?.agentId ?? '',
+            summary: session.summary,
+            relevanceScore: session.relevanceScore,
+            startedAt: sessionRecord?.startedAt ?? '',
+            endedAt: sessionRecord?.endedAt,
+            keyEvents,
+        };
+    }
+    /**
+     * 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.
+     */
+    computeRecencyBoost(createdAt) {
+        const now = Date.now();
+        const created = new Date(createdAt).getTime();
+        const ageMs = now - created;
+        const thirtyDaysMs = 30 * 24 * 60 * 60 * 1000;
+        if (ageMs <= 0)
+            return 1.0;
+        if (ageMs >= thirtyDaysMs)
+            return 0.0;
+        return 1.0 - ageMs / thirtyDaysMs;
+    }
+}
+//# sourceMappingURL=retrieval.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Embedding Service — interface and factory (Story 2.1)
+ *
+ * Supports local (Xenova/transformers.js ONNX) and OpenAI backends.
+ */
+import type { EmbeddingServiceConfig } from './types.js';
+export type { EmbeddingVector, EmbeddingBackend, EmbeddingServiceConfig } from './types.js';
+export { cosineSimilarity } from './math.js';
+/**
+ * Embedding service interface — embed text into vector space.
+ */
+export interface EmbeddingService {
+    /** Embed a single text string */
+    embed(text: string): Promise<Float32Array>;
+    /** Embed a batch of texts */
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+    /** Dimensionality of the output vectors */
+    readonly dimensions: number;
+    /** Name of the model used */
+    readonly modelName: string;
+}
+/**
+ * Create an embedding service from config or environment variables.
+ *
+ * Environment variables:
+ * - AGENTLENS_EMBEDDING_BACKEND: 'local' | 'openai' (default: 'local')
+ * - AGENTLENS_EMBEDDING_MODEL: model name override
+ * - OPENAI_API_KEY: required for 'openai' backend
+ */
+export declare function createEmbeddingService(config?: Partial<EmbeddingServiceConfig>): EmbeddingService;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3C,6BAA6B;IAC7B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAErD,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,gBAAgB,CAgBjG"}

package/dist/lib/embeddings/index.js

@@ -0,0 +1,31 @@
+/**
+ * Embedding Service — interface and factory (Story 2.1)
+ *
+ * Supports local (Xenova/transformers.js ONNX) and OpenAI backends.
+ */
+import { createLocalEmbeddingService } from './local.js';
+import { createOpenAIEmbeddingService } from './openai.js';
+export { cosineSimilarity } from './math.js';
+/**
+ * Create an embedding service from config or environment variables.
+ *
+ * Environment variables:
+ * - AGENTLENS_EMBEDDING_BACKEND: 'local' | 'openai' (default: 'local')
+ * - AGENTLENS_EMBEDDING_MODEL: model name override
+ * - OPENAI_API_KEY: required for 'openai' backend
+ */
+export function createEmbeddingService(config) {
+    const backend = config?.backend ??
+        process.env['AGENTLENS_EMBEDDING_BACKEND'] ??
+        'local';
+    const modelName = config?.modelName ?? process.env['AGENTLENS_EMBEDDING_MODEL'];
+    switch (backend) {
+        case 'local':
+            return createLocalEmbeddingService(modelName);
+        case 'openai':
+            return createOpenAIEmbeddingService(config?.openaiApiKey, modelName);
+        default:
+            throw new Error(`Unknown embedding backend: ${backend}. Use 'local' or 'openai'.`);
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAmB7C;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAwC;IAC7E,MAAM,OAAO,GACX,MAAM,EAAE,OAAO;QACd,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAoC;QAC9E,OAAO,CAAC;IAEV,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAEhF,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,2BAA2B,CAAC,SAAS,CAAC,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,4BAA4B,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACvE;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAiB,4BAA4B,CAAC,CAAC;IACjG,CAAC;AACH,CAAC"}

package/dist/lib/embeddings/local.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Local embedding service using @xenova/transformers (ONNX) (Story 2.1)
+ *
+ * Uses all-MiniLM-L6-v2 model (384 dimensions) by default.
+ * Model is loaded once and cached for subsequent calls.
+ */
+import type { EmbeddingService } from './index.js';
+/**
+ * Create a local embedding service backed by @xenova/transformers.
+ *
+ * The @xenova/transformers package is dynamically imported, so it's
+ * not a hard dependency. If not installed, a clear error is thrown.
+ */
+export declare function createLocalEmbeddingService(modelName?: string): EmbeddingService;
+//# sourceMappingURL=local.d.ts.map

package/dist/lib/embeddings/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAwDhF"}

package/dist/lib/embeddings/local.js

@@ -0,0 +1,65 @@
+/**
+ * Local embedding service using @xenova/transformers (ONNX) (Story 2.1)
+ *
+ * Uses all-MiniLM-L6-v2 model (384 dimensions) by default.
+ * Model is loaded once and cached for subsequent calls.
+ */
+const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+const DEFAULT_DIMENSIONS = 384;
+/**
+ * Create a local embedding service backed by @xenova/transformers.
+ *
+ * The @xenova/transformers package is dynamically imported, so it's
+ * not a hard dependency. If not installed, a clear error is thrown.
+ */
+export function createLocalEmbeddingService(modelName) {
+    const model = modelName ?? DEFAULT_MODEL;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let pipelinePromise = null;
+    async function getPipeline() {
+        if (!pipelinePromise) {
+            pipelinePromise = (async () => {
+                try {
+                    // Dynamic import — @xenova/transformers may not be installed
+                    // Use a variable to prevent TypeScript/bundlers from resolving at compile time
+                    const moduleName = '@xenova/transformers';
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const mod = await import(moduleName);
+                    const { pipeline } = mod;
+                    return await pipeline('feature-extraction', model);
+                }
+                catch (err) {
+                    pipelinePromise = null; // Reset so user can retry after install
+                    if (err instanceof Error &&
+                        (err.message.includes('Cannot find module') ||
+                            err.message.includes('Cannot find package') ||
+                            err.message.includes('ERR_MODULE_NOT_FOUND'))) {
+                        throw new Error('Local embedding backend requires @xenova/transformers. ' +
+                            'Install it with: pnpm add @xenova/transformers');
+                    }
+                    throw err;
+                }
+            })();
+        }
+        return pipelinePromise;
+    }
+    return {
+        dimensions: DEFAULT_DIMENSIONS,
+        modelName: model,
+        async embed(text) {
+            const pipe = await getPipeline();
+            const output = await pipe(text, { pooling: 'mean', normalize: true });
+            return new Float32Array(output.data);
+        },
+        async embedBatch(texts) {
+            const pipe = await getPipeline();
+            const results = [];
+            for (const text of texts) {
+                const output = await pipe(text, { pooling: 'mean', normalize: true });
+                results.push(new Float32Array(output.data));
+            }
+            return results;
+        },
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist/lib/embeddings/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../src/lib/embeddings/local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAkB;IAC5D,MAAM,KAAK,GAAG,SAAS,IAAI,aAAa,CAAC;IACzC,8DAA8D;IAC9D,IAAI,eAAe,GAAwB,IAAI,CAAC;IAEhD,KAAK,UAAU,WAAW;QACxB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC5B,IAAI,CAAC;oBACH,6DAA6D;oBAC7D,+EAA+E;oBAC/E,MAAM,UAAU,GAAG,sBAAsB,CAAC;oBAC1C,8DAA8D;oBAC9D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;oBAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;oBACzB,OAAO,MAAM,QAAQ,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;gBACrD,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACtB,eAAe,GAAG,IAAI,CAAC,CAAC,wCAAwC;oBAChE,IACE,GAAG,YAAY,KAAK;wBACpB,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;4BACzC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;4BAC3C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,EAC/C,CAAC;wBACD,MAAM,IAAI,KAAK,CACb,yDAAyD;4BACvD,gDAAgD,CACnD,CAAC;oBACJ,CAAC;oBACD,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,OAAO;QACL,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,KAAK;QAEhB,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,KAAe;YAC9B,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;YACjC,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/embeddings/math.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Vector math utilities for embeddings (Story 2.1)
+ */
+/**
+ * Compute cosine similarity between two vectors.
+ *
+ * Returns a value between -1 and 1, where 1 means identical direction,
+ * 0 means orthogonal, and -1 means opposite direction.
+ *
+ * @throws Error if vectors have different lengths or are zero-length
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/lib/embeddings/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CA0BzE"}

package/dist/lib/embeddings/math.js

@@ -0,0 +1,35 @@
+/**
+ * Vector math utilities for embeddings (Story 2.1)
+ */
+/**
+ * Compute cosine similarity between two vectors.
+ *
+ * Returns a value between -1 and 1, where 1 means identical direction,
+ * 0 means orthogonal, and -1 means opposite direction.
+ *
+ * @throws Error if vectors have different lengths or are zero-length
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    if (a.length === 0) {
+        throw new Error('Cannot compute cosine similarity of zero-length vectors');
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        const ai = a[i];
+        const bi = b[i];
+        dotProduct += ai * bi;
+        normA += ai * ai;
+        normB += bi * bi;
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0) {
+        return 0; // zero vector(s)
+    }
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=math.js.map

package/dist/lib/embeddings/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/lib/embeddings/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAC/D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,UAAU,IAAI,EAAE,GAAG,EAAE,CAAC;QACtB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC,CAAC,iBAAiB;IAC7B,CAAC;IAED,OAAO,UAAU,GAAG,WAAW,CAAC;AAClC,CAAC"}

package/dist/lib/embeddings/openai.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenAI embedding service (Story 2.1)
+ *
+ * Uses text-embedding-3-small (1536 dimensions) by default.
+ * Simple fetch-based client — no SDK dependency.
+ */
+import type { EmbeddingService } from './index.js';
+/**
+ * Create an OpenAI embedding service.
+ *
+ * @param apiKey - OpenAI API key (falls back to OPENAI_API_KEY env var)
+ * @param modelName - Model to use (default: text-embedding-3-small)
+ */
+export declare function createOpenAIEmbeddingService(apiKey?: string, modelName?: string): EmbeddingService;
+//# sourceMappingURL=openai.d.ts.map

package/dist/lib/embeddings/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkBnD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,CAiDlB"}

package/dist/lib/embeddings/openai.js

@@ -0,0 +1,58 @@
+/**
+ * OpenAI embedding service (Story 2.1)
+ *
+ * Uses text-embedding-3-small (1536 dimensions) by default.
+ * Simple fetch-based client — no SDK dependency.
+ */
+const DEFAULT_MODEL = 'text-embedding-3-small';
+const DEFAULT_DIMENSIONS = 1536;
+const OPENAI_EMBEDDINGS_URL = 'https://api.openai.com/v1/embeddings';
+/**
+ * Create an OpenAI embedding service.
+ *
+ * @param apiKey - OpenAI API key (falls back to OPENAI_API_KEY env var)
+ * @param modelName - Model to use (default: text-embedding-3-small)
+ */
+export function createOpenAIEmbeddingService(apiKey, modelName) {
+    const key = apiKey ?? process.env['OPENAI_API_KEY'];
+    const model = modelName ?? DEFAULT_MODEL;
+    if (!key) {
+        throw new Error('OpenAI embedding backend requires an API key. ' +
+            'Set OPENAI_API_KEY environment variable or pass apiKey to config.');
+    }
+    async function callOpenAI(input) {
+        const response = await fetch(OPENAI_EMBEDDINGS_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${key}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                input,
+                model,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`OpenAI embeddings API error (${response.status}): ${errorBody}`);
+        }
+        const json = (await response.json());
+        // Sort by index to ensure order matches input
+        return json.data.sort((a, b) => a.index - b.index).map((d) => d.embedding);
+    }
+    return {
+        dimensions: DEFAULT_DIMENSIONS,
+        modelName: model,
+        async embed(text) {
+            const [embedding] = await callOpenAI(text);
+            return new Float32Array(embedding);
+        },
+        async embedBatch(texts) {
+            if (texts.length === 0)
+                return [];
+            const embeddings = await callOpenAI(texts);
+            return embeddings.map((e) => new Float32Array(e));
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/lib/embeddings/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/lib/embeddings/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,qBAAqB,GAAG,sCAAsC,CAAC;AAcrE;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAe,EACf,SAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,SAAS,IAAI,aAAa,CAAC;IAEzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,gDAAgD;YAC9C,mEAAmE,CACtE,CAAC;IACJ,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,KAAwB;QAChD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,qBAAqB,EAAE;YAClD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,GAAG,EAAE;gBAC9B,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,KAAK;aACN,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAChE,8CAA8C;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,KAAK;QAEhB,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,IAAI,YAAY,CAAC,SAAU,CAAC,CAAC;QACtC,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,KAAe;YAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/embeddings/summarizer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Event & Session Summarizer (Story 2.3)
+ *
+ * Produces concise text summaries suitable for embedding.
+ * - summarizeEvent(): returns embedding text for events worth embedding, or null to skip
+ * - summarizeSession(): produces a heuristic session summary
+ */
+import type { AgentLensEvent, Session } from '@agentlensai/core';
+/**
+ * Summarize a single event into text suitable for embedding.
+ * Returns null if the event should be skipped (not worth embedding).
+ */
+export declare function summarizeEvent(event: AgentLensEvent): string | null;
+export type SessionOutcome = 'success' | 'partial' | 'failure';
+export interface SessionSummary {
+    summary: string;
+    topics: string[];
+    toolSequence: string[];
+    errorSummary: string;
+    outcome: SessionOutcome;
+}
+/**
+ * Produce a heuristic summary of a session from its metadata and events.
+ */
+export declare function summarizeSession(session: Session, events: AgentLensEvent[]): SessionSummary;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/lib/embeddings/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/summarizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EAOR,MAAM,mBAAmB,CAAC;AAuB3B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAuDnE;AAID,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc,EAAE,GACvB,cAAc,CAmGhB"}