agentic-flow 1.8.15 → 1.9.0

package/validation/docker-quic-validation.sh

@@ -1,60 +0,0 @@
-#!/bin/bash
-# Docker QUIC Validation Script
-# Runs comprehensive QUIC tests in isolated Docker environment
-
-set -e
-
-echo "🐳 QUIC Docker Validation Suite"
-echo "================================"
-echo ""
-
-# Colors
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# Navigate to package directory
-cd "$(dirname "$0")/.."
-
-echo "📦 Building Docker validation image..."
-docker build -f Dockerfile.quic-validation -t agentic-flow-quic-validation . 2>&1 | tail -20
-
-if [ $? -ne 0 ]; then
-  echo -e "${RED}❌ Docker build failed${NC}"
-  exit 1
-fi
-
-echo -e "${GREEN}✅ Docker image built successfully${NC}"
-echo ""
-
-echo "🧪 Running QUIC validation tests in Docker..."
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-# Run validation container
-docker run --rm \
-  --name quic-validation \
-  -e QUIC_PORT=4433 \
-  -e NODE_ENV=production \
-  agentic-flow-quic-validation
-
-VALIDATION_RESULT=$?
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-if [ $VALIDATION_RESULT -eq 0 ]; then
-  echo -e "${GREEN}✅ All QUIC validations passed in Docker!${NC}"
-  echo ""
-  echo "✨ QUIC is ready for:"
-  echo "  • npm publish"
-  echo "  • Remote deployment"
-  echo "  • Production use"
-  exit 0
-else
-  echo -e "${RED}❌ QUIC validation failed in Docker${NC}"
-  echo ""
-  echo "⚠️  Issues detected - fix before publishing"
-  exit 1
-fi

package/validation/quic-deep-validation.ts

@@ -1,304 +0,0 @@
-#!/usr/bin/env tsx
-/**
- * Deep QUIC Validation Suite
- * Comprehensive testing of all QUIC capabilities for remote deployment
- */
-
-import { existsSync } from 'fs';
-import { join } from 'path';
-
-interface ValidationResult {
-  test: string;
-  passed: boolean;
-  error?: string;
-  details?: string;
-}
-
-const results: ValidationResult[] = [];
-
-async function validate(testName: string, fn: () => Promise<void>): Promise<void> {
-  try {
-    await fn();
-    results.push({ test: testName, passed: true });
-    console.log(`✅ ${testName}`);
-  } catch (error) {
-    const errorMsg = error instanceof Error ? error.message : String(error);
-    results.push({ test: testName, passed: false, error: errorMsg });
-    console.log(`❌ ${testName}: ${errorMsg}`);
-  }
-}
-
-async function main() {
-  console.log('🧪 QUIC Deep Validation Suite\n');
-  console.log('Testing all QUIC capabilities for remote deployment...\n');
-
-  // 1. WASM Module Validation
-  console.log('📦 WASM Module Tests:');
-  await validate('WASM module exists', async () => {
-    const wasmPath = join(process.cwd(), 'wasm/quic/agentic_flow_quic.js');
-    if (!existsSync(wasmPath)) {
-      throw new Error(`WASM module not found at ${wasmPath}`);
-    }
-  });
-
-  await validate('WASM bindings loadable', async () => {
-    const wasmModule = await import('../wasm/quic/agentic_flow_quic.js');
-    if (!wasmModule) {
-      throw new Error('Failed to load WASM module');
-    }
-  });
-
-  await validate('WASM exports correct functions', async () => {
-    const wasmModule = await import('../wasm/quic/agentic_flow_quic.js');
-    const requiredExports = ['WasmQuicClient', 'createQuicMessage', 'defaultConfig'];
-
-    for (const exportName of requiredExports) {
-      if (!(exportName in wasmModule)) {
-        throw new Error(`Missing required export: ${exportName}`);
-      }
-    }
-  });
-
-  await validate('WASM config creation', async () => {
-    const { defaultConfig } = await import('../wasm/quic/agentic_flow_quic.js');
-    const config = defaultConfig();
-    if (!config || typeof config !== 'object') {
-      throw new Error('Invalid config object');
-    }
-  });
-
-  await validate('WASM message creation', async () => {
-    const { createQuicMessage } = await import('../wasm/quic/agentic_flow_quic.js');
-    const message = createQuicMessage(
-      'test-id-001',
-      'task',
-      new Uint8Array([1, 2, 3, 4]),
-      null
-    );
-    if (!message || typeof message !== 'object') {
-      throw new Error('Invalid message object');
-    }
-  });
-
-  // 2. TypeScript Transport Layer (from dist/ for production install)
-  console.log('\n📡 TypeScript Transport Tests:');
-  await validate('Compiled QuicTransport module exists', async () => {
-    const transportPath = join(process.cwd(), 'dist/transport/quic.js');
-    if (!existsSync(transportPath)) {
-      throw new Error(`Compiled transport not found at ${transportPath}`);
-    }
-  });
-
-  await validate('QuicTransport class loadable', async () => {
-    const { QuicTransport } = await import('../dist/transport/quic.js');
-    if (!QuicTransport) {
-      throw new Error('QuicTransport class not found');
-    }
-  });
-
-  await validate('QuicTransport instantiation', async () => {
-    const { QuicTransport } = await import('../dist/transport/quic.js');
-    const transport = new QuicTransport({
-      host: 'localhost',
-      port: 4433,
-      maxConcurrentStreams: 100
-    });
-    if (!transport) {
-      throw new Error('Failed to instantiate QuicTransport');
-    }
-  });
-
-  // 3. Package Exports Validation
-  console.log('\n📦 Package Export Tests:');
-  await validate('package.json has quic export', async () => {
-    const pkg = await import('../package.json');
-    if (!pkg.exports || !pkg.exports['./transport/quic']) {
-      throw new Error('Missing ./transport/quic export in package.json');
-    }
-  });
-
-  await validate('dist/transport/quic.js exists', async () => {
-    const distPath = join(process.cwd(), 'dist/transport/quic.js');
-    if (!existsSync(distPath)) {
-      throw new Error(`Compiled transport not found at ${distPath}`);
-    }
-  });
-
-  await validate('QuicTransport importable from package', async () => {
-    try {
-      // Test the actual package export path
-      const transportModule = await import('../dist/transport/quic.js');
-      if (!transportModule.QuicTransport) {
-        throw new Error('QuicTransport not exported from dist');
-      }
-    } catch (error) {
-      throw new Error(`Import failed: ${error}`);
-    }
-  });
-
-  // 4. CLI Integration Tests
-  console.log('\n💻 CLI Integration Tests:');
-  await validate('CLI has quic command', async () => {
-    const cliPath = join(process.cwd(), 'dist/cli-proxy.js');
-    if (!existsSync(cliPath)) {
-      throw new Error('CLI not found');
-    }
-
-    const { readFileSync } = await import('fs');
-    const cliContent = readFileSync(cliPath, 'utf-8');
-    if (!cliContent.includes('quic')) {
-      throw new Error('CLI missing quic command');
-    }
-  });
-
-  await validate('QUIC proxy handler exists', async () => {
-    const cliPath = join(process.cwd(), 'dist/cli-proxy.js');
-    const { readFileSync } = await import('fs');
-    const cliContent = readFileSync(cliPath, 'utf-8');
-    if (!cliContent.includes('runQuicProxy')) {
-      throw new Error('CLI missing runQuicProxy handler');
-    }
-  });
-
-  // 5. Configuration Tests (from dist/ for production install)
-  console.log('\n⚙️  Configuration Tests:');
-  await validate('Compiled QUIC config module exists', async () => {
-    const configPath = join(process.cwd(), 'dist/config/quic.js');
-    if (!existsSync(configPath)) {
-      throw new Error(`Compiled QUIC config not found at ${configPath}`);
-    }
-  });
-
-  await validate('Default QUIC config loadable', async () => {
-    const { getQuicConfig } = await import('../dist/config/quic.js');
-    const config = getQuicConfig();
-    if (!config || typeof config.port !== 'number') {
-      throw new Error('Invalid QUIC config');
-    }
-  });
-
-  // 6. npm Scripts Validation
-  console.log('\n📝 npm Scripts Tests:');
-  await validate('proxy:quic script exists', async () => {
-    const pkg = await import('../package.json');
-    if (!pkg.scripts['proxy:quic']) {
-      throw new Error('Missing proxy:quic script');
-    }
-  });
-
-  await validate('proxy:quic:dev script exists', async () => {
-    const pkg = await import('../package.json');
-    if (!pkg.scripts['proxy:quic:dev']) {
-      throw new Error('Missing proxy:quic:dev script');
-    }
-  });
-
-  await validate('test:quic:wasm script exists', async () => {
-    const pkg = await import('../package.json');
-    if (!pkg.scripts['test:quic:wasm']) {
-      throw new Error('Missing test:quic:wasm script');
-    }
-  });
-
-  // 7. Documentation Tests
-  console.log('\n📚 Documentation Tests:');
-  await validate('README mentions QUIC', async () => {
-    const { readFileSync } = await import('fs');
-    const readmePath = join(process.cwd(), '../README.md');
-    if (existsSync(readmePath)) {
-      const readme = readFileSync(readmePath, 'utf-8');
-      if (!readme.toLowerCase().includes('quic')) {
-        throw new Error('README missing QUIC documentation');
-      }
-    }
-  });
-
-  // 8. File Structure Validation
-  console.log('\n📁 File Structure Tests:');
-  await validate('WASM files in correct location', async () => {
-    const files = [
-      'wasm/quic/agentic_flow_quic.js',
-      'wasm/quic/agentic_flow_quic_bg.wasm',
-      'wasm/quic/agentic_flow_quic.d.ts'
-    ];
-
-    for (const file of files) {
-      const filePath = join(process.cwd(), file);
-      if (!existsSync(filePath)) {
-        throw new Error(`Missing WASM file: ${file}`);
-      }
-    }
-  });
-
-  // Rust source check - only relevant in development environment
-  // Skip this test in production/remote install scenarios
-
-  // 9. Type Definitions (check compiled output has types)
-  console.log('\n🔷 TypeScript Type Tests:');
-  await validate('QUIC types available in compiled output', async () => {
-    const { QuicTransport } = await import('../dist/transport/quic.js');
-    const { getQuicConfig } = await import('../dist/config/quic.js');
-
-    // Verify classes/functions are exported
-    if (typeof QuicTransport !== 'function') {
-      throw new Error('QuicTransport class not properly exported');
-    }
-    if (typeof getQuicConfig !== 'function') {
-      throw new Error('getQuicConfig function not properly exported');
-    }
-  });
-
-  // 10. Build Artifacts
-  console.log('\n🔨 Build Artifacts Tests:');
-  await validate('Compiled JS exists', async () => {
-    const jsPath = join(process.cwd(), 'dist/transport/quic.js');
-    if (!existsSync(jsPath)) {
-      throw new Error('Compiled JavaScript not found');
-    }
-  });
-
-  await validate('Type declarations exist', async () => {
-    // Check either .d.ts or that types are in compiled .js
-    const dtsPath = join(process.cwd(), 'dist/transport/quic.d.ts');
-    const jsPath = join(process.cwd(), 'dist/transport/quic.js');
-
-    if (!existsSync(dtsPath) && !existsSync(jsPath)) {
-      throw new Error('No compiled output found');
-    }
-
-    // TypeScript may not generate .d.ts for all builds, but .js is sufficient for runtime
-    if (!existsSync(jsPath)) {
-      throw new Error('Compiled JavaScript not found');
-    }
-  });
-
-  // Summary
-  console.log('\n' + '='.repeat(60));
-  console.log('📊 VALIDATION SUMMARY\n');
-
-  const passed = results.filter(r => r.passed).length;
-  const failed = results.filter(r => !r.passed).length;
-  const total = results.length;
-
-  console.log(`Total Tests: ${total}`);
-  console.log(`✅ Passed: ${passed}`);
-  console.log(`❌ Failed: ${failed}`);
-  console.log(`Success Rate: ${((passed / total) * 100).toFixed(1)}%`);
-
-  if (failed > 0) {
-    console.log('\n❌ Failed Tests:');
-    results.filter(r => !r.passed).forEach(r => {
-      console.log(`  • ${r.test}: ${r.error}`);
-    });
-    process.exit(1);
-  } else {
-    console.log('\n🎉 All QUIC validations passed!');
-    console.log('✅ Ready for remote deployment');
-    process.exit(0);
-  }
-}
-
-main().catch((error) => {
-  console.error('💥 Validation suite failed:', error);
-  process.exit(1);
-});

package/validation/test-quic-integration.ts

@@ -1,243 +0,0 @@
-// QUIC Integration Validation Tests
-import { QuicClient, QuicServer, QuicConnectionPool } from '../src/transport/quic.js';
-import { loadQuicConfig, checkQuicAvailability } from '../src/config/quic.js';
-import { logger } from '../src/utils/logger.js';
-
-interface TestResult {
-  name: string;
-  passed: boolean;
-  error?: string;
-  duration?: number;
-}
-
-const results: TestResult[] = [];
-
-async function runTest(name: string, fn: () => Promise<void>): Promise<void> {
-  const startTime = Date.now();
-  try {
-    await fn();
-    results.push({
-      name,
-      passed: true,
-      duration: Date.now() - startTime
-    });
-    console.log(`✅ ${name} (${Date.now() - startTime}ms)`);
-  } catch (error) {
-    results.push({
-      name,
-      passed: false,
-      error: (error as Error).message,
-      duration: Date.now() - startTime
-    });
-    console.error(`❌ ${name}: ${(error as Error).message}`);
-  }
-}
-
-async function testQuicAvailability(): Promise<void> {
-  const availability = await checkQuicAvailability();
-  if (availability.available) {
-    logger.info('QUIC is available');
-  } else {
-    logger.warn('QUIC is not available', { reason: availability.reason });
-  }
-}
-
-async function testConfigLoading(): Promise<void> {
-  const config = loadQuicConfig({
-    enabled: true,
-    port: 4433,
-    maxConnections: 50
-  });
-
-  if (config.port !== 4433) {
-    throw new Error('Config port mismatch');
-  }
-
-  if (config.maxConnections !== 50) {
-    throw new Error('Config maxConnections mismatch');
-  }
-
-  logger.info('Config loaded successfully', { config });
-}
-
-async function testQuicClientInitialization(): Promise<void> {
-  const client = new QuicClient({
-    serverHost: 'localhost',
-    serverPort: 4433
-  });
-
-  await client.initialize();
-  const stats = client.getStats();
-
-  if (typeof stats.totalConnections !== 'number') {
-    throw new Error('Stats not properly initialized');
-  }
-
-  await client.shutdown();
-  logger.info('Client initialization successful');
-}
-
-async function testQuicServerInitialization(): Promise<void> {
-  const server = new QuicServer({
-    host: '127.0.0.1',
-    port: 14433, // Use non-standard port for testing
-    certPath: './certs/cert.pem',
-    keyPath: './certs/key.pem'
-  });
-
-  await server.initialize();
-  const stats = server.getStats();
-
-  if (typeof stats.totalConnections !== 'number') {
-    throw new Error('Server stats not properly initialized');
-  }
-
-  logger.info('Server initialization successful');
-}
-
-async function testConnectionPool(): Promise<void> {
-  const client = new QuicClient();
-  await client.initialize();
-
-  const pool = new QuicConnectionPool(client, 5);
-
-  // Get connection (should create new)
-  const conn1 = await pool.getConnection('localhost', 4433);
-
-  // Get same connection (should reuse)
-  const conn2 = await pool.getConnection('localhost', 4433);
-
-  if (conn1.id !== conn2.id) {
-    throw new Error('Connection pool not reusing connections');
-  }
-
-  await pool.clear();
-  await client.shutdown();
-
-  logger.info('Connection pool test successful');
-}
-
-async function testConfigValidation(): Promise<void> {
-  try {
-    loadQuicConfig({
-      enabled: true,
-      port: 99999, // Invalid port
-      maxConnections: 100
-    });
-    throw new Error('Should have thrown validation error for invalid port');
-  } catch (error) {
-    if ((error as Error).message.includes('Invalid port')) {
-      logger.info('Config validation working correctly');
-    } else {
-      throw error;
-    }
-  }
-}
-
-async function testHealthCheck(): Promise<void> {
-  const availability = await checkQuicAvailability();
-
-  if (typeof availability.available !== 'boolean') {
-    throw new Error('Health check not returning proper status');
-  }
-
-  logger.info('Health check successful', { availability });
-}
-
-async function testStatsCollection(): Promise<void> {
-  const client = new QuicClient();
-  await client.initialize();
-
-  const stats = client.getStats();
-
-  const requiredFields = [
-    'totalConnections',
-    'activeConnections',
-    'totalStreams',
-    'activeStreams',
-    'bytesReceived',
-    'bytesSent',
-    'packetsLost',
-    'rttMs'
-  ];
-
-  for (const field of requiredFields) {
-    if (!(field in stats)) {
-      throw new Error(`Missing stats field: ${field}`);
-    }
-  }
-
-  await client.shutdown();
-  logger.info('Stats collection successful', { stats });
-}
-
-async function testEnvironmentVariables(): Promise<void> {
-  const originalValue = process.env.AGENTIC_FLOW_ENABLE_QUIC;
-
-  // Test with enabled
-  process.env.AGENTIC_FLOW_ENABLE_QUIC = 'true';
-  let config = loadQuicConfig();
-  if (!config.enabled) {
-    throw new Error('Environment variable not enabling QUIC');
-  }
-
-  // Test with disabled
-  process.env.AGENTIC_FLOW_ENABLE_QUIC = 'false';
-  config = loadQuicConfig();
-  if (config.enabled) {
-    throw new Error('Environment variable not disabling QUIC');
-  }
-
-  // Restore
-  if (originalValue !== undefined) {
-    process.env.AGENTIC_FLOW_ENABLE_QUIC = originalValue;
-  } else {
-    delete process.env.AGENTIC_FLOW_ENABLE_QUIC;
-  }
-
-  logger.info('Environment variable handling successful');
-}
-
-async function main(): Promise<void> {
-  console.log('\n🧪 QUIC Integration Tests\n');
-  console.log('='.repeat(50));
-
-  await runTest('QUIC Availability Check', testQuicAvailability);
-  await runTest('Configuration Loading', testConfigLoading);
-  await runTest('Configuration Validation', testConfigValidation);
-  await runTest('Client Initialization', testQuicClientInitialization);
-  await runTest('Server Initialization', testQuicServerInitialization);
-  await runTest('Connection Pool', testConnectionPool);
-  await runTest('Health Check', testHealthCheck);
-  await runTest('Stats Collection', testStatsCollection);
-  await runTest('Environment Variables', testEnvironmentVariables);
-
-  console.log('\n' + '='.repeat(50));
-  console.log('\n📊 Test Summary:\n');
-
-  const passed = results.filter(r => r.passed).length;
-  const failed = results.filter(r => !r.passed).length;
-  const totalDuration = results.reduce((sum, r) => sum + (r.duration || 0), 0);
-
-  console.log(`Total: ${results.length}`);
-  console.log(`Passed: ${passed}`);
-  console.log(`Failed: ${failed}`);
-  console.log(`Duration: ${totalDuration}ms`);
-
-  if (failed > 0) {
-    console.log('\n❌ Failed Tests:\n');
-    results.filter(r => !r.passed).forEach(r => {
-      console.log(`  • ${r.name}: ${r.error}`);
-    });
-    process.exit(1);
-  } else {
-    console.log('\n✅ All tests passed!\n');
-    process.exit(0);
-  }
-}
-
-// Run tests
-main().catch(error => {
-  console.error('Test suite failed:', error);
-  process.exit(1);
-});

package/validation/test-quic-wasm.ts

@@ -1,94 +0,0 @@
-/**
- * QUIC WASM Integration Test
- *
- * Validates that the QUIC transport WASM module loads correctly
- * and provides the expected API surface.
- */
-
-import { existsSync } from 'fs';
-import { join } from 'path';
-
-async function testQuicWasmIntegration() {
-  console.log('🧪 Testing QUIC WASM Integration...\n');
-
-  try {
-    // Test 1: Load WASM module
-    console.log('1️⃣  Loading WASM module...');
-
-    // Try both production and development paths
-    const prodPath = join(process.cwd(), 'wasm/quic/agentic_flow_quic.js');
-    const devPath = join(process.cwd(), '../crates/agentic-flow-quic/pkg/agentic_flow_quic.js');
-
-    let wasmPath: string;
-    if (existsSync(prodPath)) {
-      wasmPath = prodPath;
-    } else if (existsSync(devPath)) {
-      wasmPath = devPath;
-    } else {
-      throw new Error(`WASM module not found at ${prodPath} or ${devPath}`);
-    }
-
-    console.log(`   Loading from: ${wasmPath}`);
-    const wasm = await import(wasmPath);
-    console.log('   ✅ WASM module loaded successfully');
-
-    // Test 2: Check exports
-    console.log('\n2️⃣  Checking exports...');
-    const requiredExports = [
-      'WasmQuicClient',
-      'createQuicMessage',
-      'defaultConfig'
-    ];
-
-    for (const exportName of requiredExports) {
-      if (wasm[exportName]) {
-        console.log(`   ✅ ${exportName} exported`);
-      } else {
-        throw new Error(`Missing export: ${exportName}`);
-      }
-    }
-
-    // Test 3: Create default config
-    console.log('\n3️⃣  Creating default config...');
-    const config = wasm.defaultConfig();
-    console.log('   ✅ Default config created:', config);
-
-    // Test 4: Create QUIC message
-    console.log('\n4️⃣  Creating QUIC message...');
-    const message = wasm.createQuicMessage(
-      'test-msg-1',
-      'task',
-      new TextEncoder().encode(JSON.stringify({ action: 'test' })),
-      null
-    );
-    console.log('   ✅ QUIC message created:', message);
-
-    console.log('\n✅ All QUIC WASM integration tests passed!\n');
-    console.log('📊 Summary:');
-    console.log('   - WASM module: loaded');
-    console.log('   - Exports: verified');
-    console.log('   - Config creation: working');
-    console.log('   - Message creation: working');
-    console.log('\n⚠️  Note: This WASM build uses stubs. For full QUIC functionality, use native Node.js builds.\n');
-
-    return { success: true };
-
-  } catch (error) {
-    console.error('\n❌ QUIC WASM integration test failed:', error);
-    if (error instanceof Error) {
-      console.error('   Error:', error.message);
-      console.error('   Stack:', error.stack);
-    }
-    return { success: false, error };
-  }
-}
-
-// Run tests
-testQuicWasmIntegration()
-  .then(result => {
-    process.exit(result.success ? 0 : 1);
-  })
-  .catch(err => {
-    console.error('Unexpected error:', err);
-    process.exit(1);
-  });