agentic-flow 1.3.0 → 1.3.1

package/README.md

@@ -6,7 +6,7 @@
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
 [![rUv](https://img.shields.io/badge/by-rUv-purple.svg)](https://github.com/ruvnet/)
 
-**Production-ready AI agent orchestration with 66+ specialized agents, 213 MCP tools, and multi-model routing (Anthropic, OpenRouter, Gemini, ONNX).**
+**Production-ready AI agent orchestration with 66+ specialized agents, 213 MCP tools, and multi-model routing (Anthropic, OpenRouter, Requesty, Gemini, ONNX).**
 
 ---
 
@@ -23,10 +23,10 @@ Extending agent capabilities is effortless. Add custom tools and integrations th
 Define routing rules through flexible policy modes: Strict mode keeps sensitive data offline, Economy mode prefers free models (99% savings), Premium mode uses Anthropic for highest quality, or create custom cost/quality thresholds. The policy defines the rules; the swarm enforces them automatically. Runs local for development, Docker for CI/CD, or Flow Nexus cloud for production scale. Agentic Flow is the framework for autonomous efficiency—one unified runner for every Claude Code agent, self-tuning, self-routing, and built for real-world deployment.
 
 **Key Capabilities:**
-- ✅ **Claude Code Mode** - Run Claude Code with OpenRouter/Gemini/ONNX (85-99% savings)
+- ✅ **Claude Code Mode** - Run Claude Code with OpenRouter/Requesty/Gemini/ONNX (85-99% savings)
 - ✅ **66 Specialized Agents** - Pre-built experts for coding, research, review, testing, DevOps
 - ✅ **213 MCP Tools** - Memory, GitHub, neural networks, sandboxes, workflows, payments
-- ✅ **Multi-Model Router** - Anthropic, OpenRouter (100+ models), Gemini, ONNX (free local)
+- ✅ **Multi-Model Router** - Anthropic, OpenRouter (100+ models), Requesty (300+ models), Gemini, ONNX (free local)
 - ✅ **Cost Optimization** - DeepSeek at $0.14/M tokens vs Claude at $15/M (99% savings)
 
 **Built On:**
@@ -56,6 +56,10 @@ npx agentic-flow --agent coder --task "Build a REST API with authentication"
 export OPENROUTER_API_KEY=sk-or-v1-...
 npx agentic-flow --agent coder --task "Build REST API" --model "meta-llama/llama-3.1-8b-instruct"
 
+# Run with Requesty (300+ models, 95% cost savings)
+export REQUESTY_API_KEY=sk-...
+npx agentic-flow --agent coder --task "Build REST API" --provider requesty
+
 # Run with Gemini (free tier)
 export GOOGLE_GEMINI_API_KEY=AIza...
 npx agentic-flow --agent coder --task "Build REST API" --provider gemini
@@ -129,14 +133,17 @@ Automatically spawns Claude Code with proxy configuration for OpenRouter, Gemini
 ```bash
 # Interactive mode - Opens Claude Code UI with proxy
 npx agentic-flow claude-code --provider openrouter
+npx agentic-flow claude-code --provider requesty
 npx agentic-flow claude-code --provider gemini
 
 # Non-interactive mode - Execute task and exit
 npx agentic-flow claude-code --provider openrouter "Write a Python hello world function"
+npx agentic-flow claude-code --provider requesty "Write a Python hello world function"
 npx agentic-flow claude-code --provider openrouter --model "deepseek/deepseek-chat" "Create REST API"
 
 # Use specific models
 npx agentic-flow claude-code --provider openrouter --model "mistralai/mistral-small"
+npx agentic-flow claude-code --provider requesty --model "openai/gpt-4o-mini"
 npx agentic-flow claude-code --provider gemini --model "gemini-2.0-flash-exp"
 
 # Local ONNX models (100% free, privacy-focused)
@@ -148,6 +155,8 @@ npx agentic-flow claude-code --provider onnx "Analyze this codebase"
 | Provider | Model | Cost/M Tokens | Context | Best For |
 |----------|-------|---------------|---------|----------|
 | OpenRouter | `deepseek/deepseek-chat` (default) | $0.14 | 128k | General tasks, best value |
+| Requesty | `deepseek/deepseek-chat` | $0.14 | 128k | 300+ models, unified API |
+| Requesty | `openai/gpt-4o-mini` | $0.15 | 128k | OpenAI models via Requesty |
 | OpenRouter | `anthropic/claude-3.5-sonnet` | $3.00 | 200k | Highest quality, complex reasoning |
 | OpenRouter | `google/gemini-2.0-flash-exp:free` | FREE | 1M | Development, testing (rate limited) |
 | Gemini | `gemini-2.0-flash-exp` | FREE | 1M | Fast responses, rate limited |
@@ -169,6 +178,9 @@ npx agentic-flow claude-code --provider onnx "Analyze this codebase"
 # OpenRouter (100+ models at 85-99% savings)
 export OPENROUTER_API_KEY=sk-or-v1-...
 
+# Requesty (300+ models, unified access)
+export REQUESTY_API_KEY=sk-...
+
 # Gemini (FREE tier available)
 export GOOGLE_GEMINI_API_KEY=AIza...
 
@@ -1014,11 +1026,49 @@ export HEALTH_PORT=8080                     # Health check port
 # .env file (auto-loaded)
 ANTHROPIC_API_KEY=sk-ant-...
 OPENROUTER_API_KEY=sk-or-v1-...
+REQUESTY_API_KEY=sk-...
 GOOGLE_GEMINI_API_KEY=AIza...
 ENABLE_CLAUDE_FLOW_SDK=true
 COMPLETION_MODEL=deepseek/deepseek-chat-v3.1
 ```
 
+**Requesty Configuration (v1.3.1+)**
+
+Requesty.ai provides unified access to 300+ AI models including OpenAI (GPT-4o, GPT-4o-mini), Anthropic, DeepSeek, Meta, Mistral, and more through a single API key:
+
+```bash
+# Get your API key from https://requesty.ai
+export REQUESTY_API_KEY=sk-...
+
+# Use with agents
+npx agentic-flow --agent coder --task "your task" --provider requesty
+
+# Use with Claude Code
+npx agentic-flow claude-code --provider requesty
+
+# Specify model (default: deepseek/deepseek-chat)
+npx agentic-flow --agent coder --task "task" --provider requesty --model "openai/gpt-4o-mini"
+
+# Enable via environment variable
+export USE_REQUESTY=true
+npx agentic-flow --agent coder --task "your task"
+```
+
+**Supported Requesty Models:**
+- `deepseek/deepseek-chat` (default) - $0.14/M tokens, 128k context, native tools
+- `openai/gpt-4o` - $2.50/M tokens, 128k context, native tools
+- `openai/gpt-4o-mini` - $0.15/M tokens, 128k context, native tools
+- `openai/gpt-4-turbo` - $10/M tokens, 128k context, native tools
+- 300+ other models available
+
+**Features:**
+- ✅ OpenAI-compatible API format
+- ✅ Native tool calling support for GPT-4o, DeepSeek
+- ✅ Automatic max_tokens optimization (capped at 8192)
+- ✅ 95% cost savings vs Anthropic direct API
+- ✅ Full MCP tool integration (all 213 tools)
+- ✅ Works with `--verbose` flag for debugging
+
 ---
 
 ## 📚 Complete Agent List

package/dist/agents/claudeAgent.js

@@ -8,6 +8,9 @@ function getCurrentProvider() {
     if (process.env.PROVIDER === 'gemini' || process.env.USE_GEMINI === 'true') {
         return 'gemini';
     }
+    if (process.env.PROVIDER === 'requesty' || process.env.USE_REQUESTY === 'true') {
+        return 'requesty';
+    }
     if (process.env.PROVIDER === 'openrouter' || process.env.USE_OPENROUTER === 'true') {
         return 'openrouter';
     }
@@ -24,6 +27,12 @@ function getModelForProvider(provider) {
                 apiKey: process.env.GOOGLE_GEMINI_API_KEY || process.env.ANTHROPIC_API_KEY || '',
                 baseURL: process.env.PROXY_URL || undefined
             };
+        case 'requesty':
+            return {
+                model: process.env.COMPLETION_MODEL || 'deepseek/deepseek-chat',
+                apiKey: process.env.REQUESTY_API_KEY || process.env.ANTHROPIC_API_KEY || '',
+                baseURL: process.env.PROXY_URL || undefined
+            };
         case 'openrouter':
             return {
                 model: process.env.COMPLETION_MODEL || 'deepseek/deepseek-chat',
@@ -75,6 +84,15 @@ export async function claudeAgent(agent, input, onStream, modelOverride) {
                 model: finalModel
             });
         }
+        else if (provider === 'requesty' && process.env.REQUESTY_API_KEY) {
+            // Use ANTHROPIC_BASE_URL if already set by CLI (proxy mode)
+            envOverrides.ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY || 'proxy-key';
+            envOverrides.ANTHROPIC_BASE_URL = process.env.ANTHROPIC_BASE_URL || process.env.REQUESTY_PROXY_URL || 'http://localhost:3000';
+            logger.info('Using Requesty proxy', {
+                proxyUrl: envOverrides.ANTHROPIC_BASE_URL,
+                model: finalModel
+            });
+        }
         else if (provider === 'openrouter' && process.env.OPENROUTER_API_KEY) {
             // Use ANTHROPIC_BASE_URL if already set by CLI (proxy mode)
             envOverrides.ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY || 'proxy-key';

package/dist/cli/claude-code-wrapper.js

@@ -43,6 +43,15 @@ function getProxyConfig(provider, customPort) {
                 apiKey: process.env.OPENROUTER_API_KEY || '',
                 requiresProxy: true
             };
+        case 'requesty':
+            return {
+                provider: 'requesty',
+                port,
+                baseUrl,
+                model: process.env.COMPLETION_MODEL || 'deepseek/deepseek-chat',
+                apiKey: process.env.REQUESTY_API_KEY || '',
+                requiresProxy: true
+            };
         case 'gemini':
             return {
                 provider: 'gemini',

package/dist/cli-proxy.js

@@ -25,6 +25,7 @@ function loadEnvRecursive(startPath = process.cwd()) {
 }
 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";
@@ -154,6 +155,7 @@ class AgenticFlowCLI {
         const useONNX = this.shouldUseONNX(options);
         const useOpenRouter = this.shouldUseOpenRouter(options);
         const useGemini = this.shouldUseGemini(options);
+        const useRequesty = this.shouldUseRequesty(options);
         // Debug output for provider selection
         if (options.verbose || process.env.VERBOSE === 'true') {
             console.log('\n🔍 Provider Selection Debug:');
@@ -162,16 +164,22 @@ class AgenticFlowCLI {
             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, or Gemini)
+            // 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);
@@ -184,7 +192,7 @@ class AgenticFlowCLI {
                 console.log('🚀 Using direct Anthropic API...\n');
             }
             // Run agent
-            await this.runAgent(options, useOpenRouter, useGemini, useONNX);
+            await this.runAgent(options, useOpenRouter, useGemini, useONNX, useRequesty);
             logger.info('Execution completed successfully');
             process.exit(0);
         }
@@ -227,14 +235,30 @@ class AgenticFlowCLI {
         }
         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 or Gemini is explicitly requested
+        // 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")
@@ -326,6 +350,46 @@ class AgenticFlowCLI {
         // 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)');
@@ -494,7 +558,7 @@ EXAMPLES:
   claude
 `);
     }
-    async runAgent(options, useOpenRouter, useGemini, useONNX = false) {
+    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) {
@@ -513,12 +577,24 @@ EXAMPLES:
         }
         // 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 && !process.env.ANTHROPIC_API_KEY) {
+        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 requesty    (requires REQUESTY_API_KEY)');
+            console.error('  --provider gemini      (requires GOOGLE_GEMINI_API_KEY)');
+            console.error('  --provider onnx        (free local inference)\n');
+            process.exit(1);
+        }
+        if (!isOnnx && useRequesty && !process.env.REQUESTY_API_KEY) {
+            console.error('\n❌ Error: REQUESTY_API_KEY is required for Requesty\n');
+            console.error('Please set your API key:');
+            console.error('  export REQUESTY_API_KEY=sk-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 gemini      (requires GOOGLE_GEMINI_API_KEY)');
             console.error('  --provider onnx        (free local inference)\n');
             process.exit(1);
@@ -529,6 +605,7 @@ EXAMPLES:
             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 requesty   (requires REQUESTY_API_KEY)');
             console.error('  --provider gemini     (requires GOOGLE_GEMINI_API_KEY)');
             console.error('  --provider onnx       (free local inference)\n');
             process.exit(1);
@@ -665,7 +742,7 @@ AGENT COMMANDS:
 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)
+  --provider, -p <name>       Provider to use (anthropic, openrouter, requesty, gemini, onnx)
   --stream, -s                Enable real-time streaming output
   --help, -h                  Show this help message
 
@@ -712,16 +789,19 @@ EXAMPLES:
 
   # Proxy Server for Claude Code/Cursor
   npx agentic-flow proxy --provider openrouter --port 3000
+  npx agentic-flow proxy --provider requesty --port 3000
   npx agentic-flow proxy --provider gemini --port 3001
 
   # 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 requesty "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 requesty
   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
 
@@ -734,8 +814,10 @@ EXAMPLES:
 ENVIRONMENT VARIABLES:
   ANTHROPIC_API_KEY       Anthropic API key (for Claude models)
   OPENROUTER_API_KEY      OpenRouter API key (for alternative models)
+  REQUESTY_API_KEY        Requesty API key (for Requesty models - 300+ models)
   GOOGLE_GEMINI_API_KEY   Google Gemini API key (for Gemini models)
   USE_OPENROUTER          Set to 'true' to force OpenRouter usage
+  USE_REQUESTY            Set to 'true' to force Requesty usage
   USE_GEMINI              Set to 'true' to force Gemini usage
   COMPLETION_MODEL        Default model for OpenRouter
   AGENTS_DIR              Path to agents directory