polydev-ai 1.4.4 → 1.5.0

package/README.md

@@ -1,160 +1,219 @@
-# Polydev AI MCP Server
+# Polydev AI
 
-Get diverse AI perspectives from multiple LLMs via Model Context Protocol (MCP). Supports Cline, Claude Code, and other MCP clients with local CLI detection and remote AI perspectives.
+**Advanced Model Context Protocol Platform with Multi-LLM Integrations**
+
+<!-- Last updated: 2024-12-12 -->
+
+[polydev.ai](https://polydev.ai) | Live Platform
+
+---
+
+## Overview
+
+Polydev AI is an advanced Model Context Protocol (MCP) platform providing comprehensive multi-LLM integrations, subscription-based CLI access, OAuth bridges, and advanced tooling for AI development.
 
 ## Features
 
-- 🤖 **Multi-Model AI Perspectives**: Get responses from GPT-4, Claude, Gemini, and more
-- 🔧 **Local CLI Detection**: Automatically detect and use Claude Code, Codex CLI, Gemini CLI
-- ⚡ **Smart Caching**: Intelligent refresh intervals based on CLI status
-- 🔄 **Fallback Support**: Local CLI + remote perspectives for comprehensive responses
-- 🔐 **Secure**: Token-based authentication with your Polydev account
+### 🤖 Comprehensive LLM Integration
 
-## Installation
+- **API-Based Providers**: Direct integration with 8+ providers (Anthropic, OpenAI, Google, etc.)
+- **Subscription-Based CLI Access**: Use your existing ChatGPT Plus, Claude Pro, GitHub Copilot subscriptions
+- **Unified Interface**: Single API for all providers with consistent streaming responses
+- **Auto-Detection**: Automatic CLI tool discovery and path configuration
 
-### For Claude Code Users
+### 🔧 CLI Provider Support
 
-```bash
-# Install globally
-npm install -g polydev-ai
+| Provider | Integration | Authentication |
+|----------|-------------|----------------|
+| **Codex CLI** | Access GPT-5 with high reasoning | ChatGPT Plus subscription |
+| **Claude Code CLI** | Claude via Anthropic | Anthropic Pro subscription |
+| **Gemini CLI** | Google Cloud | Google Cloud authentication |
+| **GitHub Copilot** | VS Code Language Model API | GitHub Copilot subscription |
 
-# Or use directly with npx
-npx polydev-ai
-```
+### 🛠 Advanced Tooling
 
-### For Cline Users
-
-Add to your MCP settings (`.cline/mcp_servers.json`):
-
-```json
-{
-  "mcpServers": {
-    "polydev": {
-      "command": "npx",
-      "args": ["polydev-ai"],
-      "env": {
-        "POLYDEV_USER_TOKEN": "your_token_here"
-      }
-    }
-  }
-}
-```
+- **Model Context Protocol (MCP)**: Hosted MCP server with OAuth authentication
+- **Multi-Authentication**: Both OAuth and API token support for maximum flexibility
+- **Process Execution**: Cross-platform CLI management with timeout handling
+- **Path Auto-Discovery**: Smart detection of CLI installations across Windows, macOS, Linux
+- **Real-time Status**: Live CLI availability and authentication checking
 
-## Configuration
+### 🔒 Security & Authentication
 
-### Get Your Token
+- **Encrypted Storage**: Browser-based API key encryption using SubtleCrypto API
+- **OAuth Bridges**: Secure authentication flows
+- **Subscription Auth**: No API costs - use existing subscriptions
+- **Local Storage**: Keys never leave your device
 
-1. Sign up at [polydev.ai](https://polydev.ai)
-2. Go to your dashboard and copy your MCP token
-3. Set the environment variable:
+### 📊 Monitoring & Analytics
 
-```bash
-export POLYDEV_USER_TOKEN="pd_your_token_here"
-```
+- **PostHog Integration**: Advanced user analytics and feature tracking
+- **BetterStack Monitoring**: System health and performance monitoring
+- **Upstash Redis**: High-performance caching layer
+- **Supabase Auth**: Robust authentication system
 
-### Claude Code Integration
+## Tech Stack
 
-Add to your Claude Code MCP configuration:
+| Layer | Technology |
+|-------|------------|
+| **Frontend** | Next.js 15 (App Router), React 18, TypeScript, Tailwind CSS, shadcn/ui |
+| **Backend** | Supabase (PostgreSQL + Auth), Upstash Redis |
+| **AI Integration** | Custom TypeScript handlers for 8+ LLM providers |
+| **CLI Integration** | Cross-platform process execution utilities |
+| **Streaming** | Server-Sent Events for real-time responses |
+| **Monitoring** | PostHog Analytics, BetterStack |
 
-```json
- "polydev": {
-          "disabled": false,
-          "timeout": 120,
-          "type": "http",
-          "url": "https://www.polydev.ai/api/mcp"
-        },
-```
+## Supported LLM Providers
 
-## Available Tools
+| Provider | Models | Context Window | Features |
+|----------|--------|----------------|----------|
+| **Anthropic** | Claude 3.5 Sonnet, Haiku, Opus | 200K tokens | Best for reasoning and code |
+| **OpenAI** | GPT-4o, GPT-4 Turbo, GPT-3.5 | 128K tokens | Versatile, widely adopted |
+| **Google Gemini** | Gemini 1.5 Pro, Flash | 1M+ tokens | Large context window |
+| **OpenRouter** | 100+ models | Varies | Access to multiple providers |
+| **Groq** | Open-source models | Varies | Ultra-fast inference |
+| **Perplexity** | Search-optimized models | Varies | AI search and reasoning |
+| **DeepSeek** | Reasoning models | Varies | Advanced reasoning capabilities |
+| **Mistral AI** | European AI models | Varies | Strong performance, EU-based |
 
-- `get_perspectives` - Get AI responses from multiple models
-- `force_cli_detection` - Force detection of local CLI tools
-- `get_cli_status` - Check status of CLI tools (Claude Code, Codex, Gemini)
-- `send_cli_prompt` - Send prompts to local CLI with perspectives fallback
+## MCP Tools Available
 
-## Usage Examples
+- **Research**: Exa (web search), DeepWiki, Context7
+- **Storage**: Supabase, Upstash Redis, Memory (knowledge graph)
+- **Development**: GitHub, Git, Filesystem
+- **Infrastructure**: Vercel, Stripe
+- **AI**: Polydev (multi-model consultation)
+- **Communication**: Resend (email)
 
-### Get Multi-Model Perspectives
+## Architecture
 
-```typescript
-// Use the get_perspectives tool
-{
-  "prompt": "How do I optimize React performance?",
-  "models": ["gpt-4", "claude-3-sonnet", "gemini-pro"]
-}
+```
+┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
+│   Frontend UI   │────│  Process Utils   │────│   CLI Tools     │
+│   (React/TS)    │    │  (Node.js)       │    │   (External)    │
+└─────────────────┘    └──────────────────┘    └─────────────────┘
+         │                        │                        │
+         │                        │                        │
+         ▼                        ▼                        ▼
+┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
+│ LLM Service     │    │ CLI Handlers     │    │ Subscriptions   │
+│ (Unified API)   │    │ (Per Provider)   │    │ (ChatGPT+, etc) │
+└─────────────────┘    └──────────────────┘    └─────────────────┘
+         │                        │
+         │                        │
+         ▼                        ▼
+┌─────────────────┐    ┌──────────────────┐
+│   Supabase      │    │   MCP Platform   │
+│   (Auth + DB)   │    │   (16+ Tools)    │
+└─────────────────┘    └──────────────────┘
 ```
 
-### Check CLI Status
+## Quick Start
 
-```typescript
-// Check all CLI tools
-await get_cli_status({})
+### Prerequisites
 
-// Check specific tool
-await get_cli_status({ provider_id: "claude_code" })
-```
+- Node.js 18+
+- npm or yarn package manager
+- (Optional) CLI tools for subscription-based access:
+  - Codex CLI for ChatGPT Plus integration
+  - Claude Code CLI for Anthropic Pro integration
+  - Gemini CLI for Google Cloud integration
+  - VS Code with GitHub Copilot for Copilot integration
 
-### Send CLI Prompt with Fallback
+### Installation
 
-```typescript
-await send_cli_prompt({
-  provider_id: "claude_code",
-  prompt: "Write a Python function to parse JSON",
-  mode: "args"
-})
-```
+```bash
+# Clone the repository
+git clone https://github.com/backspacevenkat/polydev-ai.git
+cd polydev-ai
 
-## Supported CLI Tools
+# Install dependencies
+npm install
 
-- **Claude Code** (`claude`) - Anthropic's official CLI
-- **Codex CLI** (`codex`) - OpenAI's code CLI
-- **Gemini CLI** (`gemini`) - Google's Gemini CLI
+# Configure environment variables
+cp .env.example .env.local
 
-## Smart Refresh System
+# Start development server
+npm run dev
+```
+
+Open the application at http://localhost:3000
 
-The MCP server automatically detects CLI status changes:
+### Quick Configuration
 
-- **Unavailable CLIs**: Check every 2 minutes
-- **Unauthenticated CLIs**: Check every 3 minutes  
-- **Working CLIs**: Check every 10 minutes
-- **Fallback detection**: Check every 5 minutes
+1. **API Key Setup**: Go to Settings → API Keys tab to configure traditional API access
+2. **CLI Setup**: Go to Settings → CLI Subscriptions tab to set up subscription-based access
+3. **Provider Selection**: Choose your preferred LLM provider from the dropdown
+4. **Test Integration**: Use the chat interface to test your configuration
 
 ## Environment Variables
 
-- `POLYDEV_USER_TOKEN` - Your Polydev authentication token (required)
-- `POLYDEV_CLI_DEBUG` - Enable CLI debugging output
-- `CLAUDE_CODE_PATH` - Custom path to Claude Code CLI
-- `CODEX_CLI_PATH` - Custom path to Codex CLI
-- `GEMINI_CLI_PATH` - Custom path to Gemini CLI
+```env
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
+SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
 
-## Troubleshooting
+# PostHog Analytics
+NEXT_PUBLIC_POSTHOG_KEY=your_posthog_key
+NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com
 
-### CLI Not Detected
+# Upstash Redis
+UPSTASH_REDIS_REST_URL=your_upstash_redis_url
+UPSTASH_REDIS_REST_TOKEN=your_upstash_redis_token
+
+# BetterStack Logging
+BETTERSTACK_LOGS_TOKEN=your_betterstack_token
+```
 
-1. Ensure the CLI is installed and in your PATH
-2. Check authentication: `claude auth status` / `codex login status`
-3. Enable debugging: `export POLYDEV_CLI_DEBUG=1`
+## CLI Provider Setup
 
-### Token Issues
+### Codex CLI (ChatGPT Plus Integration)
 
-1. Verify your token at [polydev.ai/dashboard](https://polydev.ai/dashboard)
-2. Ensure the token starts with `pd_`
-3. Check environment variable is set correctly
+```bash
+# Install and authenticate
+codex auth
+codex --version
+```
 
-### Permission Errors
+### Claude Code CLI (Anthropic Pro Integration)
 
 ```bash
-# Fix npm permissions
-npm config set prefix '~/.npm-global'
-export PATH=~/.npm-global/bin:$PATH
+# Install and authenticate
+claude login
+claude --version
 ```
 
-## Support
+### Gemini CLI (Google Cloud Integration)
 
-- 📧 Email: [support@polydev.ai](mailto:support@polydev.ai)
-- 📖 Docs: [polydev.ai/docs](https://polydev.ai/docs)
-- 🐛 Issues: [GitHub Issues](https://github.com/backspacevenkat/polydev-website/issues)
+```bash
+# Install Google Cloud SDK and authenticate
+gcloud auth login
+gcloud auth application-default login
+```
+
+### GitHub Copilot Integration
+
+1. Install VS Code with GitHub Copilot extension
+2. Sign in with your GitHub account that has Copilot access
+3. The application will detect VS Code and Copilot availability automatically
+
+## Development Status
+
+**Current Status**: Active Development
+
+The platform is fully functional for:
+- Multi-LLM chat interface with streaming
+- API key management with client-side encryption
+- CLI subscription integration
+- MCP server with 16+ tools
+- Real-time streaming responses
 
 ## License
 
-MIT License - see LICENSE file for details.
+MIT
+
+## Links
+
+- **Website**: [polydev.ai](https://polydev.ai)
+- **Repository**: [github.com/backspacevenkat/polydev-ai](https://github.com/backspacevenkat/polydev-ai)

package/{cliManager.js → lib/cliManager.js}

@@ -5,13 +5,34 @@ const fs = require('fs');
 const os = require('os');
 const which = require('which');
 
+// Status reporter for sending CLI status to polydev.ai server
+let StatusReporter;
+try {
+  StatusReporter = require('./statusReporter').StatusReporter;
+} catch (e) {
+  // StatusReporter not available, continue without it
+  StatusReporter = null;
+}
+
 const execAsync = promisify(exec);
 
 class CLIManager {
-  constructor() {
+  constructor(options = {}) {
     this.providers = new Map();
     this.statusCache = new Map();
     this.CACHE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+    
+    // Initialize status reporter if available
+    this.statusReporter = null;
+    if (StatusReporter && options.enableStatusReporting !== false) {
+      this.statusReporter = new StatusReporter({
+        userToken: options.userToken || process.env.POLYDEV_USER_TOKEN,
+        reportingEnabled: options.reportingEnabled !== false,
+        heartbeatIntervalMs: options.heartbeatIntervalMs,
+        debug: options.debug || process.env.POLYDEV_CLI_DEBUG === 'true'
+      });
+    }
+    
     this.initializeProviders();
   }
 
@@ -96,6 +117,13 @@ class CLIManager {
       }
     }
 
+    // Report status to polydev.ai server (non-blocking)
+    if (this.statusReporter && this.statusReporter.isConfigured()) {
+      this.statusReporter.reportAllStatuses(results).catch(err => {
+        console.warn(`[Polydev CLI] Status reporting failed:`, err.message);
+      });
+    }
+
     return results;
   }
 
@@ -710,6 +738,115 @@ This is a known issue with @google/gemini-cli@0.3.4 and older Node.js versions.`
   getProvider(providerId) {
     return this.providers.get(providerId);
   }
+
+  // ============================================
+  // Status Reporting Methods
+  // ============================================
+
+  /**
+   * Enable status reporting to polydev.ai server
+   * @param {string} userToken - User's MCP token (pd_xxx or polydev_xxx)
+   * @param {object} options - Additional configuration options
+   */
+  enableStatusReporting(userToken, options = {}) {
+    if (!StatusReporter) {
+      console.warn('[Polydev CLI] StatusReporter not available');
+      return false;
+    }
+
+    if (!this.statusReporter) {
+      this.statusReporter = new StatusReporter({
+        userToken,
+        reportingEnabled: true,
+        ...options
+      });
+    } else {
+      this.statusReporter.configure({
+        userToken,
+        reportingEnabled: true,
+        ...options
+      });
+    }
+
+    console.log('[Polydev CLI] Status reporting enabled');
+    return true;
+  }
+
+  /**
+   * Disable status reporting
+   */
+  disableStatusReporting() {
+    if (this.statusReporter) {
+      this.statusReporter.configure({ reportingEnabled: false });
+      this.statusReporter.stopHeartbeat();
+      console.log('[Polydev CLI] Status reporting disabled');
+    }
+  }
+
+  /**
+   * Start automatic heartbeat for periodic status updates
+   * @param {number} intervalMs - Interval in milliseconds (default: 15 minutes)
+   */
+  startStatusHeartbeat(intervalMs) {
+    if (this.statusReporter) {
+      if (intervalMs) {
+        this.statusReporter.configure({ heartbeatIntervalMs: intervalMs });
+      }
+      this.statusReporter.startHeartbeat(this);
+      console.log('[Polydev CLI] Status heartbeat started');
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Stop automatic heartbeat
+   */
+  stopStatusHeartbeat() {
+    if (this.statusReporter) {
+      this.statusReporter.stopHeartbeat();
+      console.log('[Polydev CLI] Status heartbeat stopped');
+    }
+  }
+
+  /**
+   * Get status reporting configuration and history
+   */
+  getStatusReportingInfo() {
+    if (!this.statusReporter) {
+      return {
+        available: false,
+        reason: 'StatusReporter not initialized'
+      };
+    }
+
+    return {
+      available: true,
+      config: this.statusReporter.getConfig(),
+      history: this.statusReporter.getHistory()
+    };
+  }
+
+  /**
+   * Manually trigger a status report
+   * @returns {Promise<object>} - Report results
+   */
+  async reportStatusNow() {
+    if (!this.statusReporter || !this.statusReporter.isConfigured()) {
+      return {
+        success: false,
+        reason: 'Status reporting not configured'
+      };
+    }
+
+    const statuses = await this.forceCliDetection();
+    // forceCliDetection already reports, but we return the result
+    return {
+      success: true,
+      statuses,
+      reported: true
+    };
+  }
 }
 
 module.exports = { CLIManager, default: CLIManager };