agentic-flow 3.0.0-alpha.1 → 3.0.0

package/dist/packages/agentdb/src/controllers/QUICConnectionPool.js

@@ -1,256 +0,0 @@
-/**
- * QUICConnectionPool - Connection Pooling for QUIC Protocol
- *
- * Manages a pool of QUICConnection instances for efficient reuse:
- * - Maximum pool size of 10 connections per endpoint
- * - Connection reuse with idle detection
- * - Automatic cleanup of stale/expired connections
- * - Pool-level statistics and health monitoring
- * - Graceful drain and shutdown
- */
-import { QUICConnection } from './QUICConnection.js';
-export class QUICConnectionPool {
-    pools = new Map();
-    config;
-    stats = new Map();
-    cleanupTimer = null;
-    constructor(config) {
-        this.config = {
-            maxPoolSize: config?.maxPoolSize ?? 10,
-            maxIdleTimeMs: config?.maxIdleTimeMs ?? 60000,
-            acquireTimeoutMs: config?.acquireTimeoutMs ?? 10000,
-            enableZeroRTT: config?.enableZeroRTT ?? true,
-            congestionControl: config?.congestionControl ?? 'bbr',
-            healthCheckIntervalMs: config?.healthCheckIntervalMs ?? 30000,
-        };
-        this.startCleanup();
-    }
-    /**
-     * Acquire a connection from the pool.
-     * Reuses idle connections or creates new ones up to maxPoolSize.
-     */
-    async getConnection(endpoint) {
-        const startTime = performance.now();
-        this.ensureStats(endpoint);
-        const poolStats = this.stats.get(endpoint);
-        const pool = this.pools.get(endpoint) || [];
-        this.pools.set(endpoint, pool);
-        // Try to reuse an idle connection
-        for (const conn of pool) {
-            if (!conn.isBusy() && conn.isConnected()) {
-                poolStats.totalAcquired++;
-                poolStats.acquireTimesMs.push(performance.now() - startTime);
-                return conn;
-            }
-        }
-        // Create a new connection if pool is not full
-        if (pool.length < this.config.maxPoolSize) {
-            const conn = await this.createConnection(endpoint);
-            pool.push(conn);
-            poolStats.totalCreated++;
-            poolStats.totalAcquired++;
-            // Track 0-RTT usage
-            const metrics = conn.getMetrics();
-            if (metrics.zeroRttUsed) {
-                poolStats.zeroRttHits++;
-            }
-            else {
-                poolStats.zeroRttMisses++;
-            }
-            poolStats.acquireTimesMs.push(performance.now() - startTime);
-            return conn;
-        }
-        // Pool is full: wait for an available connection
-        return this.waitForAvailableConnection(endpoint, startTime);
-    }
-    /**
-     * Release a connection back to the pool (mark as not busy).
-     * The connection stays in the pool for reuse.
-     */
-    releaseConnection(conn) {
-        const endpoint = conn.getEndpoint();
-        this.ensureStats(endpoint);
-        this.stats.get(endpoint).totalReleased++;
-        // Connection automatically becomes non-busy after send completes
-    }
-    /**
-     * Remove a specific connection from the pool and disconnect it.
-     */
-    async removeConnection(conn) {
-        const endpoint = conn.getEndpoint();
-        const pool = this.pools.get(endpoint);
-        if (!pool)
-            return;
-        const idx = pool.indexOf(conn);
-        if (idx !== -1) {
-            pool.splice(idx, 1);
-            await conn.disconnect();
-            this.ensureStats(endpoint);
-            this.stats.get(endpoint).totalDestroyed++;
-        }
-    }
-    /**
-     * Get pool statistics for a specific endpoint.
-     */
-    getPoolStats(endpoint) {
-        const pool = this.pools.get(endpoint) || [];
-        this.ensureStats(endpoint);
-        const s = this.stats.get(endpoint);
-        const activeConnections = pool.filter(c => c.isBusy()).length;
-        const idleConnections = pool.filter(c => !c.isBusy() && c.isConnected()).length;
-        const avgAcquire = s.acquireTimesMs.length > 0
-            ? s.acquireTimesMs.reduce((a, b) => a + b, 0) / s.acquireTimesMs.length
-            : 0;
-        const rttValues = pool
-            .filter(c => c.isConnected())
-            .map(c => c.getMetrics().smoothedRttMs)
-            .filter(r => r > 0);
-        const avgRtt = rttValues.length > 0
-            ? rttValues.reduce((a, b) => a + b, 0) / rttValues.length
-            : 0;
-        return {
-            endpoint,
-            totalConnections: pool.length,
-            activeConnections,
-            idleConnections,
-            totalAcquired: s.totalAcquired,
-            totalReleased: s.totalReleased,
-            totalCreated: s.totalCreated,
-            totalDestroyed: s.totalDestroyed,
-            avgAcquireTimeMs: Number(avgAcquire.toFixed(3)),
-            avgRttMs: Number(avgRtt.toFixed(3)),
-            zeroRttHits: s.zeroRttHits,
-            zeroRttMisses: s.zeroRttMisses,
-        };
-    }
-    /**
-     * Get stats for all endpoints.
-     */
-    getAllPoolStats() {
-        return Array.from(this.pools.keys()).map(ep => this.getPoolStats(ep));
-    }
-    /**
-     * Get total number of connections across all pools.
-     */
-    getTotalConnections() {
-        let total = 0;
-        for (const pool of this.pools.values()) {
-            total += pool.length;
-        }
-        return total;
-    }
-    /**
-     * Drain and close all connections for an endpoint.
-     */
-    async drainEndpoint(endpoint) {
-        const pool = this.pools.get(endpoint);
-        if (!pool)
-            return 0;
-        let closed = 0;
-        for (const conn of pool) {
-            await conn.disconnect();
-            closed++;
-        }
-        this.pools.delete(endpoint);
-        this.ensureStats(endpoint);
-        this.stats.get(endpoint).totalDestroyed += closed;
-        return closed;
-    }
-    /**
-     * Drain and close ALL connections.
-     */
-    async shutdown() {
-        let total = 0;
-        for (const endpoint of Array.from(this.pools.keys())) {
-            total += await this.drainEndpoint(endpoint);
-        }
-        if (this.cleanupTimer) {
-            clearInterval(this.cleanupTimer);
-            this.cleanupTimer = null;
-        }
-        return total;
-    }
-    /**
-     * Remove idle connections that exceed maxIdleTimeMs.
-     */
-    async cleanup() {
-        const now = Date.now();
-        let cleaned = 0;
-        for (const [endpoint, pool] of this.pools.entries()) {
-            const toRemove = [];
-            for (const conn of pool) {
-                if (!conn.isBusy() && (now - conn.getLastActiveAt()) > this.config.maxIdleTimeMs) {
-                    toRemove.push(conn);
-                }
-            }
-            for (const conn of toRemove) {
-                const idx = pool.indexOf(conn);
-                if (idx !== -1) {
-                    pool.splice(idx, 1);
-                    await conn.disconnect();
-                    cleaned++;
-                }
-            }
-            this.ensureStats(endpoint);
-            this.stats.get(endpoint).totalDestroyed += toRemove.length;
-            // Remove empty pools
-            if (pool.length === 0) {
-                this.pools.delete(endpoint);
-            }
-        }
-        return cleaned;
-    }
-    // -- Private helpers --
-    async createConnection(endpoint) {
-        const connConfig = {
-            endpoint,
-            enableZeroRTT: this.config.enableZeroRTT,
-            enableMultipath: false,
-            congestionControl: this.config.congestionControl,
-        };
-        const conn = new QUICConnection(connConfig);
-        await conn.connect();
-        return conn;
-    }
-    async waitForAvailableConnection(endpoint, startTime) {
-        const deadline = startTime + this.config.acquireTimeoutMs;
-        while (performance.now() < deadline) {
-            const pool = this.pools.get(endpoint) || [];
-            for (const conn of pool) {
-                if (!conn.isBusy() && conn.isConnected()) {
-                    this.ensureStats(endpoint);
-                    const s = this.stats.get(endpoint);
-                    s.totalAcquired++;
-                    s.acquireTimesMs.push(performance.now() - startTime);
-                    return conn;
-                }
-            }
-            await new Promise(resolve => setTimeout(resolve, 5));
-        }
-        throw new Error(`Connection pool exhausted for ${endpoint} ` +
-            `(max: ${this.config.maxPoolSize}, timeout: ${this.config.acquireTimeoutMs}ms)`);
-    }
-    ensureStats(endpoint) {
-        if (!this.stats.has(endpoint)) {
-            this.stats.set(endpoint, {
-                totalAcquired: 0,
-                totalReleased: 0,
-                totalCreated: 0,
-                totalDestroyed: 0,
-                acquireTimesMs: [],
-                zeroRttHits: 0,
-                zeroRttMisses: 0,
-            });
-        }
-    }
-    startCleanup() {
-        this.cleanupTimer = setInterval(() => {
-            this.cleanup().catch(() => { });
-        }, this.config.healthCheckIntervalMs);
-        // Avoid keeping the process alive just for cleanup
-        if (this.cleanupTimer && typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {
-            this.cleanupTimer.unref();
-        }
-    }
-}
-//# sourceMappingURL=QUICConnectionPool.js.map

package/dist/packages/agentdb/src/controllers/QUICConnectionPool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QUICConnectionPool.js","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/controllers/QUICConnectionPool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * QUICConnectionPool - Connection Pooling for QUIC Protocol\n *\n * Manages a pool of QUICConnection instances for efficient reuse:\n * - Maximum pool size of 10 connections per endpoint\n * - Connection reuse with idle detection\n * - Automatic cleanup of stale/expired connections\n * - Pool-level statistics and health monitoring\n * - Graceful drain and shutdown\n */\n\nimport { QUICConnection, QUICConnectionConfig, ConnectionMetrics } from './QUICConnection.js';\n\nexport interface PoolConfig {\n  maxPoolSize?: number;\n  maxIdleTimeMs?: number;\n  acquireTimeoutMs?: number;\n  enableZeroRTT?: boolean;\n  congestionControl?: 'bbr' | 'cubic' | 'reno';\n  healthCheckIntervalMs?: number;\n}\n\nexport interface PoolStats {\n  endpoint: string;\n  totalConnections: number;\n  activeConnections: number;\n  idleConnections: number;\n  totalAcquired: number;\n  totalReleased: number;\n  totalCreated: number;\n  totalDestroyed: number;\n  avgAcquireTimeMs: number;\n  avgRttMs: number;\n  zeroRttHits: number;\n  zeroRttMisses: number;\n}\n\nexport class QUICConnectionPool {\n  private pools: Map<string, QUICConnection[]> = new Map();\n  private config: Required<PoolConfig>;\n  private stats: Map<string, {\n    totalAcquired: number;\n    totalReleased: number;\n    totalCreated: number;\n    totalDestroyed: number;\n    acquireTimesMs: number[];\n    zeroRttHits: number;\n    zeroRttMisses: number;\n  }> = new Map();\n  private cleanupTimer: ReturnType<typeof setInterval> | null = null;\n\n  constructor(config?: PoolConfig) {\n    this.config = {\n      maxPoolSize: config?.maxPoolSize ?? 10,\n      maxIdleTimeMs: config?.maxIdleTimeMs ?? 60000,\n      acquireTimeoutMs: config?.acquireTimeoutMs ?? 10000,\n      enableZeroRTT: config?.enableZeroRTT ?? true,\n      congestionControl: config?.congestionControl ?? 'bbr',\n      healthCheckIntervalMs: config?.healthCheckIntervalMs ?? 30000,\n    };\n\n    this.startCleanup();\n  }\n\n  /**\n   * Acquire a connection from the pool.\n   * Reuses idle connections or creates new ones up to maxPoolSize.\n   */\n  async getConnection(endpoint: string): Promise<QUICConnection> {\n    const startTime = performance.now();\n    this.ensureStats(endpoint);\n    const poolStats = this.stats.get(endpoint)!;\n\n    const pool = this.pools.get(endpoint) || [];\n    this.pools.set(endpoint, pool);\n\n    // Try to reuse an idle connection\n    for (const conn of pool) {\n      if (!conn.isBusy() && conn.isConnected()) {\n        poolStats.totalAcquired++;\n        poolStats.acquireTimesMs.push(performance.now() - startTime);\n        return conn;\n      }\n    }\n\n    // Create a new connection if pool is not full\n    if (pool.length < this.config.maxPoolSize) {\n      const conn = await this.createConnection(endpoint);\n      pool.push(conn);\n      poolStats.totalCreated++;\n      poolStats.totalAcquired++;\n\n      // Track 0-RTT usage\n      const metrics = conn.getMetrics();\n      if (metrics.zeroRttUsed) {\n        poolStats.zeroRttHits++;\n      } else {\n        poolStats.zeroRttMisses++;\n      }\n\n      poolStats.acquireTimesMs.push(performance.now() - startTime);\n      return conn;\n    }\n\n    // Pool is full: wait for an available connection\n    return this.waitForAvailableConnection(endpoint, startTime);\n  }\n\n  /**\n   * Release a connection back to the pool (mark as not busy).\n   * The connection stays in the pool for reuse.\n   */\n  releaseConnection(conn: QUICConnection): void {\n    const endpoint = conn.getEndpoint();\n    this.ensureStats(endpoint);\n    this.stats.get(endpoint)!.totalReleased++;\n    // Connection automatically becomes non-busy after send completes\n  }\n\n  /**\n   * Remove a specific connection from the pool and disconnect it.\n   */\n  async removeConnection(conn: QUICConnection): Promise<void> {\n    const endpoint = conn.getEndpoint();\n    const pool = this.pools.get(endpoint);\n    if (!pool) return;\n\n    const idx = pool.indexOf(conn);\n    if (idx !== -1) {\n      pool.splice(idx, 1);\n      await conn.disconnect();\n      this.ensureStats(endpoint);\n      this.stats.get(endpoint)!.totalDestroyed++;\n    }\n  }\n\n  /**\n   * Get pool statistics for a specific endpoint.\n   */\n  getPoolStats(endpoint: string): PoolStats {\n    const pool = this.pools.get(endpoint) || [];\n    this.ensureStats(endpoint);\n    const s = this.stats.get(endpoint)!;\n\n    const activeConnections = pool.filter(c => c.isBusy()).length;\n    const idleConnections = pool.filter(c => !c.isBusy() && c.isConnected()).length;\n\n    const avgAcquire = s.acquireTimesMs.length > 0\n      ? s.acquireTimesMs.reduce((a, b) => a + b, 0) / s.acquireTimesMs.length\n      : 0;\n\n    const rttValues = pool\n      .filter(c => c.isConnected())\n      .map(c => c.getMetrics().smoothedRttMs)\n      .filter(r => r > 0);\n    const avgRtt = rttValues.length > 0\n      ? rttValues.reduce((a, b) => a + b, 0) / rttValues.length\n      : 0;\n\n    return {\n      endpoint,\n      totalConnections: pool.length,\n      activeConnections,\n      idleConnections,\n      totalAcquired: s.totalAcquired,\n      totalReleased: s.totalReleased,\n      totalCreated: s.totalCreated,\n      totalDestroyed: s.totalDestroyed,\n      avgAcquireTimeMs: Number(avgAcquire.toFixed(3)),\n      avgRttMs: Number(avgRtt.toFixed(3)),\n      zeroRttHits: s.zeroRttHits,\n      zeroRttMisses: s.zeroRttMisses,\n    };\n  }\n\n  /**\n   * Get stats for all endpoints.\n   */\n  getAllPoolStats(): PoolStats[] {\n    return Array.from(this.pools.keys()).map(ep => this.getPoolStats(ep));\n  }\n\n  /**\n   * Get total number of connections across all pools.\n   */\n  getTotalConnections(): number {\n    let total = 0;\n    for (const pool of this.pools.values()) {\n      total += pool.length;\n    }\n    return total;\n  }\n\n  /**\n   * Drain and close all connections for an endpoint.\n   */\n  async drainEndpoint(endpoint: string): Promise<number> {\n    const pool = this.pools.get(endpoint);\n    if (!pool) return 0;\n\n    let closed = 0;\n    for (const conn of pool) {\n      await conn.disconnect();\n      closed++;\n    }\n\n    this.pools.delete(endpoint);\n    this.ensureStats(endpoint);\n    this.stats.get(endpoint)!.totalDestroyed += closed;\n    return closed;\n  }\n\n  /**\n   * Drain and close ALL connections.\n   */\n  async shutdown(): Promise<number> {\n    let total = 0;\n    for (const endpoint of Array.from(this.pools.keys())) {\n      total += await this.drainEndpoint(endpoint);\n    }\n\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n\n    return total;\n  }\n\n  /**\n   * Remove idle connections that exceed maxIdleTimeMs.\n   */\n  async cleanup(): Promise<number> {\n    const now = Date.now();\n    let cleaned = 0;\n\n    for (const [endpoint, pool] of this.pools.entries()) {\n      const toRemove: QUICConnection[] = [];\n\n      for (const conn of pool) {\n        if (!conn.isBusy() && (now - conn.getLastActiveAt()) > this.config.maxIdleTimeMs) {\n          toRemove.push(conn);\n        }\n      }\n\n      for (const conn of toRemove) {\n        const idx = pool.indexOf(conn);\n        if (idx !== -1) {\n          pool.splice(idx, 1);\n          await conn.disconnect();\n          cleaned++;\n        }\n      }\n\n      this.ensureStats(endpoint);\n      this.stats.get(endpoint)!.totalDestroyed += toRemove.length;\n\n      // Remove empty pools\n      if (pool.length === 0) {\n        this.pools.delete(endpoint);\n      }\n    }\n\n    return cleaned;\n  }\n\n  // -- Private helpers --\n\n  private async createConnection(endpoint: string): Promise<QUICConnection> {\n    const connConfig: QUICConnectionConfig = {\n      endpoint,\n      enableZeroRTT: this.config.enableZeroRTT,\n      enableMultipath: false,\n      congestionControl: this.config.congestionControl,\n    };\n\n    const conn = new QUICConnection(connConfig);\n    await conn.connect();\n    return conn;\n  }\n\n  private async waitForAvailableConnection(\n    endpoint: string,\n    startTime: number,\n  ): Promise<QUICConnection> {\n    const deadline = startTime + this.config.acquireTimeoutMs;\n\n    while (performance.now() < deadline) {\n      const pool = this.pools.get(endpoint) || [];\n\n      for (const conn of pool) {\n        if (!conn.isBusy() && conn.isConnected()) {\n          this.ensureStats(endpoint);\n          const s = this.stats.get(endpoint)!;\n          s.totalAcquired++;\n          s.acquireTimesMs.push(performance.now() - startTime);\n          return conn;\n        }\n      }\n\n      await new Promise(resolve => setTimeout(resolve, 5));\n    }\n\n    throw new Error(\n      `Connection pool exhausted for ${endpoint} ` +\n      `(max: ${this.config.maxPoolSize}, timeout: ${this.config.acquireTimeoutMs}ms)`\n    );\n  }\n\n  private ensureStats(endpoint: string): void {\n    if (!this.stats.has(endpoint)) {\n      this.stats.set(endpoint, {\n        totalAcquired: 0,\n        totalReleased: 0,\n        totalCreated: 0,\n        totalDestroyed: 0,\n        acquireTimesMs: [],\n        zeroRttHits: 0,\n        zeroRttMisses: 0,\n      });\n    }\n  }\n\n  private startCleanup(): void {\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup().catch(() => { /* silent cleanup failure */ });\n    }, this.config.healthCheckIntervalMs);\n\n    // Avoid keeping the process alive just for cleanup\n    if (this.cleanupTimer && typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {\n      this.cleanupTimer.unref();\n    }\n  }\n}\n"]}

package/dist/packages/agentdb/src/controllers/QUICServer.d.ts

@@ -1,121 +0,0 @@
-/**
- * QUICServer - QUIC Protocol Server for AgentDB Synchronization
- *
- * Implements a QUIC server for receiving and handling synchronization requests
- * from remote AgentDB instances. Supports episodes, skills, and edge synchronization.
- *
- * Features:
- * - Start/stop server lifecycle management
- * - Client connection handling
- * - Authentication and authorization
- * - Rate limiting per client
- * - Sync request processing (episodes, skills, edges)
- * - Comprehensive error handling and logging
- */
-type Database = any;
-export interface QUICServerConfig {
-    host?: string;
-    port?: number;
-    maxConnections?: number;
-    authToken?: string;
-    rateLimit?: {
-        maxRequestsPerMinute: number;
-        maxBytesPerMinute: number;
-    };
-    tlsConfig?: {
-        cert?: string;
-        key?: string;
-        ca?: string;
-    };
-}
-export interface SyncRequest {
-    type: 'episodes' | 'skills' | 'edges' | 'full';
-    since?: number;
-    filters?: Record<string, any>;
-    batchSize?: number;
-}
-export interface SyncResponse {
-    success: boolean;
-    data?: any;
-    error?: string;
-    nextCursor?: number;
-    hasMore?: boolean;
-    count?: number;
-}
-interface ClientConnection {
-    id: string;
-    address: string;
-    connectedAt: number;
-    requestCount: number;
-    bytesReceived: number;
-    lastRequestAt: number;
-}
-export declare class QUICServer {
-    private db;
-    private config;
-    private isRunning;
-    private connections;
-    private rateLimitState;
-    private server;
-    private cleanupInterval;
-    constructor(db: Database, config?: QUICServerConfig);
-    /**
-     * Start the QUIC server
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the QUIC server
-     */
-    stop(): Promise<void>;
-    /**
-     * Handle incoming client connection
-     */
-    private handleConnection;
-    /**
-     * Authenticate client request
-     */
-    private authenticate;
-    /**
-     * Check rate limits for client
-     */
-    private checkRateLimit;
-    /**
-     * Process sync request from client
-     */
-    processSyncRequest(clientId: string, request: SyncRequest, authToken: string): Promise<SyncResponse>;
-    /**
-     * Sync episodes data
-     */
-    private syncEpisodes;
-    /**
-     * Sync skills data
-     */
-    private syncSkills;
-    /**
-     * Sync edges (skill relationships)
-     */
-    private syncEdges;
-    /**
-     * Full sync of all data
-     */
-    private syncFull;
-    /**
-     * Start cleanup interval for stale connections
-     */
-    private startCleanupInterval;
-    /**
-     * Get server status
-     */
-    getStatus(): {
-        isRunning: boolean;
-        activeConnections: number;
-        totalRequests: number;
-        config: QUICServerConfig;
-    };
-    /**
-     * Get connection info
-     */
-    getConnections(): ClientConnection[];
-}
-export {};
-//# sourceMappingURL=QUICServer.d.ts.map

package/dist/packages/agentdb/src/controllers/QUICServer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"QUICServer.d.ts","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/controllers/QUICServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,KAAK,QAAQ,GAAG,GAAG,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAQD,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAE,gBAAqB;IAevD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC3B;;OAEG;YACW,gBAAgB;IAwB9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IA6ExB;;OAEG;YACW,YAAY;IA6C1B;;OAEG;YACW,UAAU;IA8BxB;;OAEG;YACW,SAAS;IA0BvB;;OAEG;YACW,QAAQ;IActB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,SAAS,IAAI;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,gBAAgB,CAAC;KAC1B;IAcD;;OAEG;IACH,cAAc,IAAI,gBAAgB,EAAE;CAGrC"}