@agentlensai/server 0.3.0 → 0.6.0

package/dist/db/embedding-store.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Embedding Store — storage and retrieval of vector embeddings (Story 2.2)
+ *
+ * Handles CRUD operations for embeddings including:
+ * - Content-hash deduplication
+ * - In-JS cosine similarity search (SQLite doesn't support vector ops)
+ * - Tenant isolation
+ */
+import type { SqliteDb } from './index.js';
+/** Options for similarity search */
+export interface SimilaritySearchOptions {
+    /** Filter by source type ('event', 'session', 'lesson') */
+    sourceType?: string;
+    /** Filter by creation time — from (ISO 8601) */
+    from?: string;
+    /** Filter by creation time — to (ISO 8601) */
+    to?: string;
+    /** Maximum number of results (default: 10) */
+    limit?: number;
+    /** Minimum similarity score to include (default: 0.0) */
+    minScore?: number;
+}
+/** A single similarity search result */
+export interface SimilarityResult {
+    id: string;
+    sourceType: string;
+    sourceId: string;
+    score: number;
+    text: string;
+    embeddingModel: string;
+    createdAt: string;
+}
+/** Stored embedding record (without the raw vector) */
+export interface StoredEmbedding {
+    id: string;
+    tenantId: string;
+    sourceType: string;
+    sourceId: string;
+    contentHash: string;
+    textContent: string;
+    embedding: Float32Array;
+    embeddingModel: string;
+    dimensions: number;
+    createdAt: string;
+}
+export declare class EmbeddingStore {
+    private readonly db;
+    constructor(db: SqliteDb);
+    /**
+     * Store an embedding with source-level deduplication.
+     * If an embedding with the same (tenant, source_type, source_id) already exists,
+     * it's updated rather than duplicated. Different sources with the same content
+     * are stored as separate rows to preserve source metadata.
+     */
+    store(tenantId: string, sourceType: string, sourceId: string, textContent: string, embedding: Float32Array, model: string, dimensions: number): string;
+    /**
+     * Get embeddings for a specific source.
+     */
+    getBySource(tenantId: string, sourceType: string, sourceId: string): StoredEmbedding | null;
+    /**
+     * Similarity search: load candidate embeddings filtered by tenant/sourceType/time,
+     * compute cosine similarity in JS, sort by score, filter by minScore, return top N.
+     */
+    similaritySearch(tenantId: string, queryVector: Float32Array, opts?: SimilaritySearchOptions): SimilarityResult[];
+    /**
+     * Delete embedding(s) for a specific source.
+     */
+    delete(tenantId: string, sourceType: string, sourceId: string): number;
+    /**
+     * Count embeddings for a tenant.
+     */
+    count(tenantId: string): number;
+}
+//# sourceMappingURL=embedding-store.d.ts.map

package/dist/db/embedding-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-store.d.ts","sourceRoot":"","sources":["../../src/db/embedding-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyB3C,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEzC;;;;;OAKG;IACH,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,MAAM;IAqDT;;OAEG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,IAAI;IA6BzB;;;OAGG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,YAAY,EACzB,IAAI,GAAE,uBAA4B,GACjC,gBAAgB,EAAE;IAoDrB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAetE;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAShC"}

package/dist/db/embedding-store.js

@@ -0,0 +1,177 @@
+/**
+ * Embedding Store — storage and retrieval of vector embeddings (Story 2.2)
+ *
+ * Handles CRUD operations for embeddings including:
+ * - Content-hash deduplication
+ * - In-JS cosine similarity search (SQLite doesn't support vector ops)
+ * - Tenant isolation
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { eq, and, sql } from 'drizzle-orm';
+import { embeddings } from './schema.sqlite.js';
+import { cosineSimilarity } from '../lib/embeddings/math.js';
+/** Maximum candidates loaded into memory for similarity search */
+const MAX_CANDIDATES = 10_000;
+/** Compute SHA-256 content hash of text */
+function contentHash(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+/** Serialize Float32Array to Buffer for SQLite BLOB storage */
+function serializeEmbedding(embedding) {
+    // Slice to copy — avoids view mutation if source buffer is reused
+    return Buffer.from(embedding.buffer.slice(embedding.byteOffset, embedding.byteOffset + embedding.byteLength));
+}
+/** Deserialize Buffer from SQLite BLOB to Float32Array */
+function deserializeEmbedding(blob) {
+    // Copy to fresh aligned buffer — Buffer from SQLite may have non-4-byte-aligned offset
+    const copy = new Uint8Array(blob).buffer;
+    return new Float32Array(copy);
+}
+export class EmbeddingStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Store an embedding with source-level deduplication.
+     * If an embedding with the same (tenant, source_type, source_id) already exists,
+     * it's updated rather than duplicated. Different sources with the same content
+     * are stored as separate rows to preserve source metadata.
+     */
+    store(tenantId, sourceType, sourceId, textContent, embedding, model, dimensions) {
+        const hash = contentHash(textContent);
+        const now = new Date().toISOString();
+        // Check for existing embedding from the same source
+        const existing = this.db
+            .select({ id: embeddings.id })
+            .from(embeddings)
+            .where(and(eq(embeddings.tenantId, tenantId), eq(embeddings.sourceType, sourceType), eq(embeddings.sourceId, sourceId)))
+            .get();
+        if (existing) {
+            // Update existing — content may have changed
+            this.db
+                .update(embeddings)
+                .set({
+                contentHash: hash,
+                textContent,
+                embedding: serializeEmbedding(embedding),
+                embeddingModel: model,
+                dimensions,
+            })
+                .where(eq(embeddings.id, existing.id))
+                .run();
+            return existing.id;
+        }
+        const id = randomUUID();
+        this.db
+            .insert(embeddings)
+            .values({
+            id,
+            tenantId,
+            sourceType,
+            sourceId,
+            contentHash: hash,
+            textContent,
+            embedding: serializeEmbedding(embedding),
+            embeddingModel: model,
+            dimensions,
+            createdAt: now,
+        })
+            .run();
+        return id;
+    }
+    /**
+     * Get embeddings for a specific source.
+     */
+    getBySource(tenantId, sourceType, sourceId) {
+        const row = this.db
+            .select()
+            .from(embeddings)
+            .where(and(eq(embeddings.tenantId, tenantId), eq(embeddings.sourceType, sourceType), eq(embeddings.sourceId, sourceId)))
+            .get();
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            tenantId: row.tenantId,
+            sourceType: row.sourceType,
+            sourceId: row.sourceId,
+            contentHash: row.contentHash,
+            textContent: row.textContent,
+            embedding: deserializeEmbedding(row.embedding),
+            embeddingModel: row.embeddingModel,
+            dimensions: row.dimensions,
+            createdAt: row.createdAt,
+        };
+    }
+    /**
+     * Similarity search: load candidate embeddings filtered by tenant/sourceType/time,
+     * compute cosine similarity in JS, sort by score, filter by minScore, return top N.
+     */
+    similaritySearch(tenantId, queryVector, opts = {}) {
+        const { sourceType, from, to, limit = 10, minScore = 0.0 } = opts;
+        // Build all conditions upfront
+        const conditions = [eq(embeddings.tenantId, tenantId)];
+        if (sourceType) {
+            conditions.push(eq(embeddings.sourceType, sourceType));
+        }
+        if (from) {
+            conditions.push(sql `${embeddings.createdAt} >= ${from}`);
+        }
+        if (to) {
+            conditions.push(sql `${embeddings.createdAt} <= ${to}`);
+        }
+        const rows = this.db
+            .select()
+            .from(embeddings)
+            .where(and(...conditions))
+            .limit(MAX_CANDIDATES)
+            .all();
+        if (rows.length >= MAX_CANDIDATES) {
+            console.warn(`[EmbeddingStore] similaritySearch hit MAX_CANDIDATES limit (${MAX_CANDIDATES}) ` +
+                `for tenant=${tenantId}. Results may be incomplete.`);
+        }
+        // Compute cosine similarity for each candidate
+        const results = [];
+        for (const row of rows) {
+            const embVector = deserializeEmbedding(row.embedding);
+            const score = cosineSimilarity(queryVector, embVector);
+            if (score >= minScore) {
+                results.push({
+                    id: row.id,
+                    sourceType: row.sourceType,
+                    sourceId: row.sourceId,
+                    score,
+                    text: row.textContent,
+                    embeddingModel: row.embeddingModel,
+                    createdAt: row.createdAt,
+                });
+            }
+        }
+        // Sort by score descending and take top N
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    /**
+     * Delete embedding(s) for a specific source.
+     */
+    delete(tenantId, sourceType, sourceId) {
+        const result = this.db
+            .delete(embeddings)
+            .where(and(eq(embeddings.tenantId, tenantId), eq(embeddings.sourceType, sourceType), eq(embeddings.sourceId, sourceId)))
+            .run();
+        return result.changes;
+    }
+    /**
+     * Count embeddings for a tenant.
+     */
+    count(tenantId) {
+        const result = this.db
+            .select({ count: sql `COUNT(*)` })
+            .from(embeddings)
+            .where(eq(embeddings.tenantId, tenantId))
+            .get();
+        return result?.count ?? 0;
+    }
+}
+//# sourceMappingURL=embedding-store.js.map

package/dist/db/embedding-store.js.map

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

package/dist/db/health-snapshot-store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Health Snapshot Store (Story 1.3)
+ *
+ * CRUD operations for the health_snapshots table with tenant isolation.
+ * Stores daily health score snapshots for historical tracking.
+ */
+import type { SqliteDb } from './index.js';
+import type { HealthSnapshot } from '@agentlensai/core';
+export declare class HealthSnapshotStore {
+    private readonly db;
+    constructor(db: SqliteDb);
+    /**
+     * Upsert a health snapshot (INSERT OR REPLACE by tenant_id + agent_id + date).
+     */
+    save(tenantId: string, snapshot: HealthSnapshot): void;
+    /**
+     * Get a single snapshot by agent ID and date.
+     */
+    get(tenantId: string, agentId: string, date: string): HealthSnapshot | null;
+    /**
+     * Get snapshot history for an agent, ordered by date DESC.
+     */
+    getHistory(tenantId: string, agentId: string, days: number): HealthSnapshot[];
+    /**
+     * Get the latest snapshot for each agent in a tenant.
+     */
+    getLatest(tenantId: string): Map<string, HealthSnapshot>;
+    /**
+     * Delete snapshots older than retention period.
+     */
+    cleanup(tenantId: string, retentionDays: number): number;
+}
+//# sourceMappingURL=health-snapshot-store.d.ts.map

package/dist/db/health-snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-snapshot-store.d.ts","sourceRoot":"","sources":["../../src/db/health-snapshot-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiCxD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEzC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAmBtD;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAW3E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAgB7E;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAoBxD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;CAazD"}

package/dist/db/health-snapshot-store.js

@@ -0,0 +1,112 @@
+/**
+ * Health Snapshot Store (Story 1.3)
+ *
+ * CRUD operations for the health_snapshots table with tenant isolation.
+ * Stores daily health score snapshots for historical tracking.
+ */
+import { randomUUID } from 'node:crypto';
+import { sql } from 'drizzle-orm';
+/** Parse a DB row into a HealthSnapshot */
+function rowToSnapshot(row) {
+    return {
+        agentId: row.agent_id,
+        date: row.date,
+        overallScore: row.overall_score,
+        errorRateScore: row.error_rate_score,
+        costEfficiencyScore: row.cost_efficiency_score,
+        toolSuccessScore: row.tool_success_score,
+        latencyScore: row.latency_score,
+        completionRateScore: row.completion_rate_score,
+        sessionCount: row.session_count,
+    };
+}
+export class HealthSnapshotStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Upsert a health snapshot (INSERT OR REPLACE by tenant_id + agent_id + date).
+     */
+    save(tenantId, snapshot) {
+        const id = randomUUID();
+        const now = new Date().toISOString();
+        this.db.run(sql `
+      INSERT OR REPLACE INTO health_snapshots (
+        id, tenant_id, agent_id, date,
+        overall_score, error_rate_score, cost_efficiency_score,
+        tool_success_score, latency_score, completion_rate_score,
+        session_count, created_at
+      ) VALUES (
+        ${id}, ${tenantId}, ${snapshot.agentId}, ${snapshot.date},
+        ${snapshot.overallScore}, ${snapshot.errorRateScore}, ${snapshot.costEfficiencyScore},
+        ${snapshot.toolSuccessScore}, ${snapshot.latencyScore}, ${snapshot.completionRateScore},
+        ${snapshot.sessionCount}, ${now}
+      )
+    `);
+    }
+    /**
+     * Get a single snapshot by agent ID and date.
+     */
+    get(tenantId, agentId, date) {
+        const row = this.db.get(sql `
+      SELECT * FROM health_snapshots
+      WHERE tenant_id = ${tenantId}
+        AND agent_id = ${agentId}
+        AND date = ${date}
+    `);
+        return row ? rowToSnapshot(row) : null;
+    }
+    /**
+     * Get snapshot history for an agent, ordered by date DESC.
+     */
+    getHistory(tenantId, agentId, days) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - days);
+        const cutoffDate = cutoff.toISOString().slice(0, 10);
+        const rows = this.db.all(sql `
+      SELECT * FROM health_snapshots
+      WHERE tenant_id = ${tenantId}
+        AND agent_id = ${agentId}
+        AND date >= ${cutoffDate}
+      ORDER BY date DESC
+    `);
+        return rows.map(rowToSnapshot);
+    }
+    /**
+     * Get the latest snapshot for each agent in a tenant.
+     */
+    getLatest(tenantId) {
+        // Use a subquery to get the max date per agent
+        const rows = this.db.all(sql `
+      SELECT hs.* FROM health_snapshots hs
+      INNER JOIN (
+        SELECT agent_id, MAX(date) as max_date
+        FROM health_snapshots
+        WHERE tenant_id = ${tenantId}
+        GROUP BY agent_id
+      ) latest ON hs.agent_id = latest.agent_id AND hs.date = latest.max_date
+      WHERE hs.tenant_id = ${tenantId}
+    `);
+        const result = new Map();
+        for (const row of rows) {
+            result.set(row.agent_id, rowToSnapshot(row));
+        }
+        return result;
+    }
+    /**
+     * Delete snapshots older than retention period.
+     */
+    cleanup(tenantId, retentionDays) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - retentionDays);
+        const cutoffDate = cutoff.toISOString().slice(0, 10);
+        const result = this.db.run(sql `
+      DELETE FROM health_snapshots
+      WHERE tenant_id = ${tenantId}
+        AND date < ${cutoffDate}
+    `);
+        return result.changes;
+    }
+}
+//# sourceMappingURL=health-snapshot-store.js.map

package/dist/db/health-snapshot-store.js.map

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

package/dist/db/lesson-store.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Lesson Store (Story 3.1)
+ *
+ * CRUD operations for the lessons table with tenant isolation.
+ */
+import type { SqliteDb } from './index.js';
+import type { Lesson, LessonQuery, LessonImportance } from '@agentlensai/core';
+/** Input for creating a new lesson */
+export interface CreateLessonInput {
+    title: string;
+    content: string;
+    category?: string;
+    importance?: LessonImportance;
+    agentId?: string;
+    context?: Record<string, unknown>;
+    sourceSessionId?: string;
+    sourceEventId?: string;
+}
+/** Input for updating an existing lesson */
+export interface UpdateLessonInput {
+    title?: string;
+    content?: string;
+    category?: string;
+    importance?: LessonImportance;
+    agentId?: string;
+    context?: Record<string, unknown>;
+}
+export declare class LessonStore {
+    private readonly db;
+    constructor(db: SqliteDb);
+    /**
+     * Create a new lesson.
+     */
+    create(tenantId: string, input: CreateLessonInput): Lesson;
+    /**
+     * Get a lesson by ID. Increments access_count and updates last_accessed_at.
+     * Wrapped in a transaction for atomicity.
+     */
+    get(tenantId: string, id: string): Lesson | null;
+    /**
+     * List lessons with optional filters.
+     */
+    list(tenantId: string, query?: LessonQuery): Lesson[];
+    /**
+     * Update a lesson (partial update).
+     */
+    update(tenantId: string, id: string, updates: UpdateLessonInput): Lesson;
+    /**
+     * Soft-delete (archive) a lesson.
+     */
+    archive(tenantId: string, id: string): void;
+    /**
+     * Count lessons matching filters.
+     */
+    count(tenantId: string, query?: LessonQuery): number;
+}
+//# sourceMappingURL=lesson-store.d.ts.map

package/dist/db/lesson-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lesson-store.d.ts","sourceRoot":"","sources":["../../src/db/lesson-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA+BD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEzC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM;IA2B1D;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA4BhD;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE;IAyCrD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAsCxE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAmB3C;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM;CAkCrD"}