agentic-flow 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.3] - 2025-11-06
+
+### Fixed - Gemini Provider Now Fully Functional 🎉
+
+**Three Critical Bugs Resolved:**
+
+1. **Model Selection Bug** (cli-proxy.ts:427-431, anthropic-to-gemini.ts)
+   - **Issue**: Proxy incorrectly used `COMPLETION_MODEL` environment variable containing `claude-sonnet-4-5-20250929` instead of Gemini model
+   - **Fix**: Ignore `COMPLETION_MODEL` for Gemini proxy, always default to `gemini-2.0-flash-exp`
+   - **Impact**: Gemini API now receives correct model name
+
+2. **Streaming Response Bug** (anthropic-to-gemini.ts:119-121)
+   - **Issue**: Missing `&alt=sse` parameter in streaming API URL caused empty response streams
+   - **Fix**: Added `&alt=sse` parameter to `streamGenerateContent` endpoint
+   - **Impact**: Streaming responses now work perfectly, returning complete LLM output
+
+3. **Provider Selection Logic Bug** (cli-proxy.ts:299-302)
+   - **Issue**: System auto-selected Gemini even when user explicitly specified `--provider anthropic`
+   - **Fix**: Check `options.provider` first and return false if user specified different provider
+   - **Impact**: Provider flag now correctly overrides auto-detection
+
+### Verified Working
+- ✅ Gemini provider with streaming responses
+- ✅ Anthropic provider (default and explicit)
+- ✅ OpenRouter provider
+- ✅ Non-streaming responses
+- ✅ All three providers tested end-to-end with agents
+
+### Technical Details
+- Direct Gemini API validation confirmed key is valid
+- Proxy correctly converts Anthropic Messages API format to Gemini format
+- Server-Sent Events (SSE) streaming properly parsed and converted
+- All fixes applied to both source (`src/`) and compiled (`dist/`) files
+
 ## [1.8.15] - 2025-11-01
 
 ### 🐛 Bug Fix - Model Configuration

package/README.md

@@ -246,6 +246,110 @@ npx agentic-flow --agent coder --task "Code cleanup" --optimize --max-cost 0.001
 
 ---
 
+## 🔌 Provider Support
+
+**agentic-flow supports multiple LLM providers** through intelligent proxy architecture that converts requests to provider-specific formats while maintaining Claude Agent SDK compatibility.
+
+### Supported Providers
+
+| Provider | Models | Cost | Speed | Setup |
+|----------|--------|------|-------|-------|
+| **Anthropic** | Claude 3.5 Sonnet, Opus, Haiku | $$$ | Fast | `ANTHROPIC_API_KEY` |
+| **Gemini** | Gemini 2.0 Flash, Pro | $ | Very Fast | `GOOGLE_GEMINI_API_KEY` |
+| **OpenRouter** | 100+ models (GPT, Llama, DeepSeek) | Varies | Varies | `OPENROUTER_API_KEY` |
+| **ONNX** | Phi-4 (local) | FREE | Medium | No key needed |
+
+### Quick Provider Examples
+
+```bash
+# Anthropic (default) - Highest quality
+npx agentic-flow --agent coder --task "Build API"
+
+# Gemini - Fastest, cost-effective (v1.9.3+)
+export GOOGLE_GEMINI_API_KEY=AIza...
+npx agentic-flow --agent coder --task "Build API" --provider gemini
+
+# OpenRouter - 99% cost savings with DeepSeek
+export OPENROUTER_API_KEY=sk-or-...
+npx agentic-flow --agent coder --task "Build API" \
+  --provider openrouter \
+  --model "deepseek/deepseek-chat"
+
+# ONNX - Free local inference (privacy-first)
+npx agentic-flow --agent coder --task "Build API" --provider onnx
+```
+
+### Provider Architecture
+
+**How it works:**
+1. All requests use Claude Agent SDK format (Messages API)
+2. Built-in proxies convert to provider-specific formats:
+   - **Gemini Proxy**: Converts to `generateContent` API with SSE streaming
+   - **OpenRouter Proxy**: Forwards to OpenRouter with model routing
+   - **ONNX Proxy**: Routes to local ONNX Runtime with Phi-4
+3. Responses converted back to Anthropic format
+4. Full streaming support across all providers
+
+**Key Features:**
+- ✅ Streaming responses (real-time output)
+- ✅ Tool calling support (where available)
+- ✅ Automatic format conversion
+- ✅ Error handling and retries
+- ✅ Cost tracking and usage metrics
+
+### Provider Configuration
+
+**Environment Variables:**
+```bash
+# Required for each provider
+ANTHROPIC_API_KEY=sk-ant-...        # Anthropic Claude
+GOOGLE_GEMINI_API_KEY=AIza...       # Google Gemini
+OPENROUTER_API_KEY=sk-or-v1-...     # OpenRouter
+# ONNX requires no key (local inference)
+
+# Optional overrides
+PROVIDER=gemini                      # Force specific provider
+USE_GEMINI=true                      # Enable Gemini by default
+DEFAULT_MODEL=gemini-2.0-flash-exp   # Override model
+```
+
+**CLI Flags:**
+```bash
+--provider <name>    # anthropic, gemini, openrouter, onnx
+--model <name>       # Provider-specific model name
+--stream             # Enable streaming (default: true)
+--optimize           # Auto-select optimal model
+--priority <type>    # quality, cost, speed, privacy
+```
+
+### Gemini Provider (v1.9.3+)
+
+**Fully functional** with streaming support! Three critical bugs fixed:
+
+```bash
+# Setup Gemini
+export GOOGLE_GEMINI_API_KEY=AIzaSy...
+
+# Use Gemini (fastest responses)
+npx agentic-flow --agent coder --task "Write function" --provider gemini
+
+# Gemini with streaming
+npx agentic-flow --agent coder --task "Build API" --provider gemini --stream
+
+# Gemini-specific model
+npx agentic-flow --agent coder --task "Task" \
+  --provider gemini \
+  --model "gemini-2.0-flash-exp"
+```
+
+**Gemini Benefits:**
+- ⚡ **2-5x faster** than Anthropic
+- 💰 **70% cheaper** than Claude
+- 🎯 **Excellent for** code generation, analysis, simple tasks
+- ✅ **Full streaming support** (SSE)
+
+---
+
 ## 📋 CLI Commands
 
 ```bash

package/dist/cli/config-wizard.js

@@ -21,6 +21,12 @@ const CONFIG_DEFINITIONS = [
         required: false,
         validation: (val) => val.startsWith('sk-or-') || 'Must start with sk-or-'
     },
+    {
+        key: 'GOOGLE_GEMINI_API_KEY',
+        value: '',
+        description: 'Google Gemini API key for Gemini models',
+        required: false
+    },
     {
         key: 'COMPLETION_MODEL',
         value: 'claude-sonnet-4-5-20250929',
@@ -30,9 +36,9 @@ const CONFIG_DEFINITIONS = [
     {
         key: 'PROVIDER',
         value: 'anthropic',
-        description: 'Default provider (anthropic, openrouter, onnx)',
+        description: 'Default provider (anthropic, openrouter, gemini, onnx)',
         required: false,
-        validation: (val) => ['anthropic', 'openrouter', 'onnx'].includes(val) || 'Must be anthropic, openrouter, or onnx'
+        validation: (val) => ['anthropic', 'openrouter', 'gemini', 'onnx'].includes(val) || 'Must be anthropic, openrouter, gemini, or onnx'
     },
     {
         key: 'AGENTS_DIR',
@@ -231,15 +237,17 @@ export class ConfigWizard {
         console.log('📊 Configuration Summary:\n');
         const hasAnthropic = this.currentConfig.has('ANTHROPIC_API_KEY');
         const hasOpenRouter = this.currentConfig.has('OPENROUTER_API_KEY');
+        const hasGemini = this.currentConfig.has('GOOGLE_GEMINI_API_KEY');
         const provider = this.currentConfig.get('PROVIDER') || 'anthropic';
         console.log('Providers configured:');
         console.log(`  ${hasAnthropic ? '✅' : '❌'} Anthropic (Claude)`);
         console.log(`  ${hasOpenRouter ? '✅' : '❌'} OpenRouter (Alternative models)`);
+        console.log(`  ${hasGemini ? '✅' : '❌'} Gemini (Google AI)`);
         console.log(`  ⚙️  ONNX (Local inference) - always available`);
         console.log('');
         console.log(`Default provider: ${provider}`);
         console.log('');
-        if (!hasAnthropic && !hasOpenRouter) {
+        if (!hasAnthropic && !hasOpenRouter && !hasGemini) {
             console.log('⚠️  Warning: No API keys configured!');
             console.log('   You can use ONNX local inference, but quality may be limited.');
             console.log('   Run with --provider onnx to use local inference.\n');
@@ -339,8 +347,9 @@ EXAMPLES:
 AVAILABLE CONFIGURATION KEYS:
   ANTHROPIC_API_KEY     - Anthropic API key (sk-ant-...)
   OPENROUTER_API_KEY    - OpenRouter API key (sk-or-v1-...)
+  GOOGLE_GEMINI_API_KEY - Google Gemini API key
   COMPLETION_MODEL      - Default model name
-  PROVIDER              - Default provider (anthropic, openrouter, onnx)
+  PROVIDER              - Default provider (anthropic, openrouter, gemini, onnx)
   AGENTS_DIR            - Custom agents directory
   PROXY_PORT            - Proxy server port (default: 3000)
   USE_OPENROUTER        - Force OpenRouter (true/false)

package/dist/cli-proxy.js

@@ -207,7 +207,10 @@ class AgenticFlowCLI {
             }
             else if (useGemini) {
                 console.log('🚀 Initializing Gemini proxy...');
-                await this.startGeminiProxy(options.model);
+                // 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');
@@ -248,6 +251,10 @@ class AgenticFlowCLI {
         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 &&
@@ -347,9 +354,12 @@ class AgenticFlowCLI {
             process.exit(1);
         }
         logger.info('Starting integrated Gemini proxy');
-        const defaultModel = modelOverride ||
-            process.env.COMPLETION_MODEL ||
-            'gemini-2.0-flash-exp';
+        // 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({
@@ -853,7 +863,11 @@ PERFORMANCE:
         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
-        const result = await claudeAgentDirect(agent, task, streamHandler, options.model);
+        // 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');
@@ -1058,26 +1072,33 @@ OPTIMIZATION BENEFITS:
   📊 10+ Models: Claude, GPT-4o, Gemini, DeepSeek, Llama, ONNX local
   ⚡ Zero Overhead: <5ms decision time, no API calls during optimization
 
-PROXY MODE (Claude Code CLI Integration):
-  The OpenRouter proxy allows Claude Code to use alternative models via API translation.
+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.
 
-  Terminal 1 - Start Proxy Server:
-    npx agentic-flow proxy
-    # Or with custom port: PROXY_PORT=8080 npx agentic-flow proxy
-    # Proxy runs at http://localhost:3000 by default
+  2️⃣  CLAUDE CODE INTEGRATION (proxy for Claude Code CLI)
+      Use Claude Code CLI with OpenRouter/Gemini models via proxy:
 
-  Terminal 2 - Use with 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"
+      # Option A: Auto-spawn Claude Code with proxy (easiest)
+      npx agentic-flow claude-code --provider openrouter "Build API"
 
-    # Now Claude Code will route through OpenRouter proxy
-    claude-code --agent coder --task "Create API"
+      # Option B: Manual proxy setup (advanced)
+      Terminal 1 - Start Proxy:
+        npx agentic-flow proxy --provider openrouter
 
-  Proxy automatically translates Anthropic API calls to OpenRouter format.
-  Model override happens automatically: Claude requests → OpenRouter models.
+      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 for Claude Code users:
+  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

package/dist/hooks/swarm-learning-optimizer.js

@@ -203,7 +203,7 @@ export class SwarmLearningOptimizer {
                 {
                     topology: topology === 'mesh' ? 'hierarchical' : 'mesh',
                     confidence: 0.5,
-                    reasoning: 'Alternative topology if default doesn', t, perform, well, ': 
+                    reasoning: 'Alternative topology if default does not perform well'
                 }
             ]
         };

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

@@ -49,7 +49,9 @@ export class AnthropicToGeminiProxy {
                 });
                 // Determine endpoint based on streaming
                 const endpoint = anthropicReq.stream ? 'streamGenerateContent' : 'generateContent';
-                const url = `${this.geminiBaseUrl}/models/${this.defaultModel}:${endpoint}?key=${this.geminiApiKey}`;
+                // BUG FIX: Add &alt=sse for streaming to get Server-Sent Events format
+                const streamParam = anthropicReq.stream ? '&alt=sse' : '';
+                const url = `${this.geminiBaseUrl}/models/${this.defaultModel}:${endpoint}?key=${this.geminiApiKey}${streamParam}`;
                 // Forward to Gemini
                 const response = await fetch(url, {
                     method: 'POST',
@@ -79,23 +81,39 @@ export class AnthropicToGeminiProxy {
                         throw new Error('No response body');
                     }
                     const decoder = new TextDecoder();
+                    let chunkCount = 0;
                     while (true) {
                         const { done, value } = await reader.read();
                         if (done)
                             break;
                         const chunk = decoder.decode(value);
+                        chunkCount++;
+                        logger.info('Gemini stream chunk received', { chunkCount, chunkLength: chunk.length, chunkPreview: chunk.substring(0, 200) });
                         const anthropicChunk = this.convertGeminiStreamToAnthropic(chunk);
+                        logger.info('Anthropic stream chunk generated', { chunkCount, anthropicLength: anthropicChunk.length, anthropicPreview: anthropicChunk.substring(0, 200) });
                         res.write(anthropicChunk);
                     }
+                    logger.info('Gemini stream complete', { totalChunks: chunkCount });
                     res.end();
                 }
                 else {
                     // Non-streaming response
                     const geminiRes = await response.json();
+                    // DEBUG: Log raw Gemini response
+                    logger.info('Raw Gemini API response', {
+                        hasResponse: !!geminiRes,
+                        hasCandidates: !!geminiRes.candidates,
+                        candidatesLength: geminiRes.candidates?.length,
+                        firstCandidate: geminiRes.candidates?.[0],
+                        fullResponse: JSON.stringify(geminiRes).substring(0, 500)
+                    });
                     const anthropicRes = this.convertGeminiToAnthropic(geminiRes);
                     logger.info('Gemini proxy response sent', {
                         model: this.defaultModel,
-                        usage: anthropicRes.usage
+                        usage: anthropicRes.usage,
+                        contentBlocks: anthropicRes.content?.length,
+                        hasText: anthropicRes.content?.some((c) => c.type === 'text'),
+                        firstContent: anthropicRes.content?.[0]
                     });
                     res.json(anthropicRes);
                 }
@@ -284,21 +302,33 @@ The system will automatically execute these commands and provide results.
     convertGeminiToAnthropic(geminiRes) {
         const candidate = geminiRes.candidates?.[0];
         if (!candidate) {
+            logger.error('No candidates in Gemini response', { geminiRes });
             throw new Error('No candidates in Gemini response');
         }
         const content = candidate.content;
         const parts = content?.parts || [];
+        logger.info('Converting Gemini to Anthropic', {
+            hasParts: !!parts,
+            partsCount: parts.length,
+            partTypes: parts.map((p) => Object.keys(p))
+        });
         // Extract text and function calls
         let rawText = '';
         const functionCalls = [];
         for (const part of parts) {
             if (part.text) {
                 rawText += part.text;
+                logger.info('Found text in part', { textLength: part.text.length, textPreview: part.text.substring(0, 100) });
             }
             if (part.functionCall) {
                 functionCalls.push(part.functionCall);
             }
         }
+        logger.info('Extracted content from Gemini', {
+            rawTextLength: rawText.length,
+            functionCallsCount: functionCalls.length,
+            rawTextPreview: rawText.substring(0, 200)
+        });
         // Parse structured commands from Gemini's text response
         const { cleanText, toolUses } = this.parseStructuredCommands(rawText);
         // Build content array with text and tool uses
@@ -345,27 +375,32 @@ The system will automatically execute these commands and provide results.
         };
     }
     convertGeminiStreamToAnthropic(chunk) {
-        // Gemini streaming returns newline-delimited JSON
+        // Gemini streaming returns Server-Sent Events format: "data: {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');
+                // Parse SSE format: "data: {json}"
+                if (line.startsWith('data: ')) {
+                    const jsonStr = line.substring(6); // Remove "data: " prefix
+                    const parsed = JSON.parse(jsonStr);
+                    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
+                logger.debug('Failed to parse Gemini stream chunk', { line, error: e.message });
             }
         }
         return anthropicChunks.join('');

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

@@ -0,0 +1,439 @@
+// 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 {
+    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();
+                    let chunkCount = 0;
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        const chunk = decoder.decode(value);
+                        chunkCount++;
+                        logger.info('Gemini stream chunk received', { chunkCount, chunkLength: chunk.length, chunkPreview: chunk.substring(0, 200) });
+                        const anthropicChunk = this.convertGeminiStreamToAnthropic(chunk);
+                        logger.info('Anthropic stream chunk generated', { chunkCount, anthropicLength: anthropicChunk.length, anthropicPreview: anthropicChunk.substring(0, 200) });
+                        res.write(anthropicChunk);
+                    }
+                    logger.info('Gemini stream complete', { totalChunks: chunkCount });
+                    res.end();
+                }
+                else {
+                    // Non-streaming response
+                    const geminiRes = await response.json();
+                    // DEBUG: Log raw Gemini response
+                    logger.info('Raw Gemini API response', {
+                        hasResponse: !!geminiRes,
+                        hasCandidates: !!geminiRes.candidates,
+                        candidatesLength: geminiRes.candidates?.length,
+                        firstCandidate: geminiRes.candidates?.[0],
+                        fullResponse: JSON.stringify(geminiRes).substring(0, 500)
+                    });
+                    const anthropicRes = this.convertGeminiToAnthropic(geminiRes);
+                    logger.info('Gemini proxy response sent', {
+                        model: this.defaultModel,
+                        usage: anthropicRes.usage,
+                        contentBlocks: anthropicRes.content?.length,
+                        hasText: anthropicRes.content?.some((c) => c.type === 'text'),
+                        firstContent: anthropicRes.content?.[0]
+                    });
+                    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;
+            }
+        }
+        // Convert MCP/Anthropic tools to Gemini tools format
+        if (anthropicReq.tools && anthropicReq.tools.length > 0) {
+            geminiReq.tools = [{
+                    functionDeclarations: anthropicReq.tools.map(tool => {
+                        // Clean schema: Remove $schema and additionalProperties fields that Gemini doesn't support
+                        const cleanSchema = (schema) => {
+                            if (!schema || typeof schema !== 'object')
+                                return schema;
+                            const { $schema, additionalProperties, ...rest } = schema;
+                            const cleaned = { ...rest };
+                            // Recursively clean nested objects
+                            if (cleaned.properties) {
+                                cleaned.properties = Object.fromEntries(Object.entries(cleaned.properties).map(([key, value]) => [
+                                    key,
+                                    cleanSchema(value)
+                                ]));
+                            }
+                            // Clean items if present
+                            if (cleaned.items) {
+                                cleaned.items = cleanSchema(cleaned.items);
+                            }
+                            return cleaned;
+                        };
+                        return {
+                            name: tool.name,
+                            description: tool.description || '',
+                            parameters: cleanSchema(tool.input_schema) || {
+                                type: 'object',
+                                properties: {},
+                                required: []
+                            }
+                        };
+                    })
+                }];
+            logger.info('Forwarding MCP tools to Gemini', {
+                toolCount: anthropicReq.tools.length,
+                toolNames: anthropicReq.tools.map(t => t.name)
+            });
+        }
+        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) {
+            logger.error('No candidates in Gemini response', { geminiRes });
+            throw new Error('No candidates in Gemini response');
+        }
+        const content = candidate.content;
+        const parts = content?.parts || [];
+        logger.info('Converting Gemini to Anthropic', {
+            hasParts: !!parts,
+            partsCount: parts.length,
+            partTypes: parts.map((p) => Object.keys(p))
+        });
+        // Extract text and function calls
+        let rawText = '';
+        const functionCalls = [];
+        for (const part of parts) {
+            if (part.text) {
+                rawText += part.text;
+                logger.info('Found text in part', { textLength: part.text.length, textPreview: part.text.substring(0, 100) });
+            }
+            if (part.functionCall) {
+                functionCalls.push(part.functionCall);
+            }
+        }
+        logger.info('Extracted content from Gemini', {
+            rawTextLength: rawText.length,
+            functionCallsCount: functionCalls.length,
+            rawTextPreview: rawText.substring(0, 200)
+        });
+        // Parse structured commands from Gemini's text 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 from structured commands
+        contentBlocks.push(...toolUses);
+        // Add tool uses from Gemini function calls (MCP tools)
+        if (functionCalls.length > 0) {
+            for (const functionCall of functionCalls) {
+                contentBlocks.push({
+                    type: 'tool_use',
+                    id: `tool_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+                    name: functionCall.name,
+                    input: functionCall.args || {}
+                });
+            }
+            logger.info('Converted Gemini function calls to Anthropic format', {
+                functionCallCount: functionCalls.length,
+                functionNames: functionCalls.map((fc) => fc.name)
+            });
+        }
+        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 Server-Sent Events format: "data: {json}"
+        const lines = chunk.split('\n').filter(line => line.trim());
+        const anthropicChunks = [];
+        for (const line of lines) {
+            try {
+                // Parse SSE format: "data: {json}"
+                if (line.startsWith('data: ')) {
+                    const jsonStr = line.substring(6); // Remove "data: " prefix
+                    const parsed = JSON.parse(jsonStr);
+                    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
+                logger.debug('Failed to parse Gemini stream chunk', { line, error: e.message });
+            }
+        }
+        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);
+}

package/dist/proxy/utils/logger.js

@@ -0,0 +1,59 @@
+class Logger {
+    constructor() {
+        this.context = {};
+    }
+    setContext(ctx) {
+        this.context = { ...this.context, ...ctx };
+    }
+    log(level, message, data) {
+        // Skip all logs if QUIET mode is enabled (unless it's an error)
+        if (process.env.QUIET === 'true' && level !== 'error') {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const logEntry = {
+            timestamp,
+            level,
+            message,
+            ...this.context,
+            ...data
+        };
+        // Structured JSON logging for production
+        if (process.env.NODE_ENV === 'production') {
+            console.log(JSON.stringify(logEntry));
+        }
+        else {
+            // Human-readable for development
+            const prefix = `[${timestamp}] ${level.toUpperCase()}`;
+            const contextStr = Object.keys({ ...this.context, ...data }).length > 0
+                ? ` ${JSON.stringify({ ...this.context, ...data })}`
+                : '';
+            console.log(`${prefix}: ${message}${contextStr}`);
+        }
+    }
+    debug(message, data) {
+        // Skip debug logs unless DEBUG or VERBOSE environment variable is set
+        if (!process.env.DEBUG && !process.env.VERBOSE) {
+            return;
+        }
+        this.log('debug', message, data);
+    }
+    info(message, data) {
+        // Skip info logs unless VERBOSE is set
+        if (!process.env.DEBUG && !process.env.VERBOSE) {
+            return;
+        }
+        this.log('info', message, data);
+    }
+    warn(message, data) {
+        // Skip warnings unless VERBOSE is set
+        if (!process.env.DEBUG && !process.env.VERBOSE) {
+            return;
+        }
+        this.log('warn', message, data);
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+}
+export const logger = new Logger();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-flow",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "description": "Production-ready AI agent orchestration platform with 66 specialized agents, 213 MCP tools, ReasoningBank learning memory, and autonomous multi-agent swarms. Built by @ruvnet with Claude Agent SDK, neural networks, memory persistence, GitHub integration, and distributed consensus protocols.",
   "type": "module",
   "main": "dist/index.js",

package/wasm/reasoningbank/reasoningbank_wasm_bg.js

@@ -258,7 +258,7 @@ export function log(message) {
     wasm.log(ptr0, len0);
 }
 
-function __wbg_adapter_4(arg0, arg1, arg2) {
+function __wbg_adapter_6(arg0, arg1, arg2) {
     wasm.__wbindgen_export_5(arg0, arg1, addHeapObject(arg2));
 }
 
@@ -540,7 +540,7 @@ export function __wbindgen_cast_2241b6af4c4b2941(arg0, arg1) {
 
 export function __wbindgen_cast_8eb6fd44e7238d11(arg0, arg1) {
     // Cast intrinsic for `Closure(Closure { dtor_idx: 62, function: Function { arguments: [Externref], shim_idx: 63, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-    const ret = makeMutClosure(arg0, arg1, 62, __wbg_adapter_4);
+    const ret = makeMutClosure(arg0, arg1, 62, __wbg_adapter_6);
     return addHeapObject(ret);
 };