@agentlensai/server 0.3.0 → 0.6.0

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/health/computer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Health Score Computer (Story 1.2)
+ *
+ * Computes health scores for agents based on five dimensions:
+ * error rate, cost efficiency, tool success, latency, and completion rate.
+ * Each dimension is normalized to 0-100 and combined with configurable weights.
+ */
+import type { IEventStore, HealthScore, HealthWeights } from '@agentlensai/core';
+export declare class HealthComputer {
+    private readonly weights;
+    constructor(weights: HealthWeights);
+    /**
+     * Compute the health score for a single agent within a time window.
+     * Returns null if no sessions exist in the window.
+     */
+    compute(store: IEventStore, agentId: string, windowDays: number): Promise<HealthScore | null>;
+    /**
+     * Compute health scores for all agents in the store.
+     */
+    computeOverview(store: IEventStore, windowDays: number): Promise<HealthScore[]>;
+    private computeErrorRate;
+    private computeCostEfficiency;
+    private computeToolSuccess;
+    private computeLatency;
+    private computeCompletionRate;
+    private computeTrend;
+}
+//# sourceMappingURL=computer.d.ts.map

package/dist/lib/health/computer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer.d.ts","sourceRoot":"","sources":["../../../src/lib/health/computer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAGX,aAAa,EAGd,MAAM,mBAAmB,CAAC;AAc3B,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;OAGG;IACG,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA0E9B;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBzB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,qBAAqB;IA4B7B,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,qBAAqB;YAiBf,YAAY;CAoE3B"}