family-ai-agent 1.0.6 → 1.0.8

package/dist/database/types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Database Layer Types
+ *
+ * Shared TypeScript types for the database abstraction layer.
+ * Supports both PostgreSQL and SQLite backends.
+ */
+/**
+ * Supported database types
+ */
+export type DatabaseType = 'postgresql' | 'sqlite';
+/**
+ * Database detection modes
+ */
+export type DatabaseDetectionMode = 'auto' | 'postgresql' | 'sqlite';
+/**
+ * Query result row constraint (compatible with pg.QueryResultRow)
+ */
+export type QueryResultRow = Record<string, any>;
+/**
+ * Query result interface (compatible with pg.QueryResult)
+ */
+export interface QueryResult<T extends QueryResultRow = Record<string, any>> {
+    rows: T[];
+    rowCount: number | null;
+}
+/**
+ * Transaction client interface
+ */
+export interface TransactionClient {
+    query<T extends QueryResultRow = Record<string, any>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+}
+/**
+ * Connection pool statistics
+ */
+export interface PoolStats {
+    total: number;
+    idle: number;
+    waiting: number;
+}
+/**
+ * Database health status
+ */
+export interface DatabaseHealth {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    type: DatabaseType;
+    latencyMs: number;
+    poolStats?: PoolStats;
+    circuitState: CircuitBreakerState;
+    lastCheck: Date;
+    errors: string[];
+}
+/**
+ * Circuit breaker states
+ */
+export type CircuitBreakerState = 'closed' | 'open' | 'half-open';
+/**
+ * Migration result
+ */
+export interface MigrationResult {
+    version: number;
+    name: string;
+    success: boolean;
+    error?: string;
+    durationMs: number;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    size: number;
+    maxSize: number;
+    hitCount: number;
+    missCount: number;
+    hitRate: number;
+}
+/**
+ * Vector search options
+ */
+export interface VectorSearchOptions {
+    userId?: string;
+    memoryType?: string;
+    limit?: number;
+    minSimilarity?: number;
+}
+/**
+ * Vector search result
+ */
+export interface VectorSearchResult {
+    id: string;
+    content: string;
+    similarity: number;
+    memoryType: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Embedding entry for vector index
+ */
+export interface EmbeddingEntry {
+    id: string;
+    vector: number[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Database adapter interface
+ */
+export interface DatabaseAdapter {
+    /** Database type */
+    readonly type: DatabaseType;
+    /** Whether the adapter is initialized */
+    readonly isInitialized: boolean;
+    /**
+     * Initialize the database connection
+     */
+    initialize(): Promise<void>;
+    /**
+     * Execute a raw SQL query
+     */
+    query<T extends QueryResultRow = Record<string, any>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /**
+     * Execute a transaction
+     */
+    transaction<T>(callback: (client: TransactionClient) => Promise<T>): Promise<T>;
+    /**
+     * Check database health
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get connection pool statistics (PostgreSQL only)
+     */
+    getPoolStats?(): PoolStats;
+    /**
+     * Close all connections
+     */
+    close(): Promise<void>;
+}
+/**
+ * Vector search engine interface
+ */
+export interface VectorSearchEngine {
+    /**
+     * Initialize the vector index
+     */
+    initialize(): Promise<void>;
+    /**
+     * Store an embedding
+     */
+    store(id: string, embedding: number[], metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Search for similar embeddings
+     */
+    search(queryEmbedding: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    /**
+     * Remove an embedding
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * Rebuild the vector index
+     */
+    rebuildIndex(): Promise<void>;
+    /**
+     * Get index statistics
+     */
+    getStats(): {
+        size: number;
+        dimension: number;
+    };
+}
+/**
+ * Database detection result
+ */
+export interface DetectionResult {
+    type: DatabaseType;
+    connectionString?: string;
+    sqlitePath?: string;
+    reason: string;
+}
+/**
+ * Migration definition
+ */
+export interface Migration {
+    version: number;
+    name: string;
+    up: (adapter: DatabaseAdapter) => Promise<void>;
+    down: (adapter: DatabaseAdapter) => Promise<void>;
+}
+/**
+ * Cache entry
+ */
+export interface CacheEntry<T> {
+    value: T;
+    expiresAt: number;
+    hits: number;
+}
+/**
+ * Query cache options
+ */
+export interface QueryCacheOptions {
+    maxSize: number;
+    defaultTtlMs: number;
+}
+/**
+ * Circuit breaker options
+ */
+export interface CircuitBreakerOptions {
+    failureThreshold: number;
+    resetTimeoutMs: number;
+    halfOpenMaxAttempts: number;
+}
+/**
+ * Health monitor options
+ */
+export interface HealthMonitorOptions {
+    checkIntervalMs: number;
+    errorThreshold: number;
+}
+/**
+ * Database configuration
+ */
+export interface DatabaseConfig {
+    type: DatabaseDetectionMode;
+    postgresUrl?: string;
+    postgresHost: string;
+    postgresPort: number;
+    postgresUser: string;
+    postgresPassword: string;
+    postgresDatabase: string;
+    postgresPoolMax: number;
+    postgresIdleTimeoutMs: number;
+    postgresConnectionTimeoutMs: number;
+    sqlitePath?: string;
+    healthCheckIntervalMs: number;
+    circuitBreakerThreshold: number;
+    circuitBreakerTimeoutMs: number;
+    cacheMaxSize: number;
+    cacheTtlMs: number;
+    vectorDimension: number;
+    vectorMinSimilarity: number;
+}
+/**
+ * Memory types for vector storage
+ */
+export type MemoryType = 'semantic' | 'episodic' | 'procedural';
+/**
+ * Message roles
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+/**
+ * Task status
+ */
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Audit log action types
+ */
+export type AuditActionType = 'chat_message' | 'memory_store' | 'memory_search' | 'document_upload' | 'agent_invocation' | 'tool_execution' | 'safety_block';
+//# sourceMappingURL=types.d.ts.map

package/dist/database/types.d.ts.map

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

package/dist/database/types.js

@@ -0,0 +1,8 @@
+/**
+ * Database Layer Types
+ *
+ * Shared TypeScript types for the database abstraction layer.
+ * Supports both PostgreSQL and SQLite backends.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/database/types.js.map

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

package/dist/database/vector/embedding-cache.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Embedding Cache
+ *
+ * LRU cache for embeddings to avoid redundant database queries.
+ * Improves performance for frequently accessed vectors.
+ */
+/**
+ * Cache statistics
+ */
+export interface EmbeddingCacheStats {
+    size: number;
+    maxSize: number;
+    hitCount: number;
+    missCount: number;
+    hitRate: number;
+    memoryUsageBytes: number;
+}
+/**
+ * LRU cache for embeddings
+ */
+export declare class EmbeddingCache {
+    private cache;
+    private maxSize;
+    private hitCount;
+    private missCount;
+    private dimension;
+    constructor(options?: {
+        maxSize?: number;
+        dimension?: number;
+    });
+    /**
+     * Get embedding from cache
+     */
+    get(id: string): number[] | undefined;
+    /**
+     * Set embedding in cache
+     */
+    set(id: string, embedding: number[], metadata?: Record<string, unknown>): void;
+    /**
+     * Check if ID is in cache
+     */
+    has(id: string): boolean;
+    /**
+     * Remove embedding from cache
+     */
+    delete(id: string): boolean;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Evict entries matching a pattern
+     */
+    evictPattern(pattern: (id: string) => boolean): number;
+    /**
+     * Get multiple embeddings (batch)
+     */
+    getMany(ids: string[]): Map<string, number[]>;
+    /**
+     * Set multiple embeddings (batch)
+     */
+    setMany(entries: Array<{
+        id: string;
+        embedding: number[];
+        metadata?: Record<string, unknown>;
+    }>): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): EmbeddingCacheStats;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Preload embeddings from database records
+     */
+    preload(records: Array<{
+        id: string;
+        embedding: number[] | string;
+    }>): void;
+    /**
+     * Trim cache to a smaller size
+     */
+    trim(newMaxSize: number): void;
+}
+export default EmbeddingCache;
+//# sourceMappingURL=embedding-cache.d.ts.map

package/dist/database/vector/embedding-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-cache.d.ts","sourceRoot":"","sources":["../../../src/database/vector/embedding-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAKlE;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAoBrC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAmB9E;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM;IAWtD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAW7C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI;IAMtG;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IAc/B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAoB3E;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAe/B;AAED,eAAe,cAAc,CAAC"}

package/dist/database/vector/embedding-cache.js

@@ -0,0 +1,185 @@
+/**
+ * Embedding Cache
+ *
+ * LRU cache for embeddings to avoid redundant database queries.
+ * Improves performance for frequently accessed vectors.
+ */
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger('EmbeddingCache');
+/**
+ * LRU cache for embeddings
+ */
+export class EmbeddingCache {
+    cache = new Map();
+    maxSize;
+    hitCount = 0;
+    missCount = 0;
+    dimension;
+    constructor(options = {}) {
+        this.maxSize = options.maxSize ?? 10000;
+        this.dimension = options.dimension ?? 1536;
+    }
+    /**
+     * Get embedding from cache
+     */
+    get(id) {
+        const entry = this.cache.get(id);
+        if (!entry) {
+            this.missCount++;
+            return undefined;
+        }
+        // Update access metadata
+        entry.accessCount++;
+        entry.lastAccessed = Date.now();
+        // Move to end for LRU
+        this.cache.delete(id);
+        this.cache.set(id, entry);
+        this.hitCount++;
+        return entry.embedding;
+    }
+    /**
+     * Set embedding in cache
+     */
+    set(id, embedding, metadata) {
+        // Evict if at capacity
+        if (this.cache.size >= this.maxSize && !this.cache.has(id)) {
+            this.evictLRU();
+        }
+        const entry = {
+            embedding,
+            metadata,
+            accessCount: 1,
+            lastAccessed: Date.now(),
+            addedAt: Date.now(),
+        };
+        // Delete first to ensure it's at the end
+        this.cache.delete(id);
+        this.cache.set(id, entry);
+    }
+    /**
+     * Check if ID is in cache
+     */
+    has(id) {
+        return this.cache.has(id);
+    }
+    /**
+     * Remove embedding from cache
+     */
+    delete(id) {
+        return this.cache.delete(id);
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        this.cache.clear();
+        this.hitCount = 0;
+        this.missCount = 0;
+        logger.debug('Embedding cache cleared');
+    }
+    /**
+     * Evict least recently used entry
+     */
+    evictLRU() {
+        // First entry is LRU due to Map ordering
+        const firstKey = this.cache.keys().next().value;
+        if (firstKey) {
+            this.cache.delete(firstKey);
+        }
+    }
+    /**
+     * Evict entries matching a pattern
+     */
+    evictPattern(pattern) {
+        let count = 0;
+        for (const id of this.cache.keys()) {
+            if (pattern(id)) {
+                this.cache.delete(id);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get multiple embeddings (batch)
+     */
+    getMany(ids) {
+        const result = new Map();
+        for (const id of ids) {
+            const embedding = this.get(id);
+            if (embedding) {
+                result.set(id, embedding);
+            }
+        }
+        return result;
+    }
+    /**
+     * Set multiple embeddings (batch)
+     */
+    setMany(entries) {
+        for (const { id, embedding, metadata } of entries) {
+            this.set(id, embedding, metadata);
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const totalRequests = this.hitCount + this.missCount;
+        const memoryUsageBytes = this.cache.size * this.dimension * 4; // 4 bytes per float32
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            hitCount: this.hitCount,
+            missCount: this.missCount,
+            hitRate: totalRequests > 0 ? this.hitCount / totalRequests : 0,
+            memoryUsageBytes,
+        };
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Preload embeddings from database records
+     */
+    preload(records) {
+        for (const record of records) {
+            let embedding;
+            if (typeof record.embedding === 'string') {
+                try {
+                    embedding = JSON.parse(record.embedding);
+                }
+                catch {
+                    continue;
+                }
+            }
+            else {
+                embedding = record.embedding;
+            }
+            this.set(record.id, embedding);
+        }
+        logger.debug('Embeddings preloaded', { count: records.length });
+    }
+    /**
+     * Trim cache to a smaller size
+     */
+    trim(newMaxSize) {
+        if (newMaxSize >= this.cache.size)
+            return;
+        const toRemove = this.cache.size - newMaxSize;
+        let removed = 0;
+        for (const id of this.cache.keys()) {
+            if (removed >= toRemove)
+                break;
+            this.cache.delete(id);
+            removed++;
+        }
+        this.maxSize = newMaxSize;
+        logger.debug('Cache trimmed', { removed, newSize: this.cache.size });
+    }
+}
+export default EmbeddingCache;
+//# sourceMappingURL=embedding-cache.js.map

package/dist/database/vector/embedding-cache.js.map

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

package/dist/database/vector/hnsw-index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * HNSW (Hierarchical Navigable Small World) Index
+ *
+ * In-memory approximate nearest neighbor search for SQLite mode.
+ * Provides fast vector similarity search without pgvector.
+ */
+/**
+ * Search result with similarity score
+ */
+export interface SearchResult {
+    id: string;
+    similarity: number;
+}
+/**
+ * HNSW index configuration
+ */
+export interface HNSWConfig {
+    /** Vector dimension */
+    dimension: number;
+    /** Similarity metric: 'cosine' or 'euclidean' */
+    similarity: 'cosine' | 'euclidean';
+    /** Maximum connections per layer */
+    M: number;
+    /** Maximum connections for layer 0 */
+    M0: number;
+    /** Size of dynamic candidate list during construction */
+    efConstruction: number;
+    /** Level generation factor (1/ln(M)) */
+    mL: number;
+}
+/**
+ * HNSW Index for fast approximate nearest neighbor search
+ */
+export declare class HNSWIndex {
+    private nodes;
+    private entryPoint;
+    private maxLevel;
+    private config;
+    constructor(config?: Partial<HNSWConfig>);
+    /**
+     * Get similarity function based on config
+     */
+    private getSimilarity;
+    /**
+     * Generate random level for new node
+     */
+    private randomLevel;
+    /**
+     * Get maximum connections for a level
+     */
+    private getMaxConnections;
+    /**
+     * Add a vector to the index
+     */
+    add(id: string, vector: number[]): void;
+    /**
+     * Search for k nearest neighbors
+     */
+    search(query: number[], k: number, ef?: number): SearchResult[];
+    /**
+     * Search within a layer
+     */
+    private searchLayer;
+    /**
+     * Select best neighbors from candidates
+     */
+    private selectNeighbors;
+    /**
+     * Prune connections to maintain max connections
+     */
+    private pruneConnections;
+    /**
+     * Remove a vector from the index
+     */
+    remove(id: string): boolean;
+    /**
+     * Check if an ID exists in the index
+     */
+    has(id: string): boolean;
+    /**
+     * Get vector by ID
+     */
+    get(id: string): number[] | undefined;
+    /**
+     * Get index size
+     */
+    get size(): number;
+    /**
+     * Get index statistics
+     */
+    getStats(): {
+        size: number;
+        dimension: number;
+        maxLevel: number;
+        avgConnections: number;
+    };
+    /**
+     * Clear the index
+     */
+    clear(): void;
+    /**
+     * Get all IDs in the index
+     */
+    getAllIds(): string[];
+    /**
+     * Rebuild index from scratch (for optimization)
+     */
+    rebuild(): void;
+}
+export default HNSWIndex;
+//# sourceMappingURL=hnsw-index.d.ts.map

package/dist/database/vector/hnsw-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hnsw-index.d.ts","sourceRoot":"","sources":["../../../src/database/vector/hnsw-index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAC;IACnC,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;CACZ;AAcD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM;IAI5C;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAoFvC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAyB/D;;OAEG;IACH,OAAO,CAAC,WAAW;IA8DnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAoC3B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAIrC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB;IAmBD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAchB;AAED,eAAe,SAAS,CAAC"}