agentic-factory-bridge 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# agentic-factory-bridge
+
+Local bridge that connects the [Atos Agentic Factory](https://atos-agentic-factory.onrender.com) marketplace to [OpenCode CLI](https://opencode.ai) on your machine.
+
+## What it does
+
+- Detects whether OpenCode CLI is installed on your machine
+- Registers the `opencode://` custom protocol so the marketplace can launch OpenCode directly from the browser
+- Runs a lightweight local server (port 3001) that the marketplace web UI communicates with
+
+## Requirements
+
+- **Node.js 18+**
+- **Windows** (protocol registration uses PowerShell and Windows Registry)
+- **OpenCode CLI** installed globally: `npm install -g opencode`
+
+## Installation
+
+```bash
+npm install -g agentic-factory-bridge
+```
+
+## Usage
+
+### 1. Initial setup (once)
+
+Register the `opencode://` protocol and verify OpenCode CLI is installed:
+
+```bash
+agentic-factory-bridge setup
+```
+
+### 2. Start the bridge
+
+```bash
+agentic-factory-bridge start
+```
+
+The bridge starts on `http://localhost:3001`. Keep this terminal open while using the marketplace.
+
+### 3. Use the marketplace
+
+Go to [Atos Agentic Factory](https://atos-agentic-factory.onrender.com), navigate to any agent profile, and click **"Open with OpenCode"**.
+
+## Commands
+
+| Command                            | Description                                              |
+| ---------------------------------- | -------------------------------------------------------- |
+| `agentic-factory-bridge start`     | Start the local bridge server                            |
+| `agentic-factory-bridge setup`     | Register the opencode:// protocol + install OpenCode CLI |
+| `agentic-factory-bridge uninstall` | Remove the opencode:// protocol from Windows Registry    |
+| `agentic-factory-bridge status`    | Check bridge, OpenCode CLI, and protocol status          |
+| `agentic-factory-bridge --version` | Show version                                             |
+| `agentic-factory-bridge --help`    | Show help                                                |
+
+## How it works
+
+```
+Browser (marketplace)  -->  localhost:3001 (bridge)  -->  OpenCode CLI
+                                                     -->  Windows Registry (protocol)
+```
+
+1. The marketplace web UI calls `http://localhost:3001` to detect if the bridge is running
+2. The bridge checks if OpenCode CLI is installed and reports status back
+3. When you click "Open with OpenCode", the browser navigates to `opencode://run?agent=...`
+4. Windows routes the `opencode://` protocol to the handler, which launches OpenCode CLI
+
+## Uninstall
+
+```bash
+agentic-factory-bridge uninstall   # Remove protocol registration
+npm uninstall -g agentic-factory-bridge
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+
+/**
+ * Agentic Factory Bridge — CLI entry point.
+ *
+ * Usage:
+ *   agentic-factory-bridge start      Start the bridge server (port 3001)
+ *   agentic-factory-bridge setup      Install OpenCode CLI + register opencode:// protocol
+ *   agentic-factory-bridge uninstall  Remove the opencode:// protocol registration
+ *   agentic-factory-bridge status     Check bridge health and OpenCode CLI status
+ *   agentic-factory-bridge --help     Show help
+ *   agentic-factory-bridge --version  Show version
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const http = require('http');
+
+const PACKAGE_DIR = path.join(__dirname, '..');
+const VERSION = require(path.join(PACKAGE_DIR, 'package.json')).version;
+
+const command = process.argv[2];
+
+// ---------------------------------------------------------------------------
+// Help
+// ---------------------------------------------------------------------------
+function showHelp() {
+  console.log('');
+  console.log('  Agentic Factory Bridge v' + VERSION);
+  console.log('  Local bridge for Atos Agentic Factory marketplace');
+  console.log('');
+  console.log('  Usage:');
+  console.log('    agentic-factory-bridge <command>');
+  console.log('');
+  console.log('  Commands:');
+  console.log('    start       Start the bridge server on port 3001');
+  console.log('    setup       Install OpenCode CLI + register opencode:// protocol (Windows)');
+  console.log('    uninstall   Remove the opencode:// protocol registration (Windows)');
+  console.log('    status      Check if the bridge is running and OpenCode is installed');
+  console.log('');
+  console.log('  Options:');
+  console.log('    --help      Show this help message');
+  console.log('    --version   Show version number');
+  console.log('');
+  console.log('  Environment variables:');
+  console.log('    BRIDGE_PORT          Port to listen on (default: 3001)');
+  console.log('    BRIDGE_SECRET        Shared secret for HMAC auth (default: auto-generated)');
+  console.log('    BRIDGE_CORS_ORIGIN   Allowed CORS origins, comma-separated');
+  console.log('    MARKETPLACE_API_URL  Backend API URL (default: http://localhost:3000/api)');
+  console.log('    OPENCODE_PATH        Path to opencode binary (default: "opencode")');
+  console.log('');
+  console.log('  Quick start:');
+  console.log('    npm install -g agentic-factory-bridge');
+  console.log('    agentic-factory-bridge setup');
+  console.log('    agentic-factory-bridge start');
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Start bridge server
+// ---------------------------------------------------------------------------
+function startBridge() {
+  const bridgePath = path.join(PACKAGE_DIR, 'bridge.js');
+  if (!fs.existsSync(bridgePath)) {
+    console.error('  ERROR: bridge.js not found at ' + bridgePath);
+    process.exit(1);
+  }
+  require(bridgePath);
+}
+
+// ---------------------------------------------------------------------------
+// Setup: install OpenCode CLI + register protocol
+// ---------------------------------------------------------------------------
+async function setup() {
+  console.log('');
+  console.log('  ============================================');
+  console.log('   Agentic Factory Bridge — Setup');
+  console.log('  ============================================');
+  console.log('');
+
+  // Step 1: Check if OpenCode CLI is installed
+  console.log('  [1/3] Checking OpenCode CLI...');
+  const hasOpencode = await checkCommand('opencode');
+
+  if (hasOpencode) {
+    console.log('  [OK] OpenCode CLI is already installed.');
+  } else {
+    console.log('  [..] Installing OpenCode CLI (npm install -g opencode)...');
+    try {
+      await runCommand('npm', ['install', '-g', 'opencode'], 120000);
+      console.log('  [OK] OpenCode CLI installed successfully.');
+    } catch (err) {
+      console.error('  [FAIL] Could not install OpenCode CLI: ' + err.message);
+      console.error('  Try running manually: npm install -g opencode');
+    }
+  }
+
+  // Step 2: Register protocol (Windows only)
+  console.log('');
+  console.log('  [2/3] Registering opencode:// protocol...');
+
+  if (process.platform !== 'win32') {
+    console.log('  [SKIP] Protocol registration is only supported on Windows.');
+  } else {
+    const scriptPath = path.join(PACKAGE_DIR, 'install-protocol.ps1');
+    if (!fs.existsSync(scriptPath)) {
+      console.error('  [FAIL] install-protocol.ps1 not found at ' + scriptPath);
+    } else {
+      try {
+        await runCommand(
+          'powershell',
+          ['-ExecutionPolicy', 'Bypass', '-NonInteractive', '-File', scriptPath],
+          30000,
+        );
+        console.log('  [OK] Protocol opencode:// registered.');
+      } catch (err) {
+        console.error('  [FAIL] Protocol registration failed: ' + err.message);
+      }
+    }
+  }
+
+  // Step 3: Summary
+  console.log('');
+  console.log('  [3/3] Setup complete!');
+  console.log('');
+  console.log('  Next steps:');
+  console.log('    1. Run: agentic-factory-bridge start');
+  console.log('    2. Open https://atos-agentic-factory.onrender.com');
+  console.log('    3. Click "Refresh detection" on the OpenCode page');
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Uninstall protocol
+// ---------------------------------------------------------------------------
+async function uninstall() {
+  if (process.platform !== 'win32') {
+    console.log('  Protocol uninstall is only supported on Windows.');
+    return;
+  }
+
+  const scriptPath = path.join(PACKAGE_DIR, 'uninstall-protocol.ps1');
+  if (!fs.existsSync(scriptPath)) {
+    console.error('  uninstall-protocol.ps1 not found at ' + scriptPath);
+    process.exit(1);
+  }
+
+  try {
+    await runCommand(
+      'powershell',
+      ['-ExecutionPolicy', 'Bypass', '-NonInteractive', '-File', scriptPath],
+      30000,
+    );
+  } catch (err) {
+    console.error('  Uninstall failed: ' + err.message);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Status check
+// ---------------------------------------------------------------------------
+async function status() {
+  console.log('');
+  console.log('  Agentic Factory Bridge — Status');
+  console.log('  --------------------------------');
+
+  // Check bridge
+  const port = process.env.BRIDGE_PORT || '3001';
+  try {
+    const health = await httpGet('http://127.0.0.1:' + port + '/health');
+    const data = JSON.parse(health);
+    console.log('  Bridge:    RUNNING (v' + data.version + ', uptime ' + data.uptime + 's)');
+  } catch {
+    console.log('  Bridge:    NOT RUNNING (port ' + port + ')');
+  }
+
+  // Check opencode CLI
+  const hasOpencode = await checkCommand('opencode');
+  if (hasOpencode) {
+    console.log('  OpenCode:  INSTALLED');
+  } else {
+    console.log('  OpenCode:  NOT FOUND — run: npm install -g opencode');
+  }
+
+  // Check protocol (Windows)
+  if (process.platform === 'win32') {
+    try {
+      await runCommand('reg', ['query', 'HKCU\\Software\\Classes\\opencode', '/ve'], 5000);
+      console.log('  Protocol:  REGISTERED (opencode://)');
+    } catch {
+      console.log('  Protocol:  NOT REGISTERED — run: agentic-factory-bridge setup');
+    }
+  }
+
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function checkCommand(cmd) {
+  return new Promise((resolve) => {
+    const check = process.platform === 'win32' ? 'where' : 'which';
+    const proc = spawn(check, [cmd], { stdio: ['pipe', 'pipe', 'pipe'], shell: false });
+    proc.on('close', (code) => resolve(code === 0));
+    proc.on('error', () => resolve(false));
+  });
+}
+
+function runCommand(cmd, args, timeout) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn(cmd, args, {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout,
+      shell: false,
+    });
+    let stdout = '';
+    let stderr = '';
+    proc.stdout.on('data', (d) => {
+      stdout += d.toString();
+    });
+    proc.stderr.on('data', (d) => {
+      stderr += d.toString();
+    });
+    proc.on('close', (code) => {
+      if (code === 0) resolve(stdout);
+      else reject(new Error(stderr || stdout || 'exit code ' + code));
+    });
+    proc.on('error', (err) => reject(err));
+  });
+}
+
+function httpGet(url) {
+  return new Promise((resolve, reject) => {
+    http
+      .get(url, { timeout: 3000 }, (res) => {
+        let data = '';
+        res.on('data', (c) => (data += c));
+        res.on('end', () => resolve(data));
+      })
+      .on('error', reject);
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+switch (command) {
+  case 'start':
+    startBridge();
+    break;
+  case 'setup':
+    setup();
+    break;
+  case 'uninstall':
+    uninstall();
+    break;
+  case 'status':
+    status();
+    break;
+  case '--version':
+  case '-v':
+    console.log(VERSION);
+    break;
+  case '--help':
+  case '-h':
+  case undefined:
+    showHelp();
+    break;
+  default:
+    console.error('  Unknown command: ' + command);
+    console.error('  Run "agentic-factory-bridge --help" for usage.');
+    process.exit(1);
+}