agentic-flow 2.0.1 → 2.0.2-alpha

package/dist/cli-proxy.js

@@ -1,1263 +0,0 @@
-#!/usr/bin/env node
-/**
- * Agentic Flow - Standalone CLI with integrated OpenRouter proxy
- * Usage: npx agentic-flow-proxy --agent coder --task "Create code" --openrouter
- */
-import dotenv from "dotenv";
-import { existsSync, readFileSync } from 'fs';
-import { resolve as pathResolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-// Load .env from current directory, or search up the directory tree
-function loadEnvRecursive(startPath = process.cwd()) {
-    let currentPath = startPath;
-    const root = pathResolve('/');
-    while (currentPath !== root) {
-        const envPath = pathResolve(currentPath, '.env');
-        if (existsSync(envPath)) {
-            dotenv.config({ path: envPath });
-            return true;
-        }
-        currentPath = pathResolve(currentPath, '..');
-    }
-    // Fallback to default behavior
-    dotenv.config();
-    return false;
-}
-loadEnvRecursive();
-import { AnthropicToOpenRouterProxy } from "./proxy/anthropic-to-openrouter.js";
-import { AnthropicToRequestyProxy } from "./proxy/anthropic-to-requesty.js";
-import { logger } from "./utils/logger.js";
-import { parseArgs } from "./utils/cli.js";
-import { getAgent, listAgents } from "./utils/agentLoader.js";
-import { claudeAgentDirect } from "./agents/claudeAgentDirect.js";
-import { handleReasoningBankCommand } from "./utils/reasoningbankCommands.js";
-import { handleConfigCommand } from "./cli/config-wizard.js";
-import { handleAgentCommand } from "./cli/agent-manager.js";
-import { handleFederationCommand } from "./cli/federation-cli.js";
-import { handleInitCommand } from "./cli/commands/init.js";
-import { ModelOptimizer } from "./utils/modelOptimizer.js";
-import { detectModelCapabilities } from "./utils/modelCapabilities.js";
-import { AgentBoosterPreprocessor } from "./utils/agentBoosterPreprocessor.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const packageJson = JSON.parse(readFileSync(pathResolve(__dirname, '../package.json'), 'utf-8'));
-const VERSION = packageJson.version;
-class AgenticFlowCLI {
-    proxyServer = null;
-    proxyPort = 3000;
-    async start() {
-        const options = parseArgs();
-        if (options.version) {
-            console.log(`agentic-flow v${VERSION}`);
-            process.exit(0);
-        }
-        if (options.help) {
-            this.printHelp();
-            process.exit(0);
-        }
-        // If no mode and no agent specified, show help
-        if (!options.agent && options.mode !== 'list' && !['init', 'config', 'agent-manager', 'mcp-manager', 'proxy', 'quic', 'claude-code', 'mcp', 'reasoningbank', 'federation', 'hooks', 'workers', 'embeddings'].includes(options.mode)) {
-            this.printHelp();
-            process.exit(0);
-        }
-        if (options.mode === 'init') {
-            // Handle init command - creates .claude/ folder and configuration
-            const initArgs = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'init'
-            await handleInitCommand(initArgs);
-            process.exit(0);
-        }
-        if (options.mode === 'list') {
-            this.listAgents();
-            process.exit(0);
-        }
-        if (options.mode === 'config') {
-            // Handle config wizard
-            const configArgs = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'config'
-            await handleConfigCommand(configArgs);
-            process.exit(0);
-        }
-        if (options.mode === 'agent-manager') {
-            // Handle agent management commands
-            const agentArgs = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'agent'
-            await handleAgentCommand(agentArgs);
-            process.exit(0);
-        }
-        if (options.mode === 'mcp-manager') {
-            // Handle MCP manager commands (add, list, remove, etc.)
-            const { spawn } = await import('child_process');
-            const { resolve, dirname } = await import('path');
-            const { fileURLToPath } = await import('url');
-            const __filename = fileURLToPath(import.meta.url);
-            const __dirname = dirname(__filename);
-            const mcpManagerPath = resolve(__dirname, './cli/mcp-manager.js');
-            // Pass all args after 'mcp' to mcp-manager
-            const mcpArgs = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'mcp'
-            const proc = spawn('node', [mcpManagerPath, ...mcpArgs], {
-                stdio: 'inherit'
-            });
-            proc.on('exit', (code) => {
-                process.exit(code || 0);
-            });
-            process.on('SIGINT', () => proc.kill('SIGINT'));
-            process.on('SIGTERM', () => proc.kill('SIGTERM'));
-            return;
-        }
-        if (options.mode === 'proxy') {
-            // Run standalone proxy server for Claude Code/Cursor
-            await this.runStandaloneProxy();
-            return;
-        }
-        if (options.mode === 'quic') {
-            // Run QUIC transport proxy server
-            await this.runQuicProxy();
-            return;
-        }
-        if (options.mode === 'claude-code') {
-            // Spawn Claude Code with auto-configured proxy
-            const { spawn } = await import('child_process');
-            const claudeCodePath = pathResolve(__dirname, './cli/claude-code-wrapper.js');
-            const proc = spawn('node', [claudeCodePath, ...process.argv.slice(3)], {
-                stdio: 'inherit',
-                env: process.env
-            });
-            proc.on('exit', (code) => {
-                process.exit(code || 0);
-            });
-            process.on('SIGINT', () => proc.kill('SIGINT'));
-            process.on('SIGTERM', () => proc.kill('SIGTERM'));
-            return;
-        }
-        if (options.mode === 'mcp') {
-            // Run standalone MCP server directly
-            const { spawn } = await import('child_process');
-            const { resolve, dirname } = await import('path');
-            const { fileURLToPath } = await import('url');
-            const __filename = fileURLToPath(import.meta.url);
-            const __dirname = dirname(__filename);
-            const serverPath = resolve(__dirname, './mcp/standalone-stdio.js');
-            const proc = spawn('node', [serverPath], {
-                stdio: 'inherit'
-            });
-            proc.on('exit', (code) => {
-                process.exit(code || 0);
-            });
-            // Handle termination signals
-            process.on('SIGINT', () => proc.kill('SIGINT'));
-            process.on('SIGTERM', () => proc.kill('SIGTERM'));
-            return;
-        }
-        if (options.mode === 'reasoningbank') {
-            // Handle ReasoningBank commands
-            const subcommand = process.argv[3] || 'help';
-            await handleReasoningBankCommand(subcommand);
-            process.exit(0);
-        }
-        if (options.mode === 'federation') {
-            // Handle Federation commands
-            const federationArgs = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'federation'
-            await handleFederationCommand(federationArgs);
-            process.exit(0);
-        }
-        if (options.mode === 'hooks') {
-            // Handle Hooks commands (intelligence, init, pre-edit, post-edit, etc.)
-            const { spawn } = await import('child_process');
-            const { resolve, dirname } = await import('path');
-            const { fileURLToPath } = await import('url');
-            const __filename = fileURLToPath(import.meta.url);
-            const __dirname = dirname(__filename);
-            const hooksPath = resolve(__dirname, './cli/commands/hooks.js');
-            // Pass all args after 'hooks' to hooks command
-            const hooksArgs = process.argv.slice(3);
-            const proc = spawn('node', [hooksPath, ...hooksArgs], {
-                stdio: 'inherit'
-            });
-            proc.on('exit', (code) => {
-                process.exit(code || 0);
-            });
-            process.on('SIGINT', () => proc.kill('SIGINT'));
-            process.on('SIGTERM', () => proc.kill('SIGTERM'));
-            return;
-        }
-        if (options.mode === 'workers') {
-            // Handle Workers commands (status, cleanup, dispatch-prompt, etc.)
-            const { spawn } = await import('child_process');
-            const { resolve, dirname } = await import('path');
-            const { fileURLToPath } = await import('url');
-            const __filename = fileURLToPath(import.meta.url);
-            const __dirname = dirname(__filename);
-            const workersPath = resolve(__dirname, './cli/commands/workers.js');
-            // Pass all args after 'workers' to workers command
-            const workersArgs = process.argv.slice(3);
-            const proc = spawn('node', [workersPath, ...workersArgs], {
-                stdio: 'inherit'
-            });
-            proc.on('exit', (code) => {
-                process.exit(code || 0);
-            });
-            process.on('SIGINT', () => proc.kill('SIGINT'));
-            process.on('SIGTERM', () => proc.kill('SIGTERM'));
-            return;
-        }
-        if (options.mode === 'embeddings') {
-            // Handle Embeddings commands (init, download, list, benchmark, status)
-            const { handleEmbeddingsCommand } = await import('./cli/commands/embeddings.js');
-            await handleEmbeddingsCommand(process.argv.slice(3));
-            process.exit(0);
-        }
-        // Apply model optimization if requested
-        if (options.optimize && options.agent && options.task) {
-            const recommendation = ModelOptimizer.optimize({
-                agent: options.agent,
-                task: options.task,
-                priority: options.optimizePriority || 'balanced',
-                maxCostPerTask: options.maxCost,
-                requiresTools: true // Agents have MCP tools available, so require tool support
-            });
-            // Display recommendation
-            ModelOptimizer.displayRecommendation(recommendation);
-            // Apply recommendation to options
-            if (!options.provider || options.optimize) {
-                options.provider = recommendation.provider;
-            }
-            if (!options.model || options.optimize) {
-                options.model = recommendation.model;
-            }
-            console.log(`✅ Using optimized model: ${recommendation.modelName}\n`);
-        }
-        // Determine which provider to use
-        const useONNX = this.shouldUseONNX(options);
-        const useOpenRouter = this.shouldUseOpenRouter(options);
-        const useGemini = this.shouldUseGemini(options);
-        // Requesty temporarily disabled - keep proxy files for future use
-        const useRequesty = false; // this.shouldUseRequesty(options);
-        // Debug output for provider selection
-        if (options.verbose || process.env.VERBOSE === 'true') {
-            console.log('\n🔍 Provider Selection Debug:');
-            console.log(`  Provider flag: ${options.provider || 'not set'}`);
-            console.log(`  Model: ${options.model || 'default'}`);
-            console.log(`  Use ONNX: ${useONNX}`);
-            console.log(`  Use OpenRouter: ${useOpenRouter}`);
-            console.log(`  Use Gemini: ${useGemini}`);
-            console.log(`  Use Requesty: ${useRequesty}`);
-            console.log(`  OPENROUTER_API_KEY: ${process.env.OPENROUTER_API_KEY ? '✓ set' : '✗ not set'}`);
-            console.log(`  GOOGLE_GEMINI_API_KEY: ${process.env.GOOGLE_GEMINI_API_KEY ? '✓ set' : '✗ not set'}`);
-            console.log(`  REQUESTY_API_KEY: ${process.env.REQUESTY_API_KEY ? '✓ set' : '✗ not set'}`);
-            console.log(`  ANTHROPIC_API_KEY: ${process.env.ANTHROPIC_API_KEY ? '✓ set' : '✗ not set'}\n`);
-        }
-        try {
-            // Start proxy if needed (ONNX, OpenRouter, Gemini, or Requesty)
-            if (useONNX) {
-                console.log('🚀 Initializing ONNX local inference proxy...');
-                await this.startONNXProxy(options.model);
-            }
-            else if (useRequesty) {
-                console.log('🚀 Initializing Requesty proxy...');
-                await this.startRequestyProxy(options.model);
-            }
-            else if (useOpenRouter) {
-                console.log('🚀 Initializing OpenRouter proxy...');
-                await this.startOpenRouterProxy(options.model);
-            }
-            else if (useGemini) {
-                console.log('🚀 Initializing Gemini proxy...');
-                // Don't pass Anthropic model names to Gemini proxy
-                const geminiModel = options.model?.startsWith('claude') ? undefined : options.model;
-                console.log(`🔍 Model filtering: options.model=${options.model}, geminiModel=${geminiModel}`);
-                await this.startGeminiProxy(geminiModel);
-            }
-            else {
-                console.log('🚀 Using direct Anthropic API...\n');
-            }
-            // Run agent
-            await this.runAgent(options, useOpenRouter, useGemini, useONNX, useRequesty);
-            logger.info('Execution completed successfully');
-            process.exit(0);
-        }
-        catch (err) {
-            logger.error('Execution failed', { error: err });
-            console.error(err);
-            process.exit(1);
-        }
-    }
-    shouldUseONNX(options) {
-        // Use ONNX if:
-        // 1. Provider is explicitly set to onnx
-        // 2. PROVIDER env var is set to onnx
-        // 3. USE_ONNX env var is set
-        if (options.provider === 'onnx' || process.env.PROVIDER === 'onnx') {
-            return true;
-        }
-        if (process.env.USE_ONNX === 'true') {
-            return true;
-        }
-        return false;
-    }
-    shouldUseGemini(options) {
-        // Use Gemini if:
-        // 1. Provider is explicitly set to gemini
-        // 2. PROVIDER env var is set to gemini
-        // 3. USE_GEMINI env var is set
-        // 4. GOOGLE_GEMINI_API_KEY is set and no other provider is specified
-        if (options.provider === 'gemini' || process.env.PROVIDER === 'gemini') {
-            return true;
-        }
-        if (process.env.USE_GEMINI === 'true') {
-            return true;
-        }
-        // BUG FIX: Don't auto-select Gemini if user explicitly specified a different provider
-        if (options.provider && options.provider !== 'gemini') {
-            return false;
-        }
-        if (process.env.GOOGLE_GEMINI_API_KEY &&
-            !process.env.ANTHROPIC_API_KEY &&
-            !process.env.OPENROUTER_API_KEY &&
-            options.provider !== 'onnx') {
-            return true;
-        }
-        return false;
-    }
-    shouldUseRequesty(options) {
-        // Use Requesty if:
-        // 1. Provider is explicitly set to requesty
-        // 2. PROVIDER env var is set to requesty
-        // 3. USE_REQUESTY env var is set
-        if (options.provider === 'requesty' || process.env.PROVIDER === 'requesty') {
-            return true;
-        }
-        if (process.env.USE_REQUESTY === 'true') {
-            return true;
-        }
-        return false;
-    }
-    shouldUseOpenRouter(options) {
-        // Don't use OpenRouter if ONNX, Gemini, or Requesty is explicitly requested
-        if (options.provider === 'onnx' || process.env.USE_ONNX === 'true' || process.env.PROVIDER === 'onnx') {
-            return false;
-        }
-        if (options.provider === 'gemini' || process.env.PROVIDER === 'gemini') {
-            return false;
-        }
-        if (options.provider === 'requesty' || process.env.PROVIDER === 'requesty') {
-            return false;
-        }
-        // Use OpenRouter if:
-        // 1. Provider is explicitly set to openrouter
-        // 2. Model parameter contains "/" (e.g., "meta-llama/llama-3.1-8b-instruct")
-        // 3. USE_OPENROUTER env var is set
-        // 4. OPENROUTER_API_KEY is set and ANTHROPIC_API_KEY is not
-        if (options.provider === 'openrouter' || process.env.PROVIDER === 'openrouter') {
-            return true;
-        }
-        if (options.model?.includes('/')) {
-            return true;
-        }
-        if (process.env.USE_OPENROUTER === 'true') {
-            return true;
-        }
-        if (process.env.OPENROUTER_API_KEY && !process.env.ANTHROPIC_API_KEY && !process.env.GOOGLE_GEMINI_API_KEY) {
-            return true;
-        }
-        return false;
-    }
-    async startOpenRouterProxy(modelOverride) {
-        const openrouterKey = process.env.OPENROUTER_API_KEY;
-        if (!openrouterKey) {
-            console.error('❌ Error: OPENROUTER_API_KEY required for OpenRouter models');
-            console.error('Set it in .env or export OPENROUTER_API_KEY=sk-or-v1-xxxxx');
-            process.exit(1);
-        }
-        logger.info('Starting integrated OpenRouter proxy');
-        const defaultModel = modelOverride ||
-            process.env.COMPLETION_MODEL ||
-            process.env.REASONING_MODEL ||
-            'deepseek/deepseek-chat';
-        const capabilities = detectModelCapabilities(defaultModel);
-        const proxy = new AnthropicToOpenRouterProxy({
-            openrouterApiKey: openrouterKey,
-            openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,
-            defaultModel,
-            capabilities: capabilities
-        });
-        // Start proxy in background
-        proxy.start(this.proxyPort);
-        this.proxyServer = proxy;
-        // Set ANTHROPIC_BASE_URL to proxy
-        process.env.ANTHROPIC_BASE_URL = `http://localhost:${this.proxyPort}`;
-        // Set dummy ANTHROPIC_API_KEY for proxy (actual auth uses OPENROUTER_API_KEY)
-        if (!process.env.ANTHROPIC_API_KEY) {
-            process.env.ANTHROPIC_API_KEY = 'sk-ant-proxy-dummy-key';
-        }
-        console.log(`🔗 Proxy Mode: OpenRouter`);
-        console.log(`🔧 Proxy URL: http://localhost:${this.proxyPort}`);
-        console.log(`🤖 Default Model: ${defaultModel}`);
-        if (capabilities.requiresEmulation) {
-            console.log(`\n⚙️  Detected: Model lacks native tool support`);
-            console.log(`🔧 Using ${capabilities.emulationStrategy.toUpperCase()} emulation pattern`);
-            console.log(`📊 Expected reliability: ${capabilities.emulationStrategy === 'react' ? '70-85%' : '50-70%'}`);
-        }
-        console.log('');
-        // Wait for proxy to be ready
-        await new Promise(resolve => setTimeout(resolve, 1500));
-    }
-    async startGeminiProxy(modelOverride) {
-        const geminiKey = process.env.GOOGLE_GEMINI_API_KEY;
-        if (!geminiKey) {
-            console.error('❌ Error: GOOGLE_GEMINI_API_KEY required for Gemini models');
-            console.error('Set it in .env or export GOOGLE_GEMINI_API_KEY=xxxxx');
-            process.exit(1);
-        }
-        logger.info('Starting integrated Gemini proxy');
-        // BUG FIX: Don't use COMPLETION_MODEL for Gemini (it contains Anthropic model names)
-        // Always use modelOverride if provided, otherwise default to gemini-2.0-flash-exp
-        console.log(`🔍 Gemini proxy debug: modelOverride=${modelOverride}, COMPLETION_MODEL=${process.env.COMPLETION_MODEL}`);
-        const defaultModel = (modelOverride && !modelOverride.startsWith('claude'))
-            ? modelOverride
-            : 'gemini-2.0-flash-exp';
-        // Import Gemini proxy
-        const { AnthropicToGeminiProxy } = await import('./proxy/anthropic-to-gemini.js');
-        const proxy = new AnthropicToGeminiProxy({
-            geminiApiKey: geminiKey,
-            defaultModel
-        });
-        // Start proxy in background
-        proxy.start(this.proxyPort);
-        this.proxyServer = proxy;
-        // Set ANTHROPIC_BASE_URL to proxy
-        process.env.ANTHROPIC_BASE_URL = `http://localhost:${this.proxyPort}`;
-        // Set dummy ANTHROPIC_API_KEY for proxy (actual auth uses GOOGLE_GEMINI_API_KEY)
-        if (!process.env.ANTHROPIC_API_KEY) {
-            process.env.ANTHROPIC_API_KEY = 'sk-ant-proxy-dummy-key';
-        }
-        console.log(`🔗 Proxy Mode: Google Gemini`);
-        console.log(`🔧 Proxy URL: http://localhost:${this.proxyPort}`);
-        console.log(`🤖 Default Model: ${defaultModel}\n`);
-        // Wait for proxy to be ready
-        await new Promise(resolve => setTimeout(resolve, 1500));
-    }
-    async startRequestyProxy(modelOverride) {
-        const requestyKey = process.env.REQUESTY_API_KEY;
-        if (!requestyKey) {
-            console.error('❌ Error: REQUESTY_API_KEY required for Requesty models');
-            console.error('Set it in .env or export REQUESTY_API_KEY=sk-xxxxx');
-            process.exit(1);
-        }
-        logger.info('Starting integrated Requesty proxy');
-        const defaultModel = modelOverride ||
-            process.env.COMPLETION_MODEL ||
-            process.env.REASONING_MODEL ||
-            'deepseek/deepseek-chat';
-        const capabilities = detectModelCapabilities(defaultModel);
-        const proxy = new AnthropicToRequestyProxy({
-            requestyApiKey: requestyKey,
-            requestyBaseUrl: process.env.REQUESTY_BASE_URL,
-            defaultModel,
-            capabilities: capabilities
-        });
-        // Start proxy in background
-        proxy.start(this.proxyPort);
-        this.proxyServer = proxy;
-        // Set ANTHROPIC_BASE_URL to proxy
-        process.env.ANTHROPIC_BASE_URL = `http://localhost:${this.proxyPort}`;
-        // Set dummy ANTHROPIC_API_KEY for proxy (actual auth uses REQUESTY_API_KEY)
-        if (!process.env.ANTHROPIC_API_KEY) {
-            process.env.ANTHROPIC_API_KEY = 'sk-ant-proxy-dummy-key';
-        }
-        console.log(`🔗 Proxy Mode: Requesty`);
-        console.log(`🔧 Proxy URL: http://localhost:${this.proxyPort}`);
-        console.log(`🤖 Default Model: ${defaultModel}`);
-        if (capabilities.requiresEmulation) {
-            console.log(`\n⚙️  Detected: Model lacks native tool support`);
-            console.log(`🔧 Using ${capabilities.emulationStrategy.toUpperCase()} emulation pattern`);
-            console.log(`📊 Expected reliability: ${capabilities.emulationStrategy === 'react' ? '70-85%' : '50-70%'}`);
-        }
-        console.log('');
-        // Wait for proxy to be ready
-        await new Promise(resolve => setTimeout(resolve, 1500));
-    }
-    async startONNXProxy(modelOverride) {
-        logger.info('Starting integrated ONNX local inference proxy');
-        console.log('🔧 Provider: ONNX Local (Phi-4-mini)');
-        console.log('💾 Free local inference - no API costs\n');
-        // Import ONNX proxy
-        const { AnthropicToONNXProxy } = await import('./proxy/anthropic-to-onnx.js');
-        // Use a different port for ONNX to avoid conflicts
-        const onnxProxyPort = parseInt(process.env.ONNX_PROXY_PORT || '3001');
-        const proxy = new AnthropicToONNXProxy({
-            port: onnxProxyPort,
-            modelPath: process.env.ONNX_MODEL_PATH,
-            executionProviders: process.env.ONNX_EXECUTION_PROVIDERS?.split(',') || ['cpu']
-        });
-        // Start proxy in background
-        await proxy.start();
-        this.proxyServer = proxy;
-        // Set ANTHROPIC_BASE_URL to ONNX proxy
-        process.env.ANTHROPIC_BASE_URL = `http://localhost:${onnxProxyPort}`;
-        // Set dummy ANTHROPIC_API_KEY for proxy (local inference doesn't need key)
-        if (!process.env.ANTHROPIC_API_KEY) {
-            process.env.ANTHROPIC_API_KEY = 'sk-ant-onnx-local-key';
-        }
-        console.log(`🔗 Proxy Mode: ONNX Local Inference`);
-        console.log(`🔧 Proxy URL: http://localhost:${onnxProxyPort}`);
-        console.log(`🤖 Model: Phi-4-mini-instruct (ONNX)\n`);
-        // Wait for proxy to be ready and model to load
-        console.log('⏳ Loading ONNX model... (this may take a moment)\n');
-        await new Promise(resolve => setTimeout(resolve, 2000));
-    }
-    async runStandaloneProxy() {
-        const args = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'proxy'
-        // Parse proxy arguments
-        let provider = 'gemini';
-        let port = 3000;
-        let model;
-        for (let i = 0; i < args.length; i++) {
-            if ((args[i] === '--provider' || args[i] === '-p') && args[i + 1]) {
-                provider = args[++i];
-            }
-            else if ((args[i] === '--port' || args[i] === '-P') && args[i + 1]) {
-                port = parseInt(args[++i]);
-            }
-            else if ((args[i] === '--model' || args[i] === '-m') && args[i + 1]) {
-                model = args[++i];
-            }
-            else if (args[i] === '--help' || args[i] === '-h') {
-                this.printProxyHelp();
-                process.exit(0);
-            }
-        }
-        console.log(`
-╔═══════════════════════════════════════════════════════╗
-║   Agentic Flow - Standalone Anthropic Proxy Server    ║
-╚═══════════════════════════════════════════════════════╝
-`);
-        if (provider === 'gemini') {
-            const apiKey = process.env.GOOGLE_GEMINI_API_KEY;
-            if (!apiKey) {
-                console.error(`❌ Error: GOOGLE_GEMINI_API_KEY environment variable required
-
-Set it with:
-  export GOOGLE_GEMINI_API_KEY=your-key-here
-`);
-                process.exit(1);
-            }
-            const finalModel = model || process.env.COMPLETION_MODEL || 'gemini-2.0-flash-exp';
-            console.log(`🚀 Starting Gemini → Anthropic Proxy
-📍 Port: ${port}
-🤖 Model: ${finalModel}
-🔗 Gemini API: https://generativelanguage.googleapis.com
-`);
-            const { AnthropicToGeminiProxy } = await import('./proxy/anthropic-to-gemini.js');
-            const proxy = new AnthropicToGeminiProxy({
-                geminiApiKey: apiKey,
-                defaultModel: finalModel
-            });
-            proxy.start(port);
-            console.log(`✅ Proxy server running!
-
-Configure Claude Code:
-  export ANTHROPIC_BASE_URL=http://localhost:${port}
-  export ANTHROPIC_API_KEY=sk-ant-proxy-dummy-key
-  claude
-
-Cost Savings: ~85% vs direct Anthropic API
-`);
-        }
-        else if (provider === 'openrouter') {
-            const apiKey = process.env.OPENROUTER_API_KEY;
-            if (!apiKey) {
-                console.error(`❌ Error: OPENROUTER_API_KEY environment variable required
-
-Set it with:
-  export OPENROUTER_API_KEY=sk-or-v1-your-key-here
-
-Get your key at: https://openrouter.ai/keys
-`);
-                process.exit(1);
-            }
-            const finalModel = model || process.env.COMPLETION_MODEL || 'deepseek/deepseek-chat';
-            console.log(`🚀 Starting OpenRouter → Anthropic Proxy
-📍 Port: ${port}
-🤖 Model: ${finalModel}
-🔗 OpenRouter API: https://openrouter.ai/api/v1
-`);
-            const { AnthropicToOpenRouterProxy } = await import('./proxy/anthropic-to-openrouter.js');
-            const proxy = new AnthropicToOpenRouterProxy({
-                openrouterApiKey: apiKey,
-                defaultModel: finalModel
-            });
-            proxy.start(port);
-            console.log(`✅ Proxy server running!
-
-Configure Claude Code:
-  export ANTHROPIC_BASE_URL=http://localhost:${port}
-  export ANTHROPIC_API_KEY=sk-ant-proxy-dummy-key
-  claude
-
-Cost Savings: ~90% vs direct Anthropic API
-Popular Models:
-  - openai/gpt-4o-mini (fast, cheap)
-  - anthropic/claude-3.5-sonnet (via OpenRouter)
-  - meta-llama/llama-3.1-405b-instruct (OSS)
-`);
-        }
-        else {
-            console.error(`❌ Error: Invalid provider "${provider}". Must be "gemini" or "openrouter"`);
-            process.exit(1);
-        }
-        // Keep process running
-        process.on('SIGINT', () => {
-            console.log('\n\n👋 Shutting down proxy server...');
-            process.exit(0);
-        });
-        // Keep alive
-        await new Promise(() => { });
-    }
-    printProxyHelp() {
-        console.log(`
-Agentic Flow - Standalone Anthropic Proxy Server
-
-USAGE:
-  npx agentic-flow proxy [OPTIONS]
-
-OPTIONS:
-  --provider, -p <provider>   Provider (gemini, openrouter) [default: gemini]
-  --port, -P <port>           Port number [default: 3000]
-  --model, -m <model>         Model to use (provider-specific)
-  --help, -h                  Show this help
-
-ENVIRONMENT VARIABLES:
-  GOOGLE_GEMINI_API_KEY       Required for Gemini
-  OPENROUTER_API_KEY          Required for OpenRouter
-  COMPLETION_MODEL            Default model (optional)
-
-EXAMPLES:
-  # Start Gemini proxy
-  npx agentic-flow proxy --provider gemini --port 3000
-
-  # Start OpenRouter proxy with GPT-4o-mini
-  npx agentic-flow proxy --provider openrouter --model "openai/gpt-4o-mini"
-
-  # Use with Claude Code
-  export ANTHROPIC_BASE_URL=http://localhost:3000
-  export ANTHROPIC_API_KEY=sk-ant-proxy-dummy-key
-  claude
-`);
-    }
-    async runQuicProxy() {
-        const args = process.argv.slice(3); // Skip 'node', 'cli-proxy.js', 'quic'
-        // Parse QUIC arguments
-        let port = parseInt(process.env.QUIC_PORT || '4433');
-        let certPath = process.env.QUIC_CERT_PATH;
-        let keyPath = process.env.QUIC_KEY_PATH;
-        for (let i = 0; i < args.length; i++) {
-            if ((args[i] === '--port' || args[i] === '-P') && args[i + 1]) {
-                port = parseInt(args[++i]);
-            }
-            else if ((args[i] === '--cert' || args[i] === '-c') && args[i + 1]) {
-                certPath = args[++i];
-            }
-            else if ((args[i] === '--key' || args[i] === '-k') && args[i + 1]) {
-                keyPath = args[++i];
-            }
-            else if (args[i] === '--help' || args[i] === '-h') {
-                this.printQuicHelp();
-                process.exit(0);
-            }
-        }
-        console.log(`
-╔═══════════════════════════════════════════════════════╗
-║      Agentic Flow - QUIC Transport Proxy Server       ║
-║           Ultra-Low Latency Agent Communication       ║
-╚═══════════════════════════════════════════════════════╝
-`);
-        console.log(`🚀 Starting QUIC Transport Server
-📍 Port: ${port}
-🔐 Protocol: QUIC (UDP-based, TLS 1.3 encrypted)
-⚡ Performance: 50-70% faster than TCP
-`);
-        if (certPath && keyPath) {
-            console.log(`🔒 TLS Certificates:
-   Cert: ${certPath}
-   Key:  ${keyPath}
-`);
-        }
-        else {
-            console.log(`⚠️  Warning: No TLS certificates specified, using development certificates
-   Set QUIC_CERT_PATH and QUIC_KEY_PATH for production use
-`);
-        }
-        // Import and start QUIC proxy
-        const { spawn } = await import('child_process');
-        const { resolve } = await import('path');
-        const { fileURLToPath } = await import('url');
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = dirname(__filename);
-        const quicProxyPath = resolve(__dirname, './proxy/quic-proxy.js');
-        const env = { ...process.env };
-        if (certPath)
-            env.QUIC_CERT_PATH = certPath;
-        if (keyPath)
-            env.QUIC_KEY_PATH = keyPath;
-        env.QUIC_PORT = port.toString();
-        const proc = spawn('node', [quicProxyPath], {
-            stdio: 'inherit',
-            env: env
-        });
-        console.log(`✅ QUIC server running on UDP port ${port}!
-
-Features:
-  • 0-RTT connection establishment
-  • 100+ concurrent streams per connection
-  • Built-in TLS 1.3 encryption
-  • Connection migration support
-  • Automatic packet loss recovery
-
-Use with agents:
-  import { QuicTransport } from 'agentic-flow/transport/quic';
-  const transport = new QuicTransport({ port: ${port} });
-  await transport.connect();
-
-Press Ctrl+C to stop...
-`);
-        proc.on('exit', (code) => {
-            console.log(`\n👋 QUIC server stopped (exit code: ${code})`);
-            process.exit(code || 0);
-        });
-        process.on('SIGINT', () => {
-            console.log('\n\n👋 Shutting down QUIC server...');
-            proc.kill('SIGINT');
-        });
-        process.on('SIGTERM', () => proc.kill('SIGTERM'));
-    }
-    printQuicHelp() {
-        console.log(`
-Agentic Flow - QUIC Transport Proxy Server
-
-USAGE:
-  npx agentic-flow quic [OPTIONS]
-
-OPTIONS:
-  --port, -P <port>           Port number [default: 4433]
-  --cert, -c <path>           TLS certificate path
-  --key, -k <path>            TLS private key path
-  --help, -h                  Show this help
-
-ENVIRONMENT VARIABLES:
-  QUIC_PORT                   QUIC server port (default: 4433)
-  QUIC_CERT_PATH              Path to TLS certificate
-  QUIC_KEY_PATH               Path to TLS private key
-
-EXAMPLES:
-  # Start QUIC server (development mode)
-  npx agentic-flow quic
-
-  # Start with custom port
-  npx agentic-flow quic --port 5443
-
-  # Start with production certificates
-  npx agentic-flow quic --cert ./certs/cert.pem --key ./certs/key.pem
-
-  # Use via npm scripts
-  npm run proxy:quic         # Start QUIC proxy
-  npm run test:quic:wasm     # Test WASM bindings
-
-PROGRAMMATIC USAGE:
-  import { QuicTransport } from 'agentic-flow/transport/quic';
-
-  const transport = new QuicTransport({
-    host: 'localhost',
-    port: 4433,
-    maxConcurrentStreams: 100
-  });
-
-  await transport.connect();
-  await transport.send({ type: 'task', data: { ... } });
-
-PERFORMANCE:
-  • 50-70% faster than TCP-based protocols
-  • 0-RTT reconnection (instant resume)
-  • 100+ concurrent streams per connection
-  • Built-in TLS 1.3 encryption
-  • Survives network changes (WiFi ↔ cellular)
-`);
-    }
-    async runAgent(options, useOpenRouter, useGemini, useONNX = false, useRequesty = false) {
-        const agentName = options.agent || process.env.AGENT || '';
-        const task = options.task || process.env.TASK || '';
-        if (!agentName) {
-            console.error('❌ Error: --agent required');
-            this.printHelp();
-            process.exit(1);
-        }
-        if (!task) {
-            console.error('❌ Error: --task required');
-            this.printHelp();
-            process.exit(1);
-        }
-        // Set PROVIDER environment variable if --provider flag is used
-        if (options.provider) {
-            process.env.PROVIDER = options.provider;
-        }
-        // Check for API key (unless using ONNX)
-        const isOnnx = options.provider === 'onnx' || process.env.USE_ONNX === 'true' || process.env.PROVIDER === 'onnx';
-        if (!isOnnx && !useOpenRouter && !useGemini && !useRequesty && !process.env.ANTHROPIC_API_KEY) {
-            console.error('\n❌ Error: ANTHROPIC_API_KEY is required\n');
-            console.error('Please set your API key:');
-            console.error('  export ANTHROPIC_API_KEY=sk-ant-xxxxx\n');
-            console.error('Or use alternative providers:');
-            console.error('  --provider openrouter  (requires OPENROUTER_API_KEY)');
-            console.error('  --provider gemini      (requires GOOGLE_GEMINI_API_KEY)');
-            console.error('  --provider onnx        (free local inference)\n');
-            process.exit(1);
-        }
-        if (!isOnnx && useOpenRouter && !process.env.OPENROUTER_API_KEY) {
-            console.error('\n❌ Error: OPENROUTER_API_KEY is required for OpenRouter\n');
-            console.error('Please set your API key:');
-            console.error('  export OPENROUTER_API_KEY=sk-or-v1-xxxxx\n');
-            console.error('Or use alternative providers:');
-            console.error('  --provider anthropic  (requires ANTHROPIC_API_KEY)');
-            console.error('  --provider gemini     (requires GOOGLE_GEMINI_API_KEY)');
-            console.error('  --provider onnx       (free local inference)\n');
-            process.exit(1);
-        }
-        if (!isOnnx && useGemini && !process.env.GOOGLE_GEMINI_API_KEY) {
-            console.error('\n❌ Error: GOOGLE_GEMINI_API_KEY is required for Gemini\n');
-            console.error('Please set your API key:');
-            console.error('  export GOOGLE_GEMINI_API_KEY=xxxxx\n');
-            console.error('Or use alternative providers:');
-            console.error('  --provider anthropic   (requires ANTHROPIC_API_KEY)');
-            console.error('  --provider openrouter  (requires OPENROUTER_API_KEY)');
-            console.error('  --provider onnx        (free local inference)\n');
-            process.exit(1);
-        }
-        const agent = getAgent(agentName);
-        if (!agent) {
-            const available = listAgents();
-            console.error(`\n❌ Agent '${agentName}' not found.\n`);
-            console.error('Available agents:');
-            available.slice(0, 20).forEach(a => {
-                console.error(`  • ${a.name}: ${a.description.substring(0, 80)}...`);
-            });
-            if (available.length > 20) {
-                console.error(`  ... and ${available.length - 20} more (use --list to see all)`);
-            }
-            process.exit(1);
-        }
-        console.log(`\n🤖 Agent: ${agent.name}`);
-        console.log(`📝 Description: ${agent.description}\n`);
-        console.log(`🎯 Task: ${task}\n`);
-        if (useOpenRouter) {
-            const model = options.model || process.env.COMPLETION_MODEL || 'deepseek/deepseek-chat';
-            console.log(`🔧 Provider: OpenRouter (via proxy)`);
-            console.log(`🔧 Model: ${model}`);
-            // Show tool capability information
-            const capabilities = detectModelCapabilities(model);
-            if (capabilities.requiresEmulation) {
-                console.log(`⚙️  Tool Emulation: ${capabilities.emulationStrategy.toUpperCase()} pattern`);
-                console.log(`📊 Note: This model uses prompt-based tool emulation`);
-                console.log(`   Tools are handled by Claude Agent SDK (limited to SDK tools)`);
-            }
-            console.log('');
-        }
-        else if (useGemini) {
-            const model = options.model || 'gemini-2.0-flash-exp';
-            console.log(`🔧 Provider: Google Gemini`);
-            console.log(`🔧 Model: ${model}\n`);
-        }
-        else if (options.provider === 'onnx' || process.env.USE_ONNX === 'true' || process.env.PROVIDER === 'onnx') {
-            console.log(`🔧 Provider: ONNX Local (Phi-4-mini)`);
-            console.log(`💾 Free local inference - no API costs`);
-            if (process.env.ONNX_OPTIMIZED === 'true') {
-                console.log(`⚡ Optimizations: Context pruning, prompt optimization`);
-            }
-            console.log('');
-        }
-        console.log('⏳ Running...\n');
-        // Try Agent Booster pre-processing if enabled
-        if (options.agentBooster || process.env.AGENTIC_FLOW_AGENT_BOOSTER === 'true') {
-            const preprocessor = new AgentBoosterPreprocessor({
-                confidenceThreshold: options.boosterThreshold || parseFloat(process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD || '0.7')
-            });
-            console.log('⚡ Agent Booster: Analyzing task for pattern matching opportunities...\n');
-            const intent = preprocessor.detectIntent(task);
-            if (intent) {
-                console.log(`🎯 Detected intent: ${intent.type}`);
-                if (intent.filePath) {
-                    console.log(`📄 Target file: ${intent.filePath}`);
-                }
-                console.log('🔧 Attempting Agent Booster pre-processing...\n');
-                const result = await preprocessor.tryApply(intent);
-                if (result.success) {
-                    console.log(`✅ Agent Booster Success!\n`);
-                    console.log(`⚡ Method: ${result.method}`);
-                    console.log(`⏱️  Latency: ${result.latency}ms`);
-                    console.log(`🎯 Confidence: ${((result.confidence || 0) * 100).toFixed(1)}%`);
-                    console.log(`📊 Strategy: ${result.strategy}`);
-                    console.log(`\n✅ File updated successfully!\n`);
-                    console.log('═══════════════════════════════════════\n');
-                    console.log(result.output || 'Edit applied');
-                    console.log('\n═══════════════════════════════════════\n');
-                    logger.info('Agent Booster completed', {
-                        agent: agentName,
-                        latency: result.latency,
-                        confidence: result.confidence,
-                        strategy: result.strategy
-                    });
-                    return; // Skip LLM execution
-                }
-                else {
-                    console.log(`⚠️  Agent Booster: ${result.reason || 'Low confidence'}`);
-                    console.log(`🔄 Falling back to LLM agent...\n`);
-                }
-            }
-            else {
-                console.log('ℹ️  No code editing pattern detected, using LLM agent...\n');
-            }
-        }
-        const streamHandler = options.stream ? (chunk) => process.stdout.write(chunk) : undefined;
-        // FIXED: Use claudeAgentDirect (no Claude Code dependency) instead of claudeAgent
-        // This allows agentic-flow to work standalone in Docker/CI/CD without Claude Code
-        // BUG FIX: Don't pass Anthropic model names to non-Anthropic providers
-        const modelForAgent = useGemini || useOpenRouter || useONNX || useRequesty
-            ? (options.model?.startsWith('claude') ? undefined : options.model)
-            : options.model;
-        const result = await claudeAgentDirect(agent, task, streamHandler, modelForAgent);
-        if (!options.stream) {
-            console.log('\n✅ Completed!\n');
-            console.log('═══════════════════════════════════════\n');
-            console.log(result.output);
-            console.log('\n═══════════════════════════════════════\n');
-        }
-        logger.info('Agent completed', {
-            agent: agentName,
-            outputLength: result.output.length,
-            provider: useOpenRouter ? 'openrouter' : useGemini ? 'gemini' : 'anthropic'
-        });
-    }
-    listAgents() {
-        const agents = listAgents();
-        console.log(`\n📦 Available Agents (${agents.length} total)\n`);
-        const grouped = new Map();
-        agents.forEach(agent => {
-            const parts = agent.filePath.split('/');
-            const category = parts[parts.length - 2] || 'other';
-            if (!grouped.has(category)) {
-                grouped.set(category, []);
-            }
-            grouped.get(category).push(agent);
-        });
-        Array.from(grouped.entries())
-            .sort(([a], [b]) => a.localeCompare(b))
-            .forEach(([category, categoryAgents]) => {
-            console.log(`\n${category.toUpperCase()}:`);
-            categoryAgents.forEach(agent => {
-                console.log(`  ${agent.name.padEnd(30)} ${agent.description.substring(0, 80)}`);
-            });
-        });
-        console.log(`\nUsage:`);
-        console.log(`  npx agentic-flow --agent <name> --task "Your task"\n`);
-    }
-    printHelp() {
-        console.log(`
-🤖 Agentic Flow v${VERSION} - AI Agent Orchestration with Multi-Provider Support
-
-NEW IN v1.9.4: Enterprise provider fallback & dynamic switching for long-running agents
-✅ Automatic failover  ✅ Circuit breaker  ✅ Cost optimization  ✅ Health monitoring
-
-USAGE:
-  npx agentic-flow [COMMAND] [OPTIONS]
-
-COMMANDS:
-  init [options]          Initialize project with .claude/ folder and configuration
-  config [subcommand]     Manage environment configuration (interactive wizard)
-  mcp <command> [server]  Manage MCP servers (start, stop, status, list)
-  agent <command>         Agent management (list, create, info, conflicts)
-  federation <command>    Federation hub management (start, spawn, stats, test)
-  proxy [options]         Run standalone proxy server for Claude Code/Cursor
-  quic [options]          Run QUIC transport proxy for ultra-low latency (50-70% faster)
-  claude-code [options]   Spawn Claude Code with auto-configured proxy
-  --list, -l              List all available agents
-  --agent, -a <name>      Run specific agent mode
-
-CONFIG COMMANDS:
-  npx agentic-flow config              # Interactive wizard
-  npx agentic-flow config set KEY VAL  # Set configuration value
-  npx agentic-flow config get KEY      # Get configuration value
-  npx agentic-flow config list         # List all configuration
-  npx agentic-flow config delete KEY   # Delete configuration value
-  npx agentic-flow config reset        # Reset to defaults
-
-MCP COMMANDS:
-  npx agentic-flow mcp start [server]    Start MCP server(s)
-  npx agentic-flow mcp stop [server]     Stop MCP server(s)
-  npx agentic-flow mcp status [server]   Check MCP server status
-  npx agentic-flow mcp list              List all available MCP tools
-
-  Available servers: claude-flow, flow-nexus, agentic-payments, all (default)
-
-AGENT COMMANDS:
-  npx agentic-flow agent list [format]   List all agents (summary/detailed/json)
-  npx agentic-flow agent create          Create new custom agent (interactive)
-  npx agentic-flow agent info <name>     Show detailed agent information
-  npx agentic-flow agent conflicts       Check for package/local conflicts
-
-FEDERATION COMMANDS:
-  npx agentic-flow federation start      Start federation hub server
-  npx agentic-flow federation spawn      Spawn ephemeral agent
-  npx agentic-flow federation stats      Show hub statistics
-  npx agentic-flow federation status     Show federation system status
-  npx agentic-flow federation test       Run multi-agent collaboration test
-  npx agentic-flow federation help       Show federation help
-
-  Federation enables ephemeral agents (5s-15min lifetime) with persistent memory.
-  Hub stores memories permanently; agents access past learnings from dead agents.
-
-EMBEDDINGS COMMANDS:
-  npx agentic-flow embeddings init       Download and initialize embeddings (default: all-MiniLM-L6-v2)
-  npx agentic-flow embeddings download   Download a specific model
-  npx agentic-flow embeddings list       List available embedding models
-  npx agentic-flow embeddings benchmark  Run embedding performance benchmarks
-  npx agentic-flow embeddings status     Show embeddings system status
-
-  Optimized ONNX embeddings with LRU cache, SIMD operations, and 150x faster search.
-
-HOOKS COMMANDS:
-  npx agentic-flow hooks                 Show all hook commands
-  npx agentic-flow hooks pre-edit        Get context before editing a file
-  npx agentic-flow hooks post-edit       Record edit outcome for learning
-  npx agentic-flow hooks route           Route task to optimal agent
-  npx agentic-flow hooks pretrain        Analyze repository to bootstrap intelligence
-  npx agentic-flow hooks build-agents    Generate optimized agent configurations
-  npx agentic-flow hooks metrics         View learning metrics dashboard
-  npx agentic-flow hooks intelligence    RuVector intelligence commands (SONA + MoE + HNSW)
-  npx agentic-flow hooks init            Initialize hooks in project
-
-  Self-learning hooks for intelligent agent routing and optimization.
-
-WORKERS COMMANDS:
-  npx agentic-flow workers               Show all worker commands
-  npx agentic-flow workers dispatch      Dispatch background workers from triggers
-  npx agentic-flow workers status        Get worker status
-  npx agentic-flow workers triggers      List available trigger keywords
-  npx agentic-flow workers stats         Get worker statistics
-  npx agentic-flow workers results       View worker analysis results
-  npx agentic-flow workers benchmark     Run worker performance benchmarks
-  npx agentic-flow workers native        Run native ruvector workers
-
-  Background workers for non-blocking analysis tasks.
-
-OPTIONS:
-  --task, -t <task>           Task description for agent mode
-  --model, -m <model>         Model to use (triggers OpenRouter if contains "/")
-  --provider, -p <name>       Provider to use (anthropic, openrouter, gemini, onnx)
-  --stream, -s                Enable real-time streaming output
-  --help, -h                  Show this help message
-
-  API CONFIGURATION:
-  --anthropic-key <key>       Override ANTHROPIC_API_KEY environment variable
-  --openrouter-key <key>      Override OPENROUTER_API_KEY environment variable
-  --gemini-key <key>          Override GOOGLE_GEMINI_API_KEY environment variable
-
-  AGENT BEHAVIOR:
-  --temperature <0.0-1.0>     Sampling temperature (creativity control)
-  --max-tokens <number>       Maximum tokens in response
-
-  DIRECTORY:
-  --agents-dir <path>         Custom agents directory (default: .claude/agents)
-
-  OUTPUT:
-  --output <text|json|md>     Output format (text/json/markdown)
-  --verbose                   Enable verbose logging for debugging
-
-  EXECUTION:
-  --timeout <ms>              Execution timeout in milliseconds
-  --retry                     Auto-retry on transient errors
-
-  MODEL OPTIMIZATION (NEW!):
-  --optimize, -O              Auto-select best model for agent/task based on priorities
-  --priority <type>           Optimization priority:
-                              • quality   - Best results (Claude Sonnet 4.5, GPT-4o)
-                              • balanced  - Mix quality/cost (DeepSeek R1, Gemini 2.5 Flash) [default]
-                              • cost      - Cheapest (DeepSeek Chat V3, Llama 3.1 8B)
-                              • speed     - Fastest responses (Gemini 2.5 Flash)
-                              • privacy   - Local only (ONNX Phi-4, no cloud)
-  --max-cost <dollars>        Maximum cost per task (e.g., 0.001 = $0.001/task budget cap)
-
-  Optimization analyzes agent type + task complexity to recommend best model.
-  Example savings: DeepSeek R1 costs 85% less than Claude Sonnet 4.5 with similar quality.
-  See docs/agentic-flow/benchmarks/MODEL_CAPABILITIES.md for full comparison.
-
-PROVIDER FALLBACK (NEW v1.9.4):
-  Enterprise-grade provider fallback for long-running agents with automatic failover,
-  circuit breaker, health monitoring, cost tracking, and crash recovery.
-
-  Features:
-  • Automatic failover between providers (Gemini → Claude → ONNX)
-  • Circuit breaker prevents cascading failures (auto-recovery after timeout)
-  • Real-time health monitoring (success rate, latency, error tracking)
-  • Cost optimization (70% savings using Gemini for simple tasks)
-  • Checkpointing for crash recovery (save/restore agent state)
-  • Budget controls (hard limits on spending and runtime)
-
-  See: docs/PROVIDER-FALLBACK-GUIDE.md for complete documentation
-  Example: src/examples/use-provider-fallback.ts
-
-EXAMPLES:
-  # MCP Server Management
-  npx agentic-flow mcp start              # Start all MCP servers
-  npx agentic-flow mcp start claude-flow  # Start specific server
-  npx agentic-flow mcp list               # List all 203+ MCP tools
-  npx agentic-flow mcp status             # Check server status
-
-  # Federation Hub Management
-  npx agentic-flow federation start       # Start hub server (WebSocket)
-  npx agentic-flow federation start --port 9443 --db-path ./data/hub.db
-  npx agentic-flow federation spawn       # Spawn ephemeral agent
-  npx agentic-flow federation spawn --tenant acme-corp --lifetime 600
-  npx agentic-flow federation stats       # Show hub statistics
-  npx agentic-flow federation test        # Run multi-agent test
-
-  # Proxy Server for Claude Code/Cursor
-  npx agentic-flow proxy --provider openrouter --port 3000
-  npx agentic-flow proxy --provider gemini --port 3001
-
-  # QUIC Transport (Ultra-low latency, 50-70% faster than TCP)
-  npx agentic-flow quic --port 4433                    # Start QUIC server
-  npx agentic-flow quic --cert ./certs/cert.pem --key ./certs/key.pem
-  npm run proxy:quic                                    # Development mode
-  npm run test:quic:wasm                                # Test WASM bindings
-
-  # Claude Code Integration (Auto-start proxy + spawn Claude Code)
-  npx agentic-flow claude-code --provider openrouter "Write a Python function"
-  npx agentic-flow claude-code --provider gemini "Create a REST API"
-  npx agentic-flow claude-code --provider anthropic "Help me debug this code"
-
-  # Agent Execution
-  npx agentic-flow --list                 # List all 150+ agents
-  npx agentic-flow --agent coder --task "Create Python hello world"
-  npx agentic-flow --agent coder --task "Create REST API" --provider openrouter
-  npx agentic-flow --agent coder --task "Create REST API" --model "meta-llama/llama-3.1-8b-instruct"
-  npx agentic-flow --agent coder --task "Create code" --provider onnx
-
-  # Model Optimization (Auto-select best model)
-  npx agentic-flow --agent coder --task "Build API" --optimize
-  npx agentic-flow --agent coder --task "Build API" --optimize --priority cost
-  npx agentic-flow --agent reviewer --task "Security audit" --optimize --priority quality
-  npx agentic-flow --agent coder --task "Simple function" --optimize --max-cost 0.001
-
-ENVIRONMENT VARIABLES:
-  ANTHROPIC_API_KEY       Anthropic API key (for Claude models)
-  OPENROUTER_API_KEY      OpenRouter API key (for alternative models)
-  GOOGLE_GEMINI_API_KEY   Google Gemini API key (for Gemini models)
-  USE_OPENROUTER          Set to 'true' to force OpenRouter usage
-  USE_GEMINI              Set to 'true' to force Gemini usage
-  COMPLETION_MODEL        Default model for OpenRouter
-  AGENTS_DIR              Path to agents directory
-  PROXY_PORT              Proxy server port (default: 3000)
-  QUIC_PORT               QUIC transport port (default: 4433)
-  QUIC_CERT_PATH          Path to TLS certificate for QUIC
-  QUIC_KEY_PATH           Path to TLS private key for QUIC
-
-OPENROUTER MODELS (Best Free Tested):
-  ✅ deepseek/deepseek-r1-0528:free           (reasoning, 95s/task, RFC validation)
-  ✅ deepseek/deepseek-chat-v3.1:free         (coding, 21-103s/task, enterprise-grade)
-  ✅ meta-llama/llama-3.3-8b-instruct:free    (versatile, 4.4s/task, fast coding)
-  ✅ openai/gpt-4-turbo                       (premium, 10.7s/task, no :free needed)
-
-  All models above support OpenRouter leaderboard tracking via HTTP-Referer headers.
-  See https://openrouter.ai/models for full model catalog.
-
-MCP TOOLS (213+ available):
-  • agentic-flow: 7 tools (agent execution, creation, management, model optimization)
-  • claude-flow: 101 tools (neural networks, GitHub, workflows, DAA)
-  • flow-nexus: 96 cloud tools (sandboxes, distributed swarms, templates)
-  • agentic-payments: 6 tools (payment authorization, multi-agent consensus)
-
-OPTIMIZATION BENEFITS:
-  💰 Cost Savings: 85-98% cheaper models for same quality tasks
-  🎯 Smart Selection: Agent-aware (coder needs quality ≥85, researcher flexible)
-  📊 10+ Models: Claude, GPT-4o, Gemini, DeepSeek, Llama, ONNX local
-  ⚡ Zero Overhead: <5ms decision time, no API calls during optimization
-
-TWO WAYS TO USE AGENTIC-FLOW:
-
-  1️⃣  DIRECT AGENT EXECUTION (agentic-flow agents)
-      Run agents directly in your terminal with full control:
-
-      npx agentic-flow --agent coder --task "Create Python script"
-      npx agentic-flow --agent researcher --task "Research AI trends"
-
-      This runs agentic-flow's 80+ specialized agents directly.
-
-  2️⃣  CLAUDE CODE INTEGRATION (proxy for Claude Code CLI)
-      Use Claude Code CLI with OpenRouter/Gemini models via proxy:
-
-      # Option A: Auto-spawn Claude Code with proxy (easiest)
-      npx agentic-flow claude-code --provider openrouter "Build API"
-
-      # Option B: Manual proxy setup (advanced)
-      Terminal 1 - Start Proxy:
-        npx agentic-flow proxy --provider openrouter
-
-      Terminal 2 - Configure Claude Code:
-        export ANTHROPIC_BASE_URL="http://localhost:3000"
-        export ANTHROPIC_API_KEY="sk-ant-proxy-dummy-key"
-        export OPENROUTER_API_KEY="sk-or-v1-xxxxx"
-        claude  # Now uses OpenRouter via proxy
-
-  Benefits of proxy mode:
-  • 85-99% cost savings vs Claude Sonnet 4.5
-  • Access to 100+ models (DeepSeek, Llama, Gemini, etc.)
-  • Leaderboard tracking on OpenRouter
-  • No code changes to Claude Code itself
-
-QUIC TRANSPORT (Ultra-Low Latency Agent Communication):
-  QUIC is a UDP-based protocol offering 50-70% faster connections than TCP.
-
-  Performance Benefits:
-  • 0-RTT connection establishment - Instant reconnection without handshake delay
-  • Stream multiplexing - Send 100+ concurrent messages without blocking
-  • Built-in TLS 1.3 security - Encrypted by default
-  • Connection migration - Survives network changes (WiFi → cellular)
-  • Reduced latency - Perfect for real-time agent coordination
-
-  Programmatic Usage (API):
-    import { QuicTransport } from 'agentic-flow/transport/quic';
-
-    const transport = new QuicTransport({
-      host: 'localhost',
-      port: 4433,
-      maxConcurrentStreams: 100
-    });
-
-    await transport.connect();
-    await transport.send({ type: 'task', data: { ... } });
-
-  CLI Usage:
-    # Start QUIC server
-    npx agentic-flow quic --port 4433
-
-    # With custom certificates
-    npx agentic-flow quic --cert ./certs/cert.pem --key ./certs/key.pem
-
-    # Test WASM bindings
-    npm run test:quic:wasm
-
-    # Development mode
-    npm run proxy:quic:dev
-
-  Use Cases:
-  • Multi-agent swarm coordination (mesh/hierarchical topologies)
-  • High-frequency task distribution across worker agents
-  • Real-time state synchronization between agents
-  • Low-latency RPC for distributed agent systems
-
-DOCUMENTATION:
-  https://github.com/ruvnet/agentic-flow
-  https://ruv.io
-    `);
-    }
-}
-// Run CLI
-const cli = new AgenticFlowCLI();
-cli.start();
-//# sourceMappingURL=cli-proxy.js.map