@the-agenticflow/openflows 0.1.6 → 0.1.8-dev.236.2151055

package/scripts/install.js

@@ -1,22 +1,17 @@
 #!/usr/bin/env node
 /**
- * Post-install script for @the-agenticflow/openflows
- * 
- * This script:
- * 1. Downloads the correct pre-built binary for the current platform
- * 2. Installs mcp-proxy (required for GitHub MCP connectivity)
- * 3. Verifies all dependencies are ready
+ * Post-install script: downloads the correct pre-built binary for the current platform.
  */
 const https = require('https');
 const http = require('http');
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
-const { execSync, spawn } = require('child_process');
+const { execSync } = require('child_process');
 
 const REPO = 'The-AgenticFlow/AgentFlow';
 const BIN_DIR = path.join(__dirname, '..', 'bin');
-const POSTINSTALL_LOG = path.join(__dirname, '..', '.postinstall-done');
+const PKG_DIR = path.join(__dirname, '..');
 
 function detectPlatform() {
     const platform = os.platform();
@@ -98,182 +93,65 @@ function extractTarGz(tarPath, destDir) {
     });
 }
 
-/**
- * Install mcp-proxy - required for GitHub MCP connectivity
- * 
- * mcp-proxy is a Python tool from PyPI (sparfenyuk/mcp-proxy)
- * It bridges stdio to HTTP MCP servers like GitHub Copilot's MCP endpoint.
- * 
- * Strategy:
- * 1. Check if mcp-proxy is already available
- * 2. Install via uv (fast) or pipx (alternative)
- * 3. Fall back to Docker mode instructions if Python tools unavailable
- */
-async function ensureMcpProxy() {
-    console.log(`[openflows] Checking mcp-proxy installation...`);
-    
-    // Check if already installed
-    try {
-        execSync('which mcp-proxy', { stdio: 'pipe' });
-        console.log(`[openflows] ✓ mcp-proxy already installed`);
-        return true;
-    } catch {
-        // Not installed, proceed with installation
-    }
-    
-    console.log(`[openflows] Installing mcp-proxy (required for GitHub MCP)...`);
-    
-    // Try uv first (fastest)
-    try {
-        execSync('which uv', { stdio: 'pipe' });
-        console.log(`[openflows] Installing via uv...`);
-        execSync('uv tool install mcp-proxy', {
-            stdio: 'inherit',
-            timeout: 120000 
-        });
-        console.log(`[openflows] ✓ mcp-proxy installed via uv`);
-        return true;
-    } catch (err) {
-        // uv failed or not available
-    }
-    
-    // Try pipx as alternative
-    try {
-        execSync('which pipx', { stdio: 'pipe' });
-        console.log(`[openflows] Installing via pipx...`);
-        execSync('pipx install mcp-proxy', {
-            stdio: 'inherit',
-            timeout: 120000 
-        });
-        console.log(`[openflows] ✓ mcp-proxy installed via pipx`);
-        return true;
-    } catch (err) {
-        // pipx failed or not available
-    }
-    
-    // Try pip3 as last resort
-    try {
-        execSync('which pip3', { stdio: 'pipe' });
-        console.log(`[openflows] Installing via pip3...`);
-        execSync('pip3 install --user mcp-proxy', {
-            stdio: 'inherit',
-            timeout: 120000 
-        });
-        console.log(`[openflows] ✓ mcp-proxy installed via pip3`);
-        return true;
-    } catch (err) {
-        // pip3 failed or not available
-    }
-    
-    console.warn(`[openflows] ⚠ Could not install mcp-proxy automatically.`);
-    console.warn(`[openflows]   Please install manually:`);
-    console.warn(`[openflows]     uv tool install mcp-proxy`);
-    console.warn(`[openflows]   Or use Docker mode:`);
-    console.warn(`[openflows]     export GITHUB_MCP_TYPE=docker`);
-    return false;
-}
+async function fetchLatestTag(includePrerelease = false) {
+    const url = includePrerelease
+        ? `https://api.github.com/repos/${REPO}/releases?per_page=10`
+        : `https://api.github.com/repos/${REPO}/releases/latest`;
 
-/**
- * Check if essential tools are available
- */
-function checkPrerequisites() {
-    const checks = [
-        { name: 'git', cmd: 'git --version' },
-        { name: 'node', cmd: 'node --version' },
-    ];
-    
-    console.log(`[openflows] Checking prerequisites...`);
-    
-    let allPassed = true;
-    for (const check of checks) {
-        try {
-            execSync(check.cmd, { stdio: 'pipe' });
-            console.log(`[openflows] ✓ ${check.name} available`);
-        } catch {
-            console.warn(`[openflows] ✗ ${check.name} not found - please install it`);
-            allPassed = false;
-        }
-    }
-    
-    return allPassed;
+    return new Promise((resolve, reject) => {
+        https.get(url, {
+            headers: { 'User-Agent': 'openflows-npm-installer' }
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => data += chunk);
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(data);
+                    if (includePrerelease) {
+                        const pre = json.find(r => r.prerelease);
+                        resolve(pre ? pre.tag_name : null);
+                    } else {
+                        resolve(json.tag_name);
+                    }
+                } catch {
+                    reject(new Error('Failed to parse release info'));
+                }
+            });
+        }).on('error', reject);
+    });
 }
 
 async function main() {
-    // Skip postinstall if already done (e.g., during npm link)
-    if (fs.existsSync(POSTINSTALL_LOG)) {
-        const age = Date.now() - fs.statSync(POSTINSTALL_LOG).mtimeMs;
-        if (age < 60000) { // Less than 1 minute old
-            console.log(`[openflows] Postinstall already completed, skipping...`);
-            return;
-        }
-    }
-
     const platform = detectPlatform();
-    console.log(``);
-    console.log(`╔══════════════════════════════════════════════╗`);
-    console.log(`║     OpenFlows Installation                    ║`);
-    console.log(`║     Autonomous AI Development Team            ║`);
-    console.log(`╚══════════════════════════════════════════════╝`);
-    console.log(``);
-    console.log(`[openflows] Platform: ${platform}`);
+    const channel = process.env.AGENTFLOW_CHANNEL || (process.env.npm_package_version?.includes('-dev.') ? 'edge' : 'stable');
+    console.log(`[@the-agenticflow/openflows] Downloading binary for ${platform} (${channel})...`);
 
     // Ensure bin directory exists
     if (!fs.existsSync(BIN_DIR)) {
         fs.mkdirSync(BIN_DIR, { recursive: true });
     }
 
-    // Get latest release tag with better error handling
+    // Get release tag based on channel
     let tag;
     try {
-        tag = await new Promise((resolve, reject) => {
-            const req = https.get(`https://api.github.com/repos/${REPO}/releases/latest`, {
-                headers: { 
-                    'User-Agent': 'openflows-npm-installer',
-                    'Accept': 'application/vnd.github.v3+json'
-                }
-            }, (res) => {
-                if (res.statusCode !== 200) {
-                    reject(new Error(`GitHub API returned ${res.statusCode}`));
-                    return;
-                }
-                let data = '';
-                res.on('data', (chunk) => data += chunk);
-                res.on('end', () => {
-                    try {
-                        const json = JSON.parse(data);
-                        if (!json.tag_name) {
-                            reject(new Error('No tag_name in release response'));
-                        } else {
-                            resolve(json.tag_name);
-                        }
-                    } catch (parseErr) {
-                        reject(new Error(`Failed to parse release info: ${parseErr.message}`));
-                    }
-                });
-            });
-            req.on('error', reject);
-            req.setTimeout(30000, () => {
-                req.destroy();
-                reject(new Error('GitHub API request timeout'));
-            });
-        });
-    } catch (apiErr) {
-        console.error(`[openflows] GitHub API error: ${apiErr.message}`);
-        console.error('[openflows] Falling back to latest known version: v0.1.6');
-        tag = 'v0.1.6';
+        if (channel === 'edge') {
+            tag = await fetchLatestTag(true);
+            if (!tag) {
+                console.warn('[@the-agenticflow/openflows] No edge release found, falling back to latest stable');
+                tag = await fetchLatestTag(false);
+            }
+        } else {
+            tag = await fetchLatestTag(false);
+        }
+    } catch {
+        tag = await fetchLatestTag(false);
     }
 
     const archiveName = `openflows-${tag}-${platform}.tar.gz`;
     const downloadUrl = `https://github.com/${REPO}/releases/download/${tag}/${archiveName}`;
-    // Use package's temp directory instead of system /tmp to avoid permission issues
-    const tmpDir = path.join(__dirname, '..', '.tmp');
-    if (!fs.existsSync(tmpDir)) {
-        fs.mkdirSync(tmpDir, { recursive: true });
-    }
-    const tmpFile = path.join(tmpDir, archiveName);
+    const tmpFile = path.join(os.tmpdir(), archiveName);
 
     try {
-        console.log(`[openflows] Downloading binary for ${platform}...`);
         await download(downloadUrl, tmpFile);
         await extractTarGz(tmpFile, BIN_DIR);
     } catch (err) {
@@ -281,8 +159,8 @@ async function main() {
         if (platform === 'x86_64-unknown-linux-gnu') {
             const muslArchiveName = `openflows-${tag}-x86_64-unknown-linux-musl.tar.gz`;
             const muslDownloadUrl = `https://github.com/${REPO}/releases/download/${tag}/${muslArchiveName}`;
-            const muslTmpFile = path.join(tmpDir, muslArchiveName);
-            console.log(`[openflows] Trying musl fallback...`);
+            const muslTmpFile = path.join(os.tmpdir(), muslArchiveName);
+            console.log(`[@the-agenticflow/openflows] Trying musl fallback...`);
             await download(muslDownloadUrl, muslTmpFile);
             await extractTarGz(muslTmpFile, BIN_DIR);
             fs.unlinkSync(muslTmpFile);
@@ -292,7 +170,7 @@ async function main() {
     }
 
     // Rename binaries to match expected names
-    const binaries = ['agentflow', 'agentflow-setup', 'agentflow-dashboard', 'agentflow-doctor'];
+    const binaries = ['openflows', 'openflows-setup', 'openflows-dashboard', 'openflows-doctor', 'anthropic-proxy'];
     for (const bin of binaries) {
         const src = path.join(BIN_DIR, bin);
         const dst = path.join(BIN_DIR, `${bin}-bin`);
@@ -302,49 +180,21 @@ async function main() {
         }
     }
 
-    if (fs.existsSync(tmpFile)) {
-        fs.unlinkSync(tmpFile);
-    }
-    // Clean up temp directory if empty
-    try {
-        if (fs.existsSync(tmpDir) && fs.readdirSync(tmpDir).length === 0) {
-            fs.rmdirSync(tmpDir);
+    // Move orchestration config to package root so the binary can find it
+    const orchestrationSrc = path.join(BIN_DIR, 'orchestration');
+    const orchestrationDst = path.join(PKG_DIR, 'orchestration');
+    if (fs.existsSync(orchestrationSrc)) {
+        if (fs.existsSync(orchestrationDst)) {
+            fs.rmSync(orchestrationDst, { recursive: true });
         }
-    } catch (cleanupErr) {
-        // Ignore cleanup errors
+        fs.renameSync(orchestrationSrc, orchestrationDst);
+        console.log('[openflows] Installed orchestration config');
     }
 
-    console.log(`[openflows] ✓ Binaries installed`);
-
-    // Install mcp-proxy
-    await ensureMcpProxy();
-    
-    // Check prerequisites
-    checkPrerequisites();
-
-    // Mark postinstall as done
-    fs.writeFileSync(POSTINSTALL_LOG, new Date().toISOString());
-
-    console.log(``);
-    console.log(`╔══════════════════════════════════════════════╗`);
-    console.log(`║     Installation Complete!                    ║`);
-    console.log(`╚══════════════════════════════════════════════╝`);
-    console.log(``);
-    console.log(`  Available commands:`);
-    console.log(`    openflows           - Start orchestration`);
-    console.log(`    openflows-setup     - Guided setup wizard`);
-    console.log(`    openflows-dashboard - Live monitoring TUI`);
-    console.log(`    openflows-doctor    - Diagnostic checks`);
-    console.log(``);
-    console.log(`  Quick start:`);
-    console.log(`    1. openflows-setup     # Configure API keys`);
-    console.log(`    2. openflows           # Start the autonomous team`);
-    console.log(``);
-    console.log(`  Docs: https://openflows.dev`);
-    console.log(``);
+    if (fs.existsSync(tmpFile)) {
+        fs.unlinkSync(tmpFile);
+    }
+    console.log(`[openflows] Installation complete!`);
 }
 
-main().catch(err => {
-    console.error('[openflows] Installation failed:', err.message);
-    process.exit(1);
-});
+main();

package/.env.example

@@ -1,60 +0,0 @@
-# OpenFlows Configuration
-# Copy this file to .env and fill in your values
-# 
-# Quick Start Options:
-# ===================
-# 
-# Option 1: Fireworks AI (Recommended - no proxy needed)
-# ------------------------------------------------------
-# Get your key from: https://fireworks.ai
-FIREWORKS_API_KEY=your-fireworks-api-key
-
-# Option 2: Anthropic Direct
-# --------------------------
-# Get your key from: https://console.anthropic.com
-# ANTHROPIC_API_KEY=your-anthropic-api-key
-
-# Option 3: Custom Gateway (requires built-in proxy)
-# --------------------------------------------------
-# The proxy will auto-start when you use this option
-# GATEWAY_URL=https://your-gateway.com/v1
-# GATEWAY_API_KEY=your-gateway-api-key
-
-# ===================
-# Required Settings
-# ===================
-
-# GitHub Personal Access Token (required)
-# Get from: https://github.com/settings/tokens
-# Needs: repo, read:user, read:org
-GITHUB_PERSONAL_ACCESS_TOKEN=your-github-pat
-
-# Target repository (owner/repo format)
-GITHUB_REPOSITORY=owner/repo-name
-
-# ===================
-# Optional Settings
-# ===================
-
-# Logging level (trace, debug, info, warn, error)
-RUST_LOG=info
-
-# Proxy port (if using built-in proxy)
-# PROXY_PORT=8765
-
-# GitHub MCP type: "hosted" (default) or "docker"
-# GITHUB_MCP_TYPE=hosted
-
-# ===================
-# Advanced
-# ===================
-
-# Custom model backend (overrides registry)
-# MODEL_BACKEND=accounts/fireworks/models/glm-5
-
-# Model provider mapping (for proxy mode)
-# Format: prefix=provider,prefix=provider
-# MODEL_PROVIDER_MAP=glm=openai,gpt=openai,claude=anthropic
-
-# Fallback order for direct mode
-# LLM_FALLBACK=anthropic,gemini,openai

package/README.md

@@ -1,217 +0,0 @@
-# @the-agenticflow/openflows
-
-**Autonomous AI Development Team** — Install and run with zero configuration knowledge required.
-
-## Quick Start
-
-```bash
-# 1. Install globally
-npm install -g @the-agenticflow/openflows
-
-# 2. Run setup wizard (configures API keys)
-openflows-setup
-
-# 3. Start the autonomous team
-openflows
-```
-
-That's it! The package handles everything automatically.
-
-## How It Works
-
-### Zero-Configuration Philosophy
-
-You don't need to know about proxies, MCP servers, or backend routing. The package:
-
-1. **Installs all dependencies** - Including `mcp-proxy` for GitHub connectivity
-2. **Auto-detects your setup** - Fireworks key? Direct mode. Gateway? Proxy starts automatically
-3. **Manages the proxy lifecycle** - Starts/stops the built-in proxy as needed
-4. **Provides helpful errors** - Clear messages when something needs attention
-
-### Configuration Modes
-
-| Mode | What You Need | Proxy Required? |
-|------|---------------|-----------------|
-| **Fireworks Direct** | `FIREWORKS_API_KEY` | No |
-| **Anthropic Direct** | `ANTHROPIC_API_KEY` | No |
-| **Custom Gateway** | `GATEWAY_URL` + `GATEWAY_API_KEY` | Auto-started |
-
-### Commands
-
-```bash
-openflows              # Start orchestration
-openflows-setup        # Interactive setup wizard (TUI)
-openflows-dashboard    # Real-time monitoring (TUI)
-openflows-doctor       # System diagnostics
-openflows --help       # Show help
-openflows --version    # Show version
-```
-
-## What Gets Installed
-
-The post-install script downloads platform-specific binaries from GitHub Releases:
-
-| Binary | Purpose |
-|--------|---------|
-| `agentflow` | Main orchestration engine |
-| `agentflow-setup` | Interactive TUI setup wizard |
-| `agentflow-dashboard` | Real-time monitoring TUI |
-| `agentflow-doctor` | System diagnostics tool |
-| `anthropic-proxy` | Built-in Anthropic-to-OpenAI proxy |
-
-Additionally:
-- **mcp-proxy** is installed via npm for GitHub MCP connectivity
-- **.env.example** is included for reference
-
-## Environment Configuration
-
-Create a `.env` file in your project directory:
-
-```bash
-# Required
-GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxx
-GITHUB_REPOSITORY=owner/repo-name
-
-# Choose one API provider
-FIREWORKS_API_KEY=fw_xxxxx        # Recommended - direct mode
-# ANTHROPIC_API_KEY=sk-ant-xxxx   # Direct mode
-# GATEWAY_URL=...                 # Proxy auto-starts
-# GATEWAY_API_KEY=...             # For custom gateways
-```
-
-Run `openflows-setup` for a guided configuration experience.
-
-## Advanced Options
-
-### Disable Auto-Proxy
-
-```bash
-openflows --no-proxy
-```
-
-### Proxy-Only Mode (Testing)
-
-```bash
-openflows --proxy-only
-# Starts only the built-in proxy on port 8765
-```
-
-### Custom Proxy Port
-
-```bash
-PROXY_PORT=9000 openflows
-```
-
-### Docker MCP (Alternative)
-
-If you prefer Docker for GitHub MCP:
-
-```bash
-export GITHUB_MCP_TYPE=docker
-openflows
-```
-
-## Troubleshooting
-
-### `mcp-proxy` Installation Issues
-
-The post-install script attempts to install `mcp-proxy` (Python tool from PyPI) automatically. If you see errors:
-
-1. **Install manually:**
-   ```bash
-   # Recommended (fastest)
-   uv tool install mcp-proxy
-   
-   # Alternative
-   pipx install mcp-proxy
-   ```
-
-2. **Use Docker mode instead:**
-   ```bash
-   export GITHUB_MCP_TYPE=docker
-   openflows
-   ```
-
-The `mcp-proxy` tool bridges stdio to HTTP MCP servers like GitHub Copilot's MCP endpoint.
-
-### Permission Denied
-
-Ensure you're not using `sudo` for npm install:
-
-```bash
-# Configure npm to use user-writable directory
-mkdir -p ~/.npm-global
-npm config set prefix '~/.npm-global'
-echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
-source ~/.bashrc
-
-# Now install without sudo
-npm install -g @the-agenticflow/openflows
-```
-
-### Network Issues
-
-If GitHub API is unreachable:
-
-1. The installer falls back to a known version
-2. Or build from source:
-   ```bash
-   git clone https://github.com/The-AgenticFlow/AgentFlow.git
-   cd AgentFlow
-   cargo build --release
-   ```
-
-### GitHub 401 Unauthorized
-
-Ensure your `GITHUB_PERSONAL_ACCESS_TOKEN` is valid with these scopes:
-- `repo` (full repository access)
-- `read:user`
-- `read:org`
-
-## Platform Support
-
-| OS | Architecture | Status |
-|----|--------------|--------|
-| macOS | x86_64 (Intel) | ✅ |
-| macOS | aarch64 (M1/M2) | ✅ |
-| Linux | x86_64 (glibc) | ✅ |
-| Linux | x86_64 (musl) | ✅ |
-| Linux | aarch64 | ✅ |
-
-## Development
-
-### Testing Locally
-
-```bash
-cd packaging/npm
-npm pack
-npm install -g the-agenticflow-openflows-0.1.4.tgz
-openflows-setup --help
-```
-
-### Publishing
-
-1. Update version in `package.json`
-2. Update fallback version in `scripts/install.js`
-3. Test locally with `npm pack`
-4. Publish: `npm publish --access public`
-
-## Files Included
-
-```
-@the-agenticflow/openflows/
-├── package.json        # Package metadata
-├── README.md           # This file
-├── .env.example        # Configuration template
-├── bin/
-│   ├── openflows.js           # Main wrapper (handles proxy)
-│   ├── openflows-setup.js     # Setup wizard wrapper
-│   ├── openflows-dashboard.js # Dashboard wrapper
-│   └── openflows-doctor.js    # Doctor wrapper
-└── scripts/
-    └── install.js      # Post-install script
-```
-
-## License
-
-MIT - See [LICENSE](https://github.com/The-AgenticFlow/AgentFlow/blob/main/LICENSE)

package/bin/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Christian Yemele
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.