@agentlensai/server 0.2.0 → 0.5.0

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"}

package/dist/lib/embeddings/summarizer.js

@@ -0,0 +1,181 @@
+/**
+ * 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
+ */
+/**
+ * Truncate a string to `maxLen` characters, adding "…" if truncated.
+ */
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen) + '…';
+}
+/**
+ * Safely extract a string from an unknown value, with fallback.
+ */
+function safeString(value, fallback = '') {
+    if (typeof value === 'string')
+        return value;
+    if (value == null)
+        return fallback;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Summarize a single event into text suitable for embedding.
+ * Returns null if the event should be skipped (not worth embedding).
+ */
+export function summarizeEvent(event) {
+    const payload = event.payload;
+    switch (event.eventType) {
+        case 'tool_error': {
+            const p = payload;
+            const toolName = safeString(p.toolName, 'unknown');
+            const error = safeString(p.error, 'unknown error');
+            return `tool_error: ${toolName} - ${truncate(error, 300)}`;
+        }
+        case 'tool_call': {
+            const p = payload;
+            const toolName = safeString(p.toolName, 'unknown');
+            const args = truncate(safeString(p.arguments, '{}'), 200);
+            return `tool_call: ${toolName}(${args})`;
+        }
+        case 'llm_call': {
+            const p = payload;
+            const model = safeString(p.model, 'unknown');
+            // Find the first user message
+            let userMsg = '';
+            if (Array.isArray(p.messages)) {
+                const userMessage = p.messages.find((m) => m.role === 'user');
+                if (userMessage) {
+                    const content = userMessage.content;
+                    if (typeof content === 'string') {
+                        userMsg = content;
+                    }
+                    else if (Array.isArray(content)) {
+                        const textPart = content.find((c) => c.type === 'text');
+                        userMsg = textPart?.text ?? '';
+                    }
+                }
+            }
+            return `llm_call: ${model} - ${truncate(userMsg, 200)}`;
+        }
+        case 'llm_response': {
+            const p = payload;
+            const model = safeString(p.model, 'unknown');
+            const completion = safeString(p.completion, '');
+            return `llm_response: ${model} - ${truncate(completion, 200)}`;
+        }
+        default: {
+            // Embed events with error or critical severity regardless of type
+            if (event.severity === 'error' || event.severity === 'critical') {
+                const summary = truncate(safeString(payload, '{}'), 300);
+                return `${event.eventType}: ${summary}`;
+            }
+            // Skip everything else
+            return null;
+        }
+    }
+}
+/**
+ * Produce a heuristic summary of a session from its metadata and events.
+ */
+export function summarizeSession(session, events) {
+    // Collect tool names in order
+    const toolSequence = [];
+    const toolNames = new Set();
+    const errorMessages = [];
+    let errorCount = 0;
+    for (const event of events) {
+        const payload = event.payload;
+        if (event.eventType === 'tool_call' ||
+            event.eventType === 'tool_response' ||
+            event.eventType === 'tool_error') {
+            const toolName = safeString(payload.toolName, 'unknown');
+            if (event.eventType === 'tool_call') {
+                toolSequence.push(toolName);
+            }
+            toolNames.add(toolName);
+        }
+        if (event.eventType === 'tool_error') {
+            errorCount++;
+            errorMessages.push(safeString(payload.error, 'unknown error'));
+        }
+        if (event.severity === 'error' || event.severity === 'critical') {
+            if (event.eventType !== 'tool_error') {
+                errorCount++;
+                errorMessages.push(`${event.eventType}: ${truncate(safeString(payload, ''), 100)}`);
+            }
+        }
+    }
+    // Calculate duration
+    let duration = 'unknown duration';
+    if (session.startedAt) {
+        const start = new Date(session.startedAt).getTime();
+        const end = session.endedAt
+            ? new Date(session.endedAt).getTime()
+            : Date.now();
+        const diffMs = end - start;
+        if (diffMs < 1000) {
+            duration = `${diffMs}ms`;
+        }
+        else if (diffMs < 60_000) {
+            duration = `${Math.round(diffMs / 1000)}s`;
+        }
+        else {
+            duration = `${Math.round(diffMs / 60_000)}m`;
+        }
+    }
+    // Build summary text
+    const agentName = session.agentName ?? session.agentId;
+    const toolList = toolNames.size > 0 ? Array.from(toolNames).join(', ') : 'none';
+    const cost = session.totalCostUsd > 0 ? ` Cost: $${session.totalCostUsd.toFixed(4)}.` : '';
+    const summary = `Agent ${agentName} ran for ${duration}. Used tools: ${toolList}. ${errorCount} errors.${cost}`;
+    // Topics: tool names, event types, tags
+    const eventTypes = new Set(events.map((e) => e.eventType));
+    const topics = [
+        ...Array.from(toolNames),
+        ...Array.from(eventTypes),
+        ...session.tags,
+    ];
+    // Error summary
+    const errorSummary = errorMessages.length > 0
+        ? truncate(errorMessages.join('; '), 500)
+        : '';
+    // Determine outcome
+    let outcome;
+    const totalEvents = events.length;
+    const lastEvent = events.length > 0 ? events[events.length - 1] : null;
+    const endedWithError = lastEvent?.eventType === 'tool_error' ||
+        lastEvent?.severity === 'error' ||
+        lastEvent?.severity === 'critical' ||
+        (lastEvent?.eventType === 'session_ended' &&
+            lastEvent.payload?.reason === 'error');
+    if (errorCount === 0) {
+        outcome = 'success';
+    }
+    else if (totalEvents > 0 && errorCount / totalEvents > 0.5) {
+        outcome = 'failure';
+    }
+    else if (endedWithError) {
+        outcome = 'failure';
+    }
+    else {
+        outcome = 'partial';
+    }
+    return {
+        summary,
+        topics,
+        toolSequence,
+        errorSummary,
+        outcome,
+    };
+}
+//# sourceMappingURL=summarizer.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Embedding service types (Story 2.1)
+ */
+/** A typed embedding vector */
+export type EmbeddingVector = Float32Array;
+/** Supported embedding backends */
+export type EmbeddingBackend = 'local' | 'openai';
+/** Configuration for the embedding service */
+export interface EmbeddingServiceConfig {
+    /** Backend to use: 'local' (Xenova/transformers.js) or 'openai' */
+    backend: EmbeddingBackend;
+    /** Model name override (default depends on backend) */
+    modelName?: string;
+    /** OpenAI API key (required for 'openai' backend) */
+    openaiApiKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAE3C,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElD,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/lib/embeddings/types.js

@@ -0,0 +1,5 @@
+/**
+ * Embedding service types (Story 2.1)
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,56 @@
+/**
+ * Background Embedding Worker (Story 2.3)
+ *
+ * Processes an in-memory queue of records to embed. Fail-safe — never crashes
+ * the server. If embedding service is not configured, silently skips all items.
+ */
+import type { EmbeddingService } from './index.js';
+import type { EmbeddingStore } from '../../db/embedding-store.js';
+/** Item to be embedded */
+export interface EmbeddingQueueItem {
+    tenantId: string;
+    sourceType: string;
+    sourceId: string;
+    textContent: string;
+}
+export declare class EmbeddingWorker {
+    private readonly embeddingService;
+    private readonly embeddingStore;
+    private queue;
+    private processedCount;
+    private intervalHandle;
+    private readonly maxQueueSize;
+    constructor(embeddingService: EmbeddingService | null, embeddingStore: EmbeddingStore | null, opts?: {
+        maxQueueSize?: number;
+    });
+    /**
+     * Add an item to the embedding queue. Synchronous — never throws.
+     * If the queue is full, drops the oldest items to make room.
+     */
+    enqueue(item: EmbeddingQueueItem): void;
+    /**
+     * Start the background processing loop (setInterval-based, every 1 second).
+     */
+    start(): void;
+    /**
+     * Stop the processing loop and flush remaining items.
+     */
+    stop(): Promise<void>;
+    /**
+     * Process all queued items immediately.
+     */
+    flush(): Promise<void>;
+    /**
+     * Return current queue length.
+     */
+    getQueueSize(): number;
+    /**
+     * Return total number of items successfully processed.
+     */
+    getProcessedCount(): number;
+    /**
+     * Process up to BATCH_SIZE items from the queue.
+     */
+    private processBatch;
+}
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/lib/embeddings/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAWD,qBAAa,eAAe;IAOxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAPjC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,EACzC,cAAc,EAAE,cAAc,GAAG,IAAI,EACtD,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAKlC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAavC;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;YACW,YAAY;CA4B3B"}

package/dist/lib/embeddings/worker.js

@@ -0,0 +1,109 @@
+/**
+ * Background Embedding Worker (Story 2.3)
+ *
+ * Processes an in-memory queue of records to embed. Fail-safe — never crashes
+ * the server. If embedding service is not configured, silently skips all items.
+ */
+/** Default maximum queue size */
+const DEFAULT_MAX_QUEUE_SIZE = 10_000;
+/** Maximum items to process per tick */
+const BATCH_SIZE = 32;
+/** Processing interval in milliseconds */
+const TICK_INTERVAL_MS = 1_000;
+export class EmbeddingWorker {
+    embeddingService;
+    embeddingStore;
+    queue = [];
+    processedCount = 0;
+    intervalHandle = null;
+    maxQueueSize;
+    constructor(embeddingService, embeddingStore, opts) {
+        this.embeddingService = embeddingService;
+        this.embeddingStore = embeddingStore;
+        this.maxQueueSize = opts?.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE;
+    }
+    /**
+     * Add an item to the embedding queue. Synchronous — never throws.
+     * If the queue is full, drops the oldest items to make room.
+     */
+    enqueue(item) {
+        // Silently skip if service is not configured
+        if (!this.embeddingService || !this.embeddingStore)
+            return;
+        this.queue.push(item);
+        // Drop oldest on overflow
+        if (this.queue.length > this.maxQueueSize) {
+            const overflow = this.queue.length - this.maxQueueSize;
+            this.queue.splice(0, overflow);
+        }
+    }
+    /**
+     * Start the background processing loop (setInterval-based, every 1 second).
+     */
+    start() {
+        if (this.intervalHandle !== null)
+            return; // already running
+        if (!this.embeddingService || !this.embeddingStore)
+            return; // nothing to do
+        this.intervalHandle = setInterval(() => {
+            void this.processBatch();
+        }, TICK_INTERVAL_MS);
+        // Prevent the interval from keeping the process alive
+        if (typeof this.intervalHandle === 'object' && 'unref' in this.intervalHandle) {
+            this.intervalHandle.unref();
+        }
+    }
+    /**
+     * Stop the processing loop and flush remaining items.
+     */
+    async stop() {
+        if (this.intervalHandle !== null) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+        // Flush remaining
+        await this.flush();
+    }
+    /**
+     * Process all queued items immediately.
+     */
+    async flush() {
+        while (this.queue.length > 0) {
+            await this.processBatch();
+        }
+    }
+    /**
+     * Return current queue length.
+     */
+    getQueueSize() {
+        return this.queue.length;
+    }
+    /**
+     * Return total number of items successfully processed.
+     */
+    getProcessedCount() {
+        return this.processedCount;
+    }
+    /**
+     * Process up to BATCH_SIZE items from the queue.
+     */
+    async processBatch() {
+        if (!this.embeddingService || !this.embeddingStore)
+            return;
+        if (this.queue.length === 0)
+            return;
+        const batch = this.queue.splice(0, BATCH_SIZE);
+        for (const item of batch) {
+            try {
+                const embedding = await this.embeddingService.embed(item.textContent);
+                await this.embeddingStore.store(item.tenantId, item.sourceType, item.sourceId, item.textContent, embedding, this.embeddingService.modelName, this.embeddingService.dimensions);
+                this.processedCount++;
+            }
+            catch (err) {
+                // Log and skip — never crash
+                console.error(`[EmbeddingWorker] Failed to embed item (${item.sourceType}/${item.sourceId}):`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=worker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/lib/embeddings/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,iCAAiC;AACjC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,wCAAwC;AACxC,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,0CAA0C;AAC1C,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,MAAM,OAAO,eAAe;IAOP;IACA;IAPX,KAAK,GAAyB,EAAE,CAAC;IACjC,cAAc,GAAG,CAAC,CAAC;IACnB,cAAc,GAA0C,IAAI,CAAC;IACpD,YAAY,CAAS;IAEtC,YACmB,gBAAyC,EACzC,cAAqC,EACtD,IAAgC;QAFf,qBAAgB,GAAhB,gBAAgB,CAAyB;QACzC,mBAAc,GAAd,cAAc,CAAuB;QAGtD,IAAI,CAAC,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,sBAAsB,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAwB;QAC9B,6CAA6C;QAC7C,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAE3D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtB,0BAA0B;QAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;YAAE,OAAO,CAAC,kBAAkB;QAC5D,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO,CAAC,gBAAgB;QAE5E,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3B,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAErB,sDAAsD;QACtD,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9E,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,kBAAkB;QAClB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAC3D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACtE,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAC7B,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,WAAW,EAChB,SAAS,EACT,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAC/B,IAAI,CAAC,gBAAgB,CAAC,UAAU,CACjC,CAAC;gBACF,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6BAA6B;gBAC7B,OAAO,CAAC,KAAK,CACX,2CAA2C,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,IAAI,EAC/E,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACzC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/lib/event-bus.d.ts

@@ -0,0 +1,48 @@
+/**
+ * In-process EventBus for real-time notifications (Story 12.5, Epic 14 — Arch §11.1)
+ *
+ * Typed EventEmitter for decoupled communication between
+ * server components. Consumed by SSE endpoint (Epic 14) and Alert Engine (Epic 12).
+ */
+import type { AgentLensEvent, AlertRule, AlertHistory, Session } from '@agentlensai/core';
+export interface AlertTriggeredEvent {
+    type: 'alert_triggered';
+    rule: AlertRule;
+    history: AlertHistory;
+    timestamp: string;
+}
+export interface AlertResolvedEvent {
+    type: 'alert_resolved';
+    ruleId: string;
+    historyId: string;
+    timestamp: string;
+}
+/** New event ingested (Epic 14 — Story 14.1) */
+export interface EventIngestedEvent {
+    type: 'event_ingested';
+    event: AgentLensEvent;
+    timestamp: string;
+}
+/** Session updated (Epic 14 — Story 14.1) */
+export interface SessionUpdatedEvent {
+    type: 'session_updated';
+    session: Session;
+    timestamp: string;
+}
+export type BusEvent = AlertTriggeredEvent | AlertResolvedEvent | EventIngestedEvent | SessionUpdatedEvent;
+/**
+ * Typed event bus for internal server communication.
+ * Wraps Node.js EventEmitter with type safety.
+ */
+declare class EventBus {
+    private emitter;
+    constructor();
+    emit(event: BusEvent): void;
+    on(type: BusEvent['type'] | '*', listener: (event: BusEvent) => void): void;
+    off(type: BusEvent['type'] | '*', listener: (event: BusEvent) => void): void;
+    removeAllListeners(): void;
+}
+/** Singleton event bus instance */
+export declare const eventBus: EventBus;
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/lib/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/lib/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAI1F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB;;;GAGG;AACH,cAAM,QAAQ;IACZ,OAAO,CAAC,OAAO,CAAsB;;IAOrC,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAK3B,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAI3E,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAI5E,kBAAkB,IAAI,IAAI;CAG3B;AAED,mCAAmC;AACnC,eAAO,MAAM,QAAQ,UAAiB,CAAC"}