agentic-flow 1.10.1 → 2.0.0-alpha

package/agentic-flow/dist/federation/integrations/supabase-adapter.js

@@ -0,0 +1,259 @@
+/**
+ * Supabase Database Adapter for Federation Hub
+ *
+ * Provides PostgreSQL backend using Supabase for:
+ * - Hub persistence
+ * - Agent metadata
+ * - Memory storage (optional pgvector)
+ * - Real-time subscriptions
+ */
+import { createClient } from '@supabase/supabase-js';
+export class SupabaseFederationAdapter {
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Use service role key for server-side operations
+        const key = config.serviceRoleKey || config.anonKey;
+        this.client = createClient(config.url, key);
+    }
+    /**
+     * Initialize Supabase schema for federation
+     */
+    async initialize() {
+        console.log('🔧 Initializing Supabase Federation Schema...');
+        // Check if tables exist, create if needed
+        await this.ensureTables();
+        if (this.config.vectorBackend === 'pgvector') {
+            await this.ensureVectorExtension();
+        }
+        console.log('✅ Supabase Federation Schema Ready');
+    }
+    /**
+     * Ensure required tables exist
+     */
+    async ensureTables() {
+        // Note: In production, use Supabase migrations
+        // This is a runtime check for development
+        const { data, error } = await this.client
+            .from('agent_sessions')
+            .select('id')
+            .limit(1);
+        if (error && error.code === 'PGRST116') {
+            console.log('⚠️  Tables not found. Please run Supabase migrations.');
+            console.log('📖 See: docs/supabase/migrations/');
+        }
+    }
+    /**
+     * Ensure pgvector extension is enabled
+     */
+    async ensureVectorExtension() {
+        try {
+            // This requires service role key with proper permissions
+            const { error } = await this.client.rpc('exec_sql', {
+                sql: 'CREATE EXTENSION IF NOT EXISTS vector;'
+            });
+            if (error) {
+                console.warn('⚠️  pgvector extension check failed:', error.message);
+                console.log('📖 Enable manually: CREATE EXTENSION vector;');
+            }
+        }
+        catch (err) {
+            console.warn('⚠️  Could not verify pgvector extension');
+        }
+    }
+    /**
+     * Store agent memory in Supabase
+     */
+    async storeMemory(memory) {
+        const { error } = await this.client
+            .from('agent_memories')
+            .insert({
+            id: memory.id,
+            tenant_id: memory.tenant_id,
+            agent_id: memory.agent_id,
+            session_id: memory.session_id,
+            content: memory.content,
+            embedding: memory.embedding,
+            metadata: memory.metadata,
+            created_at: memory.created_at || new Date().toISOString(),
+            expires_at: memory.expires_at,
+        });
+        if (error) {
+            throw new Error(`Failed to store memory: ${error.message}`);
+        }
+    }
+    /**
+     * Query memories by tenant and agent
+     */
+    async queryMemories(tenantId, agentId, limit = 100) {
+        let query = this.client
+            .from('agent_memories')
+            .select('*')
+            .eq('tenant_id', tenantId)
+            .order('created_at', { ascending: false })
+            .limit(limit);
+        if (agentId) {
+            query = query.eq('agent_id', agentId);
+        }
+        const { data, error } = await query;
+        if (error) {
+            throw new Error(`Failed to query memories: ${error.message}`);
+        }
+        return data;
+    }
+    /**
+     * Semantic search using pgvector
+     */
+    async semanticSearch(embedding, tenantId, limit = 10) {
+        if (this.config.vectorBackend !== 'pgvector') {
+            throw new Error('pgvector backend not enabled');
+        }
+        // Use pgvector cosine similarity search
+        const { data, error } = await this.client.rpc('search_memories', {
+            query_embedding: embedding,
+            query_tenant_id: tenantId,
+            match_count: limit,
+        });
+        if (error) {
+            throw new Error(`Semantic search failed: ${error.message}`);
+        }
+        return data;
+    }
+    /**
+     * Register agent session
+     */
+    async registerSession(sessionId, tenantId, agentId, metadata) {
+        const { error } = await this.client
+            .from('agent_sessions')
+            .insert({
+            session_id: sessionId,
+            tenant_id: tenantId,
+            agent_id: agentId,
+            metadata,
+            started_at: new Date().toISOString(),
+            status: 'active',
+        });
+        if (error) {
+            throw new Error(`Failed to register session: ${error.message}`);
+        }
+    }
+    /**
+     * Update session status
+     */
+    async updateSessionStatus(sessionId, status) {
+        const updates = { status };
+        if (status !== 'active') {
+            updates.ended_at = new Date().toISOString();
+        }
+        const { error } = await this.client
+            .from('agent_sessions')
+            .update(updates)
+            .eq('session_id', sessionId);
+        if (error) {
+            throw new Error(`Failed to update session: ${error.message}`);
+        }
+    }
+    /**
+     * Get active sessions for tenant
+     */
+    async getActiveSessions(tenantId) {
+        const { data, error } = await this.client
+            .from('agent_sessions')
+            .select('*')
+            .eq('tenant_id', tenantId)
+            .eq('status', 'active')
+            .order('started_at', { ascending: false });
+        if (error) {
+            throw new Error(`Failed to get sessions: ${error.message}`);
+        }
+        return data || [];
+    }
+    /**
+     * Subscribe to real-time memory updates
+     */
+    subscribeToMemories(tenantId, callback) {
+        const subscription = this.client
+            .channel(`memories:${tenantId}`)
+            .on('postgres_changes', {
+            event: 'INSERT',
+            schema: 'public',
+            table: 'agent_memories',
+            filter: `tenant_id=eq.${tenantId}`,
+        }, callback)
+            .subscribe();
+        // Return unsubscribe function
+        return () => {
+            subscription.unsubscribe();
+        };
+    }
+    /**
+     * Clean up expired memories
+     */
+    async cleanupExpiredMemories() {
+        const { data, error } = await this.client
+            .from('agent_memories')
+            .delete()
+            .lt('expires_at', new Date().toISOString())
+            .select('id');
+        if (error) {
+            throw new Error(`Cleanup failed: ${error.message}`);
+        }
+        return data?.length || 0;
+    }
+    /**
+     * Get hub statistics
+     */
+    async getStats(tenantId) {
+        // Total memories
+        let memoriesQuery = this.client
+            .from('agent_memories')
+            .select('id', { count: 'exact', head: true });
+        if (tenantId) {
+            memoriesQuery = memoriesQuery.eq('tenant_id', tenantId);
+        }
+        const { count: totalMemories } = await memoriesQuery;
+        // Active sessions
+        let sessionsQuery = this.client
+            .from('agent_sessions')
+            .select('session_id', { count: 'exact', head: true })
+            .eq('status', 'active');
+        if (tenantId) {
+            sessionsQuery = sessionsQuery.eq('tenant_id', tenantId);
+        }
+        const { count: activeSessions } = await sessionsQuery;
+        return {
+            total_memories: totalMemories || 0,
+            active_sessions: activeSessions || 0,
+            backend: 'supabase',
+            vector_backend: this.config.vectorBackend,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * Close connection
+     */
+    async close() {
+        // Supabase client doesn't need explicit closing
+        console.log('✅ Supabase connection closed');
+    }
+}
+/**
+ * Create Supabase adapter from environment variables
+ */
+export function createSupabaseAdapter() {
+    const url = process.env.SUPABASE_URL;
+    const anonKey = process.env.SUPABASE_ANON_KEY;
+    const serviceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+    if (!url || !anonKey) {
+        throw new Error('Missing Supabase credentials. Set SUPABASE_URL and SUPABASE_ANON_KEY');
+    }
+    return new SupabaseFederationAdapter({
+        url,
+        anonKey,
+        serviceRoleKey,
+        vectorBackend: process.env.FEDERATION_VECTOR_BACKEND || 'hybrid',
+        syncInterval: parseInt(process.env.FEDERATION_SYNC_INTERVAL || '60000'),
+    });
+}
+//# sourceMappingURL=supabase-adapter.js.map

package/agentic-flow/dist/federation/integrations/supabase-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-adapter.js","sourceRoot":"","sources":["../../../src/federation/integrations/supabase-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Supabase Database Adapter for Federation Hub\n *\n * Provides PostgreSQL backend using Supabase for:\n * - Hub persistence\n * - Agent metadata\n * - Memory storage (optional pgvector)\n * - Real-time subscriptions\n */\n\nimport { createClient, SupabaseClient } from '@supabase/supabase-js';\n\nexport interface SupabaseConfig {\n  url: string;\n  anonKey: string;\n  serviceRoleKey?: string;\n  vectorBackend?: 'pgvector' | 'agentdb' | 'hybrid';\n  syncInterval?: number; // ms\n}\n\nexport interface AgentMemory {\n  id: string;\n  tenant_id: string;\n  agent_id: string;\n  session_id: string;\n  content: string;\n  embedding?: number[];\n  metadata?: Record<string, any>;\n  created_at?: string;\n  expires_at?: string;\n}\n\nexport class SupabaseFederationAdapter {\n  private client: SupabaseClient;\n  private config: SupabaseConfig;\n\n  constructor(config: SupabaseConfig) {\n    this.config = config;\n\n    // Use service role key for server-side operations\n    const key = config.serviceRoleKey || config.anonKey;\n    this.client = createClient(config.url, key);\n  }\n\n  /**\n   * Initialize Supabase schema for federation\n   */\n  async initialize(): Promise<void> {\n    console.log('🔧 Initializing Supabase Federation Schema...');\n\n    // Check if tables exist, create if needed\n    await this.ensureTables();\n\n    if (this.config.vectorBackend === 'pgvector') {\n      await this.ensureVectorExtension();\n    }\n\n    console.log('✅ Supabase Federation Schema Ready');\n  }\n\n  /**\n   * Ensure required tables exist\n   */\n  private async ensureTables(): Promise<void> {\n    // Note: In production, use Supabase migrations\n    // This is a runtime check for development\n\n    const { data, error } = await this.client\n      .from('agent_sessions')\n      .select('id')\n      .limit(1);\n\n    if (error && error.code === 'PGRST116') {\n      console.log('⚠️  Tables not found. Please run Supabase migrations.');\n      console.log('📖 See: docs/supabase/migrations/');\n    }\n  }\n\n  /**\n   * Ensure pgvector extension is enabled\n   */\n  private async ensureVectorExtension(): Promise<void> {\n    try {\n      // This requires service role key with proper permissions\n      const { error } = await this.client.rpc('exec_sql', {\n        sql: 'CREATE EXTENSION IF NOT EXISTS vector;'\n      });\n\n      if (error) {\n        console.warn('⚠️  pgvector extension check failed:', error.message);\n        console.log('📖 Enable manually: CREATE EXTENSION vector;');\n      }\n    } catch (err) {\n      console.warn('⚠️  Could not verify pgvector extension');\n    }\n  }\n\n  /**\n   * Store agent memory in Supabase\n   */\n  async storeMemory(memory: AgentMemory): Promise<void> {\n    const { error } = await this.client\n      .from('agent_memories')\n      .insert({\n        id: memory.id,\n        tenant_id: memory.tenant_id,\n        agent_id: memory.agent_id,\n        session_id: memory.session_id,\n        content: memory.content,\n        embedding: memory.embedding,\n        metadata: memory.metadata,\n        created_at: memory.created_at || new Date().toISOString(),\n        expires_at: memory.expires_at,\n      });\n\n    if (error) {\n      throw new Error(`Failed to store memory: ${error.message}`);\n    }\n  }\n\n  /**\n   * Query memories by tenant and agent\n   */\n  async queryMemories(\n    tenantId: string,\n    agentId?: string,\n    limit: number = 100\n  ): Promise<AgentMemory[]> {\n    let query = this.client\n      .from('agent_memories')\n      .select('*')\n      .eq('tenant_id', tenantId)\n      .order('created_at', { ascending: false })\n      .limit(limit);\n\n    if (agentId) {\n      query = query.eq('agent_id', agentId);\n    }\n\n    const { data, error } = await query;\n\n    if (error) {\n      throw new Error(`Failed to query memories: ${error.message}`);\n    }\n\n    return data as AgentMemory[];\n  }\n\n  /**\n   * Semantic search using pgvector\n   */\n  async semanticSearch(\n    embedding: number[],\n    tenantId: string,\n    limit: number = 10\n  ): Promise<AgentMemory[]> {\n    if (this.config.vectorBackend !== 'pgvector') {\n      throw new Error('pgvector backend not enabled');\n    }\n\n    // Use pgvector cosine similarity search\n    const { data, error } = await this.client.rpc('search_memories', {\n      query_embedding: embedding,\n      query_tenant_id: tenantId,\n      match_count: limit,\n    });\n\n    if (error) {\n      throw new Error(`Semantic search failed: ${error.message}`);\n    }\n\n    return data as AgentMemory[];\n  }\n\n  /**\n   * Register agent session\n   */\n  async registerSession(\n    sessionId: string,\n    tenantId: string,\n    agentId: string,\n    metadata?: Record<string, any>\n  ): Promise<void> {\n    const { error } = await this.client\n      .from('agent_sessions')\n      .insert({\n        session_id: sessionId,\n        tenant_id: tenantId,\n        agent_id: agentId,\n        metadata,\n        started_at: new Date().toISOString(),\n        status: 'active',\n      });\n\n    if (error) {\n      throw new Error(`Failed to register session: ${error.message}`);\n    }\n  }\n\n  /**\n   * Update session status\n   */\n  async updateSessionStatus(\n    sessionId: string,\n    status: 'active' | 'completed' | 'failed'\n  ): Promise<void> {\n    const updates: any = { status };\n\n    if (status !== 'active') {\n      updates.ended_at = new Date().toISOString();\n    }\n\n    const { error } = await this.client\n      .from('agent_sessions')\n      .update(updates)\n      .eq('session_id', sessionId);\n\n    if (error) {\n      throw new Error(`Failed to update session: ${error.message}`);\n    }\n  }\n\n  /**\n   * Get active sessions for tenant\n   */\n  async getActiveSessions(tenantId: string): Promise<any[]> {\n    const { data, error } = await this.client\n      .from('agent_sessions')\n      .select('*')\n      .eq('tenant_id', tenantId)\n      .eq('status', 'active')\n      .order('started_at', { ascending: false });\n\n    if (error) {\n      throw new Error(`Failed to get sessions: ${error.message}`);\n    }\n\n    return data || [];\n  }\n\n  /**\n   * Subscribe to real-time memory updates\n   */\n  subscribeToMemories(\n    tenantId: string,\n    callback: (payload: any) => void\n  ): () => void {\n    const subscription = this.client\n      .channel(`memories:${tenantId}`)\n      .on(\n        'postgres_changes',\n        {\n          event: 'INSERT',\n          schema: 'public',\n          table: 'agent_memories',\n          filter: `tenant_id=eq.${tenantId}`,\n        },\n        callback\n      )\n      .subscribe();\n\n    // Return unsubscribe function\n    return () => {\n      subscription.unsubscribe();\n    };\n  }\n\n  /**\n   * Clean up expired memories\n   */\n  async cleanupExpiredMemories(): Promise<number> {\n    const { data, error } = await this.client\n      .from('agent_memories')\n      .delete()\n      .lt('expires_at', new Date().toISOString())\n      .select('id');\n\n    if (error) {\n      throw new Error(`Cleanup failed: ${error.message}`);\n    }\n\n    return data?.length || 0;\n  }\n\n  /**\n   * Get hub statistics\n   */\n  async getStats(tenantId?: string): Promise<any> {\n    // Total memories\n    let memoriesQuery = this.client\n      .from('agent_memories')\n      .select('id', { count: 'exact', head: true });\n\n    if (tenantId) {\n      memoriesQuery = memoriesQuery.eq('tenant_id', tenantId);\n    }\n\n    const { count: totalMemories } = await memoriesQuery;\n\n    // Active sessions\n    let sessionsQuery = this.client\n      .from('agent_sessions')\n      .select('session_id', { count: 'exact', head: true })\n      .eq('status', 'active');\n\n    if (tenantId) {\n      sessionsQuery = sessionsQuery.eq('tenant_id', tenantId);\n    }\n\n    const { count: activeSessions } = await sessionsQuery;\n\n    return {\n      total_memories: totalMemories || 0,\n      active_sessions: activeSessions || 0,\n      backend: 'supabase',\n      vector_backend: this.config.vectorBackend,\n      timestamp: new Date().toISOString(),\n    };\n  }\n\n  /**\n   * Close connection\n   */\n  async close(): Promise<void> {\n    // Supabase client doesn't need explicit closing\n    console.log('✅ Supabase connection closed');\n  }\n}\n\n/**\n * Create Supabase adapter from environment variables\n */\nexport function createSupabaseAdapter(): SupabaseFederationAdapter {\n  const url = process.env.SUPABASE_URL;\n  const anonKey = process.env.SUPABASE_ANON_KEY;\n  const serviceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY;\n\n  if (!url || !anonKey) {\n    throw new Error(\n      'Missing Supabase credentials. Set SUPABASE_URL and SUPABASE_ANON_KEY'\n    );\n  }\n\n  return new SupabaseFederationAdapter({\n    url,\n    anonKey,\n    serviceRoleKey,\n    vectorBackend: (process.env.FEDERATION_VECTOR_BACKEND as any) || 'hybrid',\n    syncInterval: parseInt(process.env.FEDERATION_SYNC_INTERVAL || '60000'),\n  });\n}\n"]}

package/agentic-flow/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,UAAU,YAAY;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,GAAG,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnD,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,IAAI,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1G,CAAC;CACH;AAID,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAyD7D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAa,GAAG,IAAI,CAAC,MAAM,CAwDlE"}

package/agentic-flow/dist/health.js

@@ -0,0 +1,112 @@
+// Health check endpoint with QUIC support
+import http from 'http';
+import { logger } from './utils/logger.js';
+let serverStartTime = Date.now();
+export async function getHealthStatus() {
+    const memUsage = process.memoryUsage();
+    const memLimit = 512 * 1024 * 1024; // 512MB
+    const memPercent = (memUsage.heapUsed / memLimit) * 100;
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    const checks = {
+        api: {
+            status: apiKey && apiKey.startsWith('sk-ant-') ? 'pass' : 'fail',
+            message: apiKey ? undefined : 'ANTHROPIC_API_KEY not configured'
+        },
+        memory: {
+            status: memPercent > 90 ? 'fail' : memPercent > 75 ? 'warn' : 'pass',
+            usage: Math.round(memUsage.heapUsed / 1024 / 1024),
+            limit: Math.round(memLimit / 1024 / 1024)
+        }
+    };
+    // Check QUIC availability if enabled
+    const quicEnabled = process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true';
+    if (quicEnabled) {
+        try {
+            // Dynamic import to avoid loading QUIC module when not needed
+            const { checkQuicAvailability } = await import('./config/quic.js');
+            const availability = await checkQuicAvailability();
+            checks.quic = {
+                status: availability.available ? 'pass' : 'warn',
+                enabled: true,
+                available: availability.available,
+                connections: 0
+            };
+        }
+        catch (error) {
+            logger.warn('QUIC health check failed', { error });
+            checks.quic = {
+                status: 'fail',
+                enabled: true,
+                available: false
+            };
+        }
+    }
+    let overallStatus = 'healthy';
+    if (checks.memory.status === 'fail' || checks.api.status === 'fail') {
+        overallStatus = 'unhealthy';
+    }
+    else if (checks.memory.status === 'warn' || checks.quic?.status === 'warn') {
+        overallStatus = 'degraded';
+    }
+    return {
+        status: overallStatus,
+        timestamp: new Date().toISOString(),
+        uptime: (Date.now() - serverStartTime) / 1000,
+        version: process.env.npm_package_version || '1.5.10',
+        checks
+    };
+}
+export function startHealthServer(port = 8080) {
+    const server = http.createServer(async (req, res) => {
+        if (req.url === '/health' && req.method === 'GET') {
+            const health = await getHealthStatus();
+            const statusCode = health.status === 'healthy' ? 200 : health.status === 'degraded' ? 200 : 503;
+            res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(health, null, 2));
+            logger.debug('Health check requested', { status: health.status, quicEnabled: !!health.checks.quic });
+        }
+        else if (req.url === '/health/quic' && req.method === 'GET') {
+            // QUIC-specific health endpoint
+            const quicEnabled = process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true';
+            if (!quicEnabled) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ enabled: false, message: 'QUIC transport is disabled' }));
+                return;
+            }
+            try {
+                const { checkQuicAvailability, loadQuicConfig } = await import('./config/quic.js');
+                const availability = await checkQuicAvailability();
+                const config = loadQuicConfig();
+                res.writeHead(availability.available ? 200 : 503, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    enabled: true,
+                    available: availability.available,
+                    reason: availability.reason,
+                    config: {
+                        host: config.host,
+                        port: config.port,
+                        maxConnections: config.maxConnections,
+                        maxStreams: config.maxConcurrentStreams
+                    }
+                }, null, 2));
+            }
+            catch (error) {
+                res.writeHead(503, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    enabled: true,
+                    available: false,
+                    error: error.message
+                }));
+            }
+        }
+        else {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not found' }));
+        }
+    });
+    server.listen(port, () => {
+        logger.info('Health check server started', { port });
+    });
+    return server;
+}
+//# sourceMappingURL=health.js.map

package/agentic-flow/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"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","sourcesContent":["// Health check endpoint with QUIC support\nimport http from 'http';\nimport { logger } from './utils/logger.js';\nimport type { QuicClient, QuicStats } from './transport/quic.js';\nimport type { QuicConfigSchema } from './config/quic.js';\n\ninterface HealthStatus {\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  timestamp: string;\n  uptime: number;\n  version: string;\n  checks: {\n    api: { status: 'pass' | 'fail'; message?: string };\n    memory: { status: 'pass' | 'warn' | 'fail'; usage: number; limit: number };\n    quic?: { status: 'pass' | 'warn' | 'fail'; enabled: boolean; available?: boolean; connections?: number };\n  };\n}\n\nlet serverStartTime = Date.now();\n\nexport async function getHealthStatus(): Promise<HealthStatus> {\n  const memUsage = process.memoryUsage();\n  const memLimit = 512 * 1024 * 1024; // 512MB\n  const memPercent = (memUsage.heapUsed / memLimit) * 100;\n\n  const apiKey = process.env.ANTHROPIC_API_KEY;\n\n  const checks: HealthStatus['checks'] = {\n    api: {\n      status: apiKey && apiKey.startsWith('sk-ant-') ? 'pass' : 'fail',\n      message: apiKey ? undefined : 'ANTHROPIC_API_KEY not configured'\n    },\n    memory: {\n      status: memPercent > 90 ? 'fail' : memPercent > 75 ? 'warn' : 'pass',\n      usage: Math.round(memUsage.heapUsed / 1024 / 1024),\n      limit: Math.round(memLimit / 1024 / 1024)\n    }\n  };\n\n  // Check QUIC availability if enabled\n  const quicEnabled = process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true';\n  if (quicEnabled) {\n    try {\n      // Dynamic import to avoid loading QUIC module when not needed\n      const { checkQuicAvailability } = await import('./config/quic.js');\n      const availability = await checkQuicAvailability();\n\n      checks.quic = {\n        status: availability.available ? 'pass' : 'warn',\n        enabled: true,\n        available: availability.available,\n        connections: 0\n      };\n    } catch (error) {\n      logger.warn('QUIC health check failed', { error });\n      checks.quic = {\n        status: 'fail',\n        enabled: true,\n        available: false\n      };\n    }\n  }\n\n  let overallStatus: 'healthy' | 'degraded' | 'unhealthy' = 'healthy';\n  if (checks.memory.status === 'fail' || checks.api.status === 'fail') {\n    overallStatus = 'unhealthy';\n  } else if (checks.memory.status === 'warn' || checks.quic?.status === 'warn') {\n    overallStatus = 'degraded';\n  }\n\n  return {\n    status: overallStatus,\n    timestamp: new Date().toISOString(),\n    uptime: (Date.now() - serverStartTime) / 1000,\n    version: process.env.npm_package_version || '1.5.10',\n    checks\n  };\n}\n\nexport function startHealthServer(port: number = 8080): http.Server {\n  const server = http.createServer(async (req, res) => {\n    if (req.url === '/health' && req.method === 'GET') {\n      const health = await getHealthStatus();\n      const statusCode = health.status === 'healthy' ? 200 : health.status === 'degraded' ? 200 : 503;\n\n      res.writeHead(statusCode, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify(health, null, 2));\n\n      logger.debug('Health check requested', { status: health.status, quicEnabled: !!health.checks.quic });\n    } else if (req.url === '/health/quic' && req.method === 'GET') {\n      // QUIC-specific health endpoint\n      const quicEnabled = process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true';\n\n      if (!quicEnabled) {\n        res.writeHead(200, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({ enabled: false, message: 'QUIC transport is disabled' }));\n        return;\n      }\n\n      try {\n        const { checkQuicAvailability, loadQuicConfig } = await import('./config/quic.js');\n        const availability = await checkQuicAvailability();\n        const config = loadQuicConfig();\n\n        res.writeHead(availability.available ? 200 : 503, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({\n          enabled: true,\n          available: availability.available,\n          reason: availability.reason,\n          config: {\n            host: config.host,\n            port: config.port,\n            maxConnections: config.maxConnections,\n            maxStreams: config.maxConcurrentStreams\n          }\n        }, null, 2));\n      } catch (error) {\n        res.writeHead(503, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({\n          enabled: true,\n          available: false,\n          error: (error as Error).message\n        }));\n      }\n    } else {\n      res.writeHead(404, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ error: 'Not found' }));\n    }\n  });\n\n  server.listen(port, () => {\n    logger.info('Health check server started', { port });\n  });\n\n  return server;\n}\n"]}

package/agentic-flow/dist/hooks/parallel-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-validation.d.ts","sourceRoot":"","sources":["../../src/hooks/parallel-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,gBAAgB,GACxB,wBAAwB,CA4E1B;AA4CD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAgCA"}

package/agentic-flow/dist/hooks/parallel-validation.js

@@ -0,0 +1,167 @@
+/**
+ * Validation hooks to ensure agents follow parallel execution best practices
+ */
+/**
+ * Validate agent's parallel execution patterns
+ */
+export function validateParallelExecution(response, metrics) {
+    const issues = [];
+    const recommendations = [];
+    let score = 1.0;
+    // Check 1: Sequential subprocess spawning
+    if (hasSequentialSubprocessSpawning(response)) {
+        issues.push("Sequential subprocess spawning detected");
+        recommendations.push("Use Promise.all() to spawn all subprocesses concurrently:\n" +
+            "await Promise.all([exec('agent1'), exec('agent2'), exec('agent3')])");
+        score -= 0.3;
+    }
+    // Check 2: Missing ReasoningBank coordination
+    if ((response.subprocesses?.length || 0) > 1 && !usesReasoningBank(response)) {
+        issues.push("Multiple subprocesses without ReasoningBank coordination");
+        recommendations.push("Store subprocess results in ReasoningBank for proper coordination:\n" +
+            "await reasoningBank.storePattern({ sessionId: 'swarm/task-id/agent-id', task, output, reward, success })");
+        score -= 0.2;
+    }
+    // Check 3: Small batch sizes
+    if (metrics.avgBatchSize < 3) {
+        issues.push(`Small batch size detected: ${metrics.avgBatchSize} (recommended: 5+)`);
+        recommendations.push("Increase batch size to maximize parallelism. Target 5-10 concurrent operations.");
+        score -= 0.1;
+    }
+    // Check 4: No QUIC transport for large-scale operations
+    if (metrics.subprocessesSpawned > 10 && !usesQuicTransport(response)) {
+        issues.push("Large-scale operation without QUIC transport");
+        recommendations.push("Use QUIC transport for 50-70% performance improvement:\n" +
+            "npx agentic-flow --agent TYPE --task TASK --transport quic");
+        score -= 0.15;
+    }
+    // Check 5: Missing result synthesis
+    if ((response.subprocesses?.length || 0) > 1 && !synthesizesResults(response)) {
+        issues.push("Multiple subprocesses without result synthesis");
+        recommendations.push("Combine subprocess results into a unified report:\n" +
+            "const allResults = await Promise.all(subprocesses.map(retrieveResult));\n" +
+            "const report = synthesize(allResults);");
+        score -= 0.15;
+    }
+    // Check 6: No pattern storage for successful executions
+    if (score > 0.8 && !storesSuccessPattern(response)) {
+        recommendations.push("Store successful execution patterns in ReasoningBank for learning:\n" +
+            "await reasoningBank.storePattern({ sessionId, task, output, reward, success })");
+        score -= 0.1;
+    }
+    return {
+        score: Math.max(0, score),
+        issues,
+        recommendations,
+        metrics: {
+            parallelOpsCount: countParallelOps(response),
+            sequentialOpsCount: countSequentialOps(response),
+            avgBatchSize: metrics.avgBatchSize,
+            subprocessesSpawned: metrics.subprocessesSpawned,
+            reasoningBankUsage: metrics.reasoningBankUsage
+        }
+    };
+}
+// Helper functions
+function hasSequentialSubprocessSpawning(response) {
+    // Check if subprocess spawning uses await in sequence vs Promise.all
+    const code = response.code || response.output || '';
+    const hasAwaitExec = /await\s+exec/.test(code);
+    const hasPromiseAll = /Promise\.all\(/i.test(code);
+    return hasAwaitExec && !hasPromiseAll;
+}
+function usesReasoningBank(response) {
+    const code = response.code || response.output || '';
+    return /reasoningBank\.(store|retrieve|search|storePattern)/.test(code);
+}
+function usesQuicTransport(response) {
+    const code = response.code || response.output || '';
+    return /--transport\s+quic/i.test(code) || /QuicTransport/.test(code);
+}
+function synthesizesResults(response) {
+    const code = response.code || response.output || '';
+    return /synthesize|combine|merge|aggregate/i.test(code);
+}
+function storesSuccessPattern(response) {
+    const code = response.code || response.output || '';
+    return /storePattern|reasoningBank\.store/.test(code);
+}
+function countParallelOps(response) {
+    const code = response.code || response.output || '';
+    const promiseAllMatches = code.match(/Promise\.all\(/g);
+    return promiseAllMatches?.length || 0;
+}
+function countSequentialOps(response) {
+    const code = response.code || response.output || '';
+    const awaitMatches = code.match(/await\s+(?!Promise\.all)/g);
+    return awaitMatches?.length || 0;
+}
+/**
+ * Post-execution hook: Log validation results and suggestions
+ */
+export async function postExecutionValidation(response, metrics) {
+    const validation = validateParallelExecution(response, metrics);
+    console.log('\n📊 Parallel Execution Validation');
+    console.log('═'.repeat(60));
+    console.log(`Score: ${(validation.score * 100).toFixed(1)}%`);
+    console.log(`Parallel Ops: ${validation.metrics.parallelOpsCount}`);
+    console.log(`Sequential Ops: ${validation.metrics.sequentialOpsCount}`);
+    console.log(`Batch Size: ${validation.metrics.avgBatchSize}`);
+    console.log(`Subprocesses: ${validation.metrics.subprocessesSpawned}`);
+    console.log(`ReasoningBank Usage: ${validation.metrics.reasoningBankUsage}`);
+    if (validation.issues.length > 0) {
+        console.log('\n⚠️  Issues Detected:');
+        validation.issues.forEach((issue, i) => {
+            console.log(`  ${i + 1}. ${issue}`);
+        });
+    }
+    if (validation.recommendations.length > 0) {
+        console.log('\n💡 Recommendations:');
+        validation.recommendations.forEach((rec, i) => {
+            console.log(`  ${i + 1}. ${rec}`);
+        });
+    }
+    console.log('═'.repeat(60));
+    return validation;
+}
+/**
+ * Grade parallel execution quality
+ */
+export function gradeParallelExecution(score) {
+    if (score >= 0.9) {
+        return {
+            grade: 'A',
+            description: 'Excellent parallel execution',
+            color: 'green'
+        };
+    }
+    else if (score >= 0.75) {
+        return {
+            grade: 'B',
+            description: 'Good parallel execution with minor improvements needed',
+            color: 'blue'
+        };
+    }
+    else if (score >= 0.6) {
+        return {
+            grade: 'C',
+            description: 'Acceptable parallel execution with room for improvement',
+            color: 'yellow'
+        };
+    }
+    else if (score >= 0.4) {
+        return {
+            grade: 'D',
+            description: 'Poor parallel execution, needs significant improvements',
+            color: 'orange'
+        };
+    }
+    else {
+        return {
+            grade: 'F',
+            description: 'Sequential execution detected, parallelism not utilized',
+            color: 'red'
+        };
+    }
+}
+//# sourceMappingURL=parallel-validation.js.map

package/agentic-flow/dist/hooks/parallel-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-validation.js","sourceRoot":"","sources":["../../src/hooks/parallel-validation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validation hooks to ensure agents follow parallel execution best practices\n */\n\nexport interface AgentResponse {\n  code?: string;\n  output?: string;\n  subprocesses?: Array<{ command: string; result: any }>;\n  toolCalls?: Array<{ name: string; args: any }>;\n}\n\nexport interface ExecutionMetrics {\n  avgBatchSize: number;\n  subprocessesSpawned: number;\n  reasoningBankUsage: number;\n  parallelOpsCount?: number;\n  sequentialOpsCount?: number;\n}\n\nexport interface ParallelValidationResult {\n  score: number; // 0-1, where 1 is perfect parallel execution\n  issues: string[];\n  recommendations: string[];\n  metrics: {\n    parallelOpsCount: number;\n    sequentialOpsCount: number;\n    avgBatchSize: number;\n    subprocessesSpawned: number;\n    reasoningBankUsage: number;\n  };\n}\n\n/**\n * Validate agent's parallel execution patterns\n */\nexport function validateParallelExecution(\n  response: AgentResponse,\n  metrics: ExecutionMetrics\n): ParallelValidationResult {\n  const issues: string[] = [];\n  const recommendations: string[] = [];\n  let score = 1.0;\n\n  // Check 1: Sequential subprocess spawning\n  if (hasSequentialSubprocessSpawning(response)) {\n    issues.push(\"Sequential subprocess spawning detected\");\n    recommendations.push(\n      \"Use Promise.all() to spawn all subprocesses concurrently:\\n\" +\n      \"await Promise.all([exec('agent1'), exec('agent2'), exec('agent3')])\"\n    );\n    score -= 0.3;\n  }\n\n  // Check 2: Missing ReasoningBank coordination\n  if ((response.subprocesses?.length || 0) > 1 && !usesReasoningBank(response)) {\n    issues.push(\"Multiple subprocesses without ReasoningBank coordination\");\n    recommendations.push(\n      \"Store subprocess results in ReasoningBank for proper coordination:\\n\" +\n      \"await reasoningBank.storePattern({ sessionId: 'swarm/task-id/agent-id', task, output, reward, success })\"\n    );\n    score -= 0.2;\n  }\n\n  // Check 3: Small batch sizes\n  if (metrics.avgBatchSize < 3) {\n    issues.push(`Small batch size detected: ${metrics.avgBatchSize} (recommended: 5+)`);\n    recommendations.push(\n      \"Increase batch size to maximize parallelism. Target 5-10 concurrent operations.\"\n    );\n    score -= 0.1;\n  }\n\n  // Check 4: No QUIC transport for large-scale operations\n  if (metrics.subprocessesSpawned > 10 && !usesQuicTransport(response)) {\n    issues.push(\"Large-scale operation without QUIC transport\");\n    recommendations.push(\n      \"Use QUIC transport for 50-70% performance improvement:\\n\" +\n      \"npx agentic-flow --agent TYPE --task TASK --transport quic\"\n    );\n    score -= 0.15;\n  }\n\n  // Check 5: Missing result synthesis\n  if ((response.subprocesses?.length || 0) > 1 && !synthesizesResults(response)) {\n    issues.push(\"Multiple subprocesses without result synthesis\");\n    recommendations.push(\n      \"Combine subprocess results into a unified report:\\n\" +\n      \"const allResults = await Promise.all(subprocesses.map(retrieveResult));\\n\" +\n      \"const report = synthesize(allResults);\"\n    );\n    score -= 0.15;\n  }\n\n  // Check 6: No pattern storage for successful executions\n  if (score > 0.8 && !storesSuccessPattern(response)) {\n    recommendations.push(\n      \"Store successful execution patterns in ReasoningBank for learning:\\n\" +\n      \"await reasoningBank.storePattern({ sessionId, task, output, reward, success })\"\n    );\n    score -= 0.1;\n  }\n\n  return {\n    score: Math.max(0, score),\n    issues,\n    recommendations,\n    metrics: {\n      parallelOpsCount: countParallelOps(response),\n      sequentialOpsCount: countSequentialOps(response),\n      avgBatchSize: metrics.avgBatchSize,\n      subprocessesSpawned: metrics.subprocessesSpawned,\n      reasoningBankUsage: metrics.reasoningBankUsage\n    }\n  };\n}\n\n// Helper functions\nfunction hasSequentialSubprocessSpawning(response: AgentResponse): boolean {\n  // Check if subprocess spawning uses await in sequence vs Promise.all\n  const code = response.code || response.output || '';\n  const hasAwaitExec = /await\\s+exec/.test(code);\n  const hasPromiseAll = /Promise\\.all\\(/i.test(code);\n\n  return hasAwaitExec && !hasPromiseAll;\n}\n\nfunction usesReasoningBank(response: AgentResponse): boolean {\n  const code = response.code || response.output || '';\n  return /reasoningBank\\.(store|retrieve|search|storePattern)/.test(code);\n}\n\nfunction usesQuicTransport(response: AgentResponse): boolean {\n  const code = response.code || response.output || '';\n  return /--transport\\s+quic/i.test(code) || /QuicTransport/.test(code);\n}\n\nfunction synthesizesResults(response: AgentResponse): boolean {\n  const code = response.code || response.output || '';\n  return /synthesize|combine|merge|aggregate/i.test(code);\n}\n\nfunction storesSuccessPattern(response: AgentResponse): boolean {\n  const code = response.code || response.output || '';\n  return /storePattern|reasoningBank\\.store/.test(code);\n}\n\nfunction countParallelOps(response: AgentResponse): number {\n  const code = response.code || response.output || '';\n  const promiseAllMatches = code.match(/Promise\\.all\\(/g);\n  return promiseAllMatches?.length || 0;\n}\n\nfunction countSequentialOps(response: AgentResponse): number {\n  const code = response.code || response.output || '';\n  const awaitMatches = code.match(/await\\s+(?!Promise\\.all)/g);\n  return awaitMatches?.length || 0;\n}\n\n/**\n * Post-execution hook: Log validation results and suggestions\n */\nexport async function postExecutionValidation(\n  response: AgentResponse,\n  metrics: ExecutionMetrics\n): Promise<ParallelValidationResult> {\n  const validation = validateParallelExecution(response, metrics);\n\n  console.log('\\n📊 Parallel Execution Validation');\n  console.log('═'.repeat(60));\n  console.log(`Score: ${(validation.score * 100).toFixed(1)}%`);\n  console.log(`Parallel Ops: ${validation.metrics.parallelOpsCount}`);\n  console.log(`Sequential Ops: ${validation.metrics.sequentialOpsCount}`);\n  console.log(`Batch Size: ${validation.metrics.avgBatchSize}`);\n  console.log(`Subprocesses: ${validation.metrics.subprocessesSpawned}`);\n  console.log(`ReasoningBank Usage: ${validation.metrics.reasoningBankUsage}`);\n\n  if (validation.issues.length > 0) {\n    console.log('\\n⚠️  Issues Detected:');\n    validation.issues.forEach((issue, i) => {\n      console.log(`  ${i + 1}. ${issue}`);\n    });\n  }\n\n  if (validation.recommendations.length > 0) {\n    console.log('\\n💡 Recommendations:');\n    validation.recommendations.forEach((rec, i) => {\n      console.log(`  ${i + 1}. ${rec}`);\n    });\n  }\n\n  console.log('═'.repeat(60));\n\n  return validation;\n}\n\n/**\n * Grade parallel execution quality\n */\nexport function gradeParallelExecution(score: number): {\n  grade: string;\n  description: string;\n  color: string;\n} {\n  if (score >= 0.9) {\n    return {\n      grade: 'A',\n      description: 'Excellent parallel execution',\n      color: 'green'\n    };\n  } else if (score >= 0.75) {\n    return {\n      grade: 'B',\n      description: 'Good parallel execution with minor improvements needed',\n      color: 'blue'\n    };\n  } else if (score >= 0.6) {\n    return {\n      grade: 'C',\n      description: 'Acceptable parallel execution with room for improvement',\n      color: 'yellow'\n    };\n  } else if (score >= 0.4) {\n    return {\n      grade: 'D',\n      description: 'Poor parallel execution, needs significant improvements',\n      color: 'orange'\n    };\n  } else {\n    return {\n      grade: 'F',\n      description: 'Sequential execution detected, parallelism not utilized',\n      color: 'red'\n    };\n  }\n}\n"]}

package/agentic-flow/dist/hooks/swarm-learning-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-learning-optimizer.d.ts","sourceRoot":"","sources":["../../src/hooks/swarm-learning-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,mBAAmB,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;gBAEtC,aAAa,EAAE,aAAa;IAIxC;;OAEG;IACG,qBAAqB,CACzB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACG,eAAe,CACnB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,EACtD,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,0BAA0B,CAAC;IAkFtC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyDjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC;QACpC,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7C,cAAc,EAAE,MAAM,CAAC;QACvB,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;CAkEH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACzB,GACL,OAAO,CAAC,0BAA0B,CAAC,CAOrC"}