agentic-flow 1.1.6 → 1.1.8

package/dist/agents/claudeAgent.js

@@ -38,9 +38,10 @@ function getModelForProvider(provider) {
             };
         case 'anthropic':
         default:
+            // For anthropic provider, require ANTHROPIC_API_KEY
             const apiKey = process.env.ANTHROPIC_API_KEY;
             if (!apiKey) {
-                throw new Error('ANTHROPIC_API_KEY is required but not set');
+                throw new Error('ANTHROPIC_API_KEY is required but not set for Anthropic provider');
             }
             return {
                 model: process.env.COMPLETION_MODEL || 'claude-sonnet-4-5-20250929',
@@ -62,59 +63,118 @@ export async function claudeAgent(agent, input, onStream, modelOverride) {
         // Get model configuration for the selected provider
         const modelConfig = getModelForProvider(provider);
         const finalModel = modelOverride || modelConfig.model;
-        // Set environment variables for the SDK to use correct provider
-        // The SDK reads ANTHROPIC_API_KEY by default, so we set it based on provider
-        const originalApiKey = process.env.ANTHROPIC_API_KEY;
-        if (modelConfig.apiKey && modelConfig.apiKey !== 'local') {
-            process.env.ANTHROPIC_API_KEY = modelConfig.apiKey;
+        // Configure environment for Claude Agent SDK with proxy routing
+        // The SDK internally uses Anthropic client which reads ANTHROPIC_BASE_URL and ANTHROPIC_API_KEY
+        const envOverrides = {};
+        if (provider === 'gemini' && process.env.GOOGLE_GEMINI_API_KEY) {
+            // For Gemini: Route through translation proxy
+            // Proxy runs on port 3001 and translates Anthropic API → Gemini API
+            envOverrides.ANTHROPIC_API_KEY = 'proxy-key'; // Proxy handles real auth
+            envOverrides.ANTHROPIC_BASE_URL = process.env.GEMINI_PROXY_URL || 'http://localhost:3001';
+            logger.info('Using Gemini proxy', {
+                proxyUrl: envOverrides.ANTHROPIC_BASE_URL,
+                model: finalModel
+            });
+        }
+        else if (provider === 'openrouter' && process.env.OPENROUTER_API_KEY) {
+            // For OpenRouter: Route through translation proxy
+            // Proxy runs on port 3000 and translates Anthropic API → OpenRouter API
+            envOverrides.ANTHROPIC_API_KEY = 'proxy-key'; // Proxy handles real auth
+            envOverrides.ANTHROPIC_BASE_URL = process.env.OPENROUTER_PROXY_URL || 'http://localhost:3000';
+            logger.info('Using OpenRouter proxy', {
+                proxyUrl: envOverrides.ANTHROPIC_BASE_URL,
+                model: finalModel
+            });
+        }
+        else if (provider === 'onnx') {
+            // For ONNX: Local inference (TODO: implement ONNX proxy)
+            envOverrides.ANTHROPIC_API_KEY = 'local';
+            if (modelConfig.baseURL) {
+                envOverrides.ANTHROPIC_BASE_URL = modelConfig.baseURL;
+            }
         }
+        // For Anthropic provider, use existing ANTHROPIC_API_KEY (no proxy needed)
         logger.info('Multi-provider configuration', {
             provider,
             model: finalModel,
-            usingRouter: provider !== 'anthropic'
+            hasApiKey: !!envOverrides.ANTHROPIC_API_KEY || !!process.env.ANTHROPIC_API_KEY,
+            hasBaseURL: !!envOverrides.ANTHROPIC_BASE_URL
         });
         try {
-            // Quad MCP server setup: in-SDK + claude-flow + flow-nexus + agentic-payments
+            // MCP server setup - enable in-SDK server and optional external servers
+            const mcpServers = {};
+            // Enable in-SDK MCP server for custom tools
+            if (process.env.ENABLE_CLAUDE_FLOW_SDK === 'true') {
+                mcpServers['claude-flow-sdk'] = claudeFlowSdkServer;
+            }
+            // Optional external MCP servers (disabled by default to avoid subprocess failures)
+            // Enable by setting ENABLE_CLAUDE_FLOW_MCP=true or ENABLE_FLOW_NEXUS_MCP=true
+            if (process.env.ENABLE_CLAUDE_FLOW_MCP === 'true') {
+                mcpServers['claude-flow'] = {
+                    type: 'stdio',
+                    command: 'npx',
+                    args: ['claude-flow@alpha', 'mcp', 'start'],
+                    env: {
+                        ...process.env,
+                        MCP_AUTO_START: 'true',
+                        PROVIDER: provider
+                    }
+                };
+            }
+            if (process.env.ENABLE_FLOW_NEXUS_MCP === 'true') {
+                mcpServers['flow-nexus'] = {
+                    type: 'stdio',
+                    command: 'npx',
+                    args: ['flow-nexus@latest', 'mcp', 'start'],
+                    env: {
+                        ...process.env,
+                        FLOW_NEXUS_AUTO_START: 'true'
+                    }
+                };
+            }
+            if (process.env.ENABLE_AGENTIC_PAYMENTS_MCP === 'true') {
+                mcpServers['agentic-payments'] = {
+                    type: 'stdio',
+                    command: 'npx',
+                    args: ['-y', 'agentic-payments', 'mcp'],
+                    env: {
+                        ...process.env,
+                        AGENTIC_PAYMENTS_AUTO_START: 'true'
+                    }
+                };
+            }
+            const queryOptions = {
+                systemPrompt: agent.systemPrompt,
+                model: finalModel, // Claude Agent SDK handles model selection
+                permissionMode: 'bypassPermissions', // Auto-approve all tool usage for Docker automation
+                // Enable all built-in tools by default (Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch)
+                // Based on SDK types, allowedTools and disallowedTools control which tools are available
+                // If not specified, all tools are enabled by default
+                allowedTools: [
+                    'Read',
+                    'Write',
+                    'Edit',
+                    'Bash',
+                    'Glob',
+                    'Grep',
+                    'WebFetch',
+                    'WebSearch',
+                    'NotebookEdit',
+                    'TodoWrite'
+                ],
+                // Add MCP servers if configured
+                mcpServers: Object.keys(mcpServers).length > 0 ? mcpServers : undefined
+            };
+            // Add environment overrides if present
+            if (Object.keys(envOverrides).length > 0) {
+                queryOptions.env = {
+                    ...process.env,
+                    ...envOverrides
+                };
+            }
             const result = query({
                 prompt: input,
-                options: {
-                    systemPrompt: agent.systemPrompt,
-                    model: finalModel, // Claude Agent SDK handles model selection
-                    permissionMode: 'bypassPermissions', // Auto-approve all tool usage for Docker automation
-                    mcpServers: {
-                        // In-SDK server: 6 basic tools (memory + swarm)
-                        'claude-flow-sdk': claudeFlowSdkServer,
-                        // Full MCP server: 101 tools via subprocess (neural, analysis, workflow, github, daa, system)
-                        'claude-flow': {
-                            command: 'npx',
-                            args: ['claude-flow@alpha', 'mcp', 'start'],
-                            env: {
-                                ...process.env,
-                                MCP_AUTO_START: 'true',
-                                PROVIDER: provider
-                            }
-                        },
-                        // Flow Nexus MCP server: 96 cloud tools (sandboxes, swarms, neural, workflows)
-                        'flow-nexus': {
-                            command: 'npx',
-                            args: ['flow-nexus@latest', 'mcp', 'start'],
-                            env: {
-                                ...process.env,
-                                FLOW_NEXUS_AUTO_START: 'true'
-                            }
-                        },
-                        // Agentic Payments MCP server: Payment authorization and multi-agent consensus
-                        'agentic-payments': {
-                            command: 'npx',
-                            args: ['-y', 'agentic-payments', 'mcp'],
-                            env: {
-                                ...process.env,
-                                AGENTIC_PAYMENTS_AUTO_START: 'true'
-                            }
-                        }
-                    }
-                    // allowedTools: removed to enable ALL tools from all servers
-                }
+                options: queryOptions
             });
             let output = '';
             for await (const msg of result) {
@@ -135,11 +195,13 @@ export async function claudeAgent(agent, input, onStream, modelOverride) {
             });
             return { output, agent: agent.name };
         }
-        finally {
-            // Restore original API key
-            if (originalApiKey) {
-                process.env.ANTHROPIC_API_KEY = originalApiKey;
-            }
+        catch (error) {
+            logger.error('Claude Agent SDK execution failed', {
+                provider,
+                model: finalModel,
+                error: error.message
+            });
+            throw error;
         }
     });
 }

package/dist/agents/directApiAgent.js

@@ -1,12 +1,31 @@
+// Direct API agent with multi-provider support (Anthropic, OpenRouter, Gemini)
+import Anthropic from '@anthropic-ai/sdk';
 import { logger } from '../utils/logger.js';
 import { withRetry } from '../utils/retry.js';
 import { execSync } from 'child_process';
 import { ModelRouter } from '../router/router.js';
-// Lazy initialize router
+// Lazy initialize clients
+let anthropic = null;
 let router = null;
+function getAnthropicClient() {
+    if (!anthropic) {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        // Validate API key format
+        if (!apiKey) {
+            throw new Error('ANTHROPIC_API_KEY is required but not set');
+        }
+        if (!apiKey.startsWith('sk-ant-')) {
+            throw new Error(`Invalid ANTHROPIC_API_KEY format. Expected format: sk-ant-...\n` +
+                `Got: ${apiKey.substring(0, 10)}...\n\n` +
+                `Please check your API key at: https://console.anthropic.com/settings/keys`);
+        }
+        anthropic = new Anthropic({ apiKey });
+    }
+    return anthropic;
+}
 function getRouter() {
     if (!router) {
-        // Router handles multi-provider logic and creates config from environment variables
+        // Router will now auto-create config from environment variables if no file exists
         router = new ModelRouter();
     }
     return router;
@@ -234,8 +253,7 @@ export async function directApiAgent(agent, input, onStream) {
                             : (process.env.COMPLETION_MODEL || 'meta-llama/llama-3.1-8b-instruct'),
                         messages: messagesWithSystem,
                         maxTokens: 8192,
-                        temperature: 0.7,
-                        provider: provider // Force the router to use this specific provider
+                        temperature: 0.7
                     };
                     const routerResponse = await routerInstance.chat(params);
                     // Convert router response to Anthropic format

package/dist/proxy/anthropic-to-gemini.js

@@ -0,0 +1,345 @@
+// Anthropic to Gemini Proxy Server
+// Converts Anthropic API format to Google Gemini format
+import express from 'express';
+import { logger } from '../utils/logger.js';
+export class AnthropicToGeminiProxy {
+    app;
+    geminiApiKey;
+    geminiBaseUrl;
+    defaultModel;
+    constructor(config) {
+        this.app = express();
+        this.geminiApiKey = config.geminiApiKey;
+        this.geminiBaseUrl = config.geminiBaseUrl || 'https://generativelanguage.googleapis.com/v1beta';
+        this.defaultModel = config.defaultModel || 'gemini-2.0-flash-exp';
+        this.setupMiddleware();
+        this.setupRoutes();
+    }
+    setupMiddleware() {
+        // Parse JSON bodies
+        this.app.use(express.json({ limit: '50mb' }));
+        // Logging middleware
+        this.app.use((req, res, next) => {
+            logger.debug('Gemini proxy request', {
+                method: req.method,
+                path: req.path,
+                headers: Object.keys(req.headers)
+            });
+            next();
+        });
+    }
+    setupRoutes() {
+        // Health check
+        this.app.get('/health', (req, res) => {
+            res.json({ status: 'ok', service: 'anthropic-to-gemini-proxy' });
+        });
+        // Anthropic Messages API → Gemini generateContent
+        this.app.post('/v1/messages', async (req, res) => {
+            try {
+                const anthropicReq = req.body;
+                // Convert Anthropic format to Gemini format
+                const geminiReq = this.convertAnthropicToGemini(anthropicReq);
+                logger.info('Converting Anthropic request to Gemini', {
+                    anthropicModel: anthropicReq.model,
+                    geminiModel: this.defaultModel,
+                    messageCount: geminiReq.contents.length,
+                    stream: anthropicReq.stream,
+                    apiKeyPresent: !!this.geminiApiKey,
+                    apiKeyPrefix: this.geminiApiKey?.substring(0, 10)
+                });
+                // Determine endpoint based on streaming
+                const endpoint = anthropicReq.stream ? 'streamGenerateContent' : 'generateContent';
+                const url = `${this.geminiBaseUrl}/models/${this.defaultModel}:${endpoint}?key=${this.geminiApiKey}`;
+                // Forward to Gemini
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json'
+                    },
+                    body: JSON.stringify(geminiReq)
+                });
+                if (!response.ok) {
+                    const error = await response.text();
+                    logger.error('Gemini API error', { status: response.status, error });
+                    return res.status(response.status).json({
+                        error: {
+                            type: 'api_error',
+                            message: error
+                        }
+                    });
+                }
+                // Handle streaming vs non-streaming
+                if (anthropicReq.stream) {
+                    // Stream response
+                    res.setHeader('Content-Type', 'text/event-stream');
+                    res.setHeader('Cache-Control', 'no-cache');
+                    res.setHeader('Connection', 'keep-alive');
+                    const reader = response.body?.getReader();
+                    if (!reader) {
+                        throw new Error('No response body');
+                    }
+                    const decoder = new TextDecoder();
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        const chunk = decoder.decode(value);
+                        const anthropicChunk = this.convertGeminiStreamToAnthropic(chunk);
+                        res.write(anthropicChunk);
+                    }
+                    res.end();
+                }
+                else {
+                    // Non-streaming response
+                    const geminiRes = await response.json();
+                    const anthropicRes = this.convertGeminiToAnthropic(geminiRes);
+                    logger.info('Gemini proxy response sent', {
+                        model: this.defaultModel,
+                        usage: anthropicRes.usage
+                    });
+                    res.json(anthropicRes);
+                }
+            }
+            catch (error) {
+                logger.error('Gemini proxy error', { error: error.message, stack: error.stack });
+                res.status(500).json({
+                    error: {
+                        type: 'proxy_error',
+                        message: error.message
+                    }
+                });
+            }
+        });
+        // Fallback for other Anthropic API endpoints
+        this.app.use((req, res) => {
+            logger.warn('Unsupported endpoint', { path: req.path, method: req.method });
+            res.status(404).json({
+                error: {
+                    type: 'not_found',
+                    message: `Endpoint ${req.path} not supported by Gemini proxy`
+                }
+            });
+        });
+    }
+    convertAnthropicToGemini(anthropicReq) {
+        const contents = [];
+        // Add system message as first user message if present
+        // Gemini doesn't have a dedicated system role, so we prepend it to the first user message
+        let systemPrefix = '';
+        if (anthropicReq.system) {
+            systemPrefix = `System: ${anthropicReq.system}\n\n`;
+        }
+        // Add tool instructions for Gemini to understand file operations
+        // Since Gemini doesn't have native tool calling, we instruct it to use structured XML-like commands
+        const toolInstructions = `
+IMPORTANT: You have access to file system operations through structured commands. Use these exact formats:
+
+<file_write path="filename.ext">
+content here
+</file_write>
+
+<file_read path="filename.ext"/>
+
+<bash_command>
+command here
+</bash_command>
+
+When you need to create, edit, or read files, use these structured commands in your response.
+The system will automatically execute these commands and provide results.
+
+`;
+        // Prepend tool instructions to system prompt
+        if (systemPrefix) {
+            systemPrefix = toolInstructions + systemPrefix;
+        }
+        else {
+            systemPrefix = toolInstructions;
+        }
+        // Convert Anthropic messages to Gemini format
+        for (let i = 0; i < anthropicReq.messages.length; i++) {
+            const msg = anthropicReq.messages[i];
+            let text;
+            if (typeof msg.content === 'string') {
+                text = msg.content;
+            }
+            else if (Array.isArray(msg.content)) {
+                // Extract text from content blocks
+                text = msg.content
+                    .filter(block => block.type === 'text')
+                    .map(block => block.text)
+                    .join('\n');
+            }
+            else {
+                text = '';
+            }
+            // Add system prefix to first user message
+            if (i === 0 && msg.role === 'user' && systemPrefix) {
+                text = systemPrefix + text;
+            }
+            contents.push({
+                role: msg.role === 'assistant' ? 'model' : 'user',
+                parts: [{ text }]
+            });
+        }
+        const geminiReq = {
+            contents
+        };
+        // Add generation config if temperature or max_tokens specified
+        if (anthropicReq.temperature !== undefined || anthropicReq.max_tokens !== undefined) {
+            geminiReq.generationConfig = {};
+            if (anthropicReq.temperature !== undefined) {
+                geminiReq.generationConfig.temperature = anthropicReq.temperature;
+            }
+            if (anthropicReq.max_tokens !== undefined) {
+                geminiReq.generationConfig.maxOutputTokens = anthropicReq.max_tokens;
+            }
+        }
+        return geminiReq;
+    }
+    parseStructuredCommands(text) {
+        const toolUses = [];
+        let cleanText = text;
+        // Parse file_write commands
+        const fileWriteRegex = /<file_write path="([^"]+)">([\s\S]*?)<\/file_write>/g;
+        let match;
+        while ((match = fileWriteRegex.exec(text)) !== null) {
+            toolUses.push({
+                type: 'tool_use',
+                id: `tool_${Date.now()}_${toolUses.length}`,
+                name: 'Write',
+                input: {
+                    file_path: match[1],
+                    content: match[2].trim()
+                }
+            });
+            cleanText = cleanText.replace(match[0], `[File written: ${match[1]}]`);
+        }
+        // Parse file_read commands
+        const fileReadRegex = /<file_read path="([^"]+)"\/>/g;
+        while ((match = fileReadRegex.exec(text)) !== null) {
+            toolUses.push({
+                type: 'tool_use',
+                id: `tool_${Date.now()}_${toolUses.length}`,
+                name: 'Read',
+                input: {
+                    file_path: match[1]
+                }
+            });
+            cleanText = cleanText.replace(match[0], `[Reading file: ${match[1]}]`);
+        }
+        // Parse bash commands
+        const bashRegex = /<bash_command>([\s\S]*?)<\/bash_command>/g;
+        while ((match = bashRegex.exec(text)) !== null) {
+            toolUses.push({
+                type: 'tool_use',
+                id: `tool_${Date.now()}_${toolUses.length}`,
+                name: 'Bash',
+                input: {
+                    command: match[1].trim()
+                }
+            });
+            cleanText = cleanText.replace(match[0], `[Executing: ${match[1].trim()}]`);
+        }
+        return { cleanText: cleanText.trim(), toolUses };
+    }
+    convertGeminiToAnthropic(geminiRes) {
+        const candidate = geminiRes.candidates?.[0];
+        if (!candidate) {
+            throw new Error('No candidates in Gemini response');
+        }
+        const content = candidate.content;
+        const rawText = content?.parts?.map((part) => part.text).join('') || '';
+        // Parse structured commands from Gemini's response
+        const { cleanText, toolUses } = this.parseStructuredCommands(rawText);
+        // Build content array with text and tool uses
+        const contentBlocks = [];
+        if (cleanText) {
+            contentBlocks.push({
+                type: 'text',
+                text: cleanText
+            });
+        }
+        // Add tool uses
+        contentBlocks.push(...toolUses);
+        return {
+            id: `msg_${Date.now()}`,
+            type: 'message',
+            role: 'assistant',
+            model: this.defaultModel,
+            content: contentBlocks.length > 0 ? contentBlocks : [
+                {
+                    type: 'text',
+                    text: rawText
+                }
+            ],
+            stop_reason: this.mapFinishReason(candidate.finishReason),
+            usage: {
+                input_tokens: geminiRes.usageMetadata?.promptTokenCount || 0,
+                output_tokens: geminiRes.usageMetadata?.candidatesTokenCount || 0
+            }
+        };
+    }
+    convertGeminiStreamToAnthropic(chunk) {
+        // Gemini streaming returns newline-delimited JSON
+        const lines = chunk.split('\n').filter(line => line.trim());
+        const anthropicChunks = [];
+        for (const line of lines) {
+            try {
+                const parsed = JSON.parse(line);
+                const candidate = parsed.candidates?.[0];
+                const text = candidate?.content?.parts?.[0]?.text;
+                if (text) {
+                    anthropicChunks.push(`event: content_block_delta\ndata: ${JSON.stringify({
+                        type: 'content_block_delta',
+                        delta: { type: 'text_delta', text }
+                    })}\n\n`);
+                }
+                // Check for finish
+                if (candidate?.finishReason) {
+                    anthropicChunks.push('event: message_stop\ndata: {}\n\n');
+                }
+            }
+            catch (e) {
+                // Ignore parse errors
+            }
+        }
+        return anthropicChunks.join('');
+    }
+    mapFinishReason(reason) {
+        const mapping = {
+            'STOP': 'end_turn',
+            'MAX_TOKENS': 'max_tokens',
+            'SAFETY': 'stop_sequence',
+            'RECITATION': 'stop_sequence',
+            'OTHER': 'end_turn'
+        };
+        return mapping[reason || 'STOP'] || 'end_turn';
+    }
+    start(port) {
+        this.app.listen(port, () => {
+            logger.info('Anthropic to Gemini proxy started', {
+                port,
+                geminiBaseUrl: this.geminiBaseUrl,
+                defaultModel: this.defaultModel
+            });
+            console.log(`\n✅ Gemini Proxy running at http://localhost:${port}`);
+            console.log(`   Gemini Base URL: ${this.geminiBaseUrl}`);
+            console.log(`   Default Model: ${this.defaultModel}\n`);
+        });
+    }
+}
+// CLI entry point
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const port = parseInt(process.env.PORT || '3001');
+    const geminiApiKey = process.env.GOOGLE_GEMINI_API_KEY;
+    if (!geminiApiKey) {
+        console.error('❌ Error: GOOGLE_GEMINI_API_KEY environment variable required');
+        process.exit(1);
+    }
+    const proxy = new AnthropicToGeminiProxy({
+        geminiApiKey,
+        geminiBaseUrl: process.env.GEMINI_BASE_URL,
+        defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL
+    });
+    proxy.start(port);
+}